Agents in Ptah
import { Card, CardGrid } from ‘@astrojs/starlight/components’;
Agents in Ptah
Section titled “Agents in Ptah”Agents are specialized AI workers that Ptah coordinates on your behalf. Each agent has a focused role — writing backend code, reviewing UI, researching a library, managing DevOps pipelines — and a system prompt tuned for that role. Instead of asking one generalist model to do everything, Ptah lets the right expert handle the right slice of work.
Why agents?
Section titled “Why agents?”A single, unrestricted chat session tends to drift: it forgets the architecture it proposed, mixes up frontend and backend conventions, and loses track of review feedback. Ptah’s agents solve that by giving each concern:
- A dedicated system prompt with domain expertise and guardrails
- A narrow toolset (file access, CLI spawning, browser automation, etc.)
- A clear handoff protocol to other agents in the hierarchy
The result: higher-quality output, fewer hallucinations, and a reviewable trail of who did what.
The 13 built-in agents
Section titled “The 13 built-in agents”Ptah ships with 13 built-in agents covering the full software delivery lifecycle — from planning and architecture through implementation, review, and release. They live in every new workspace and are always available from the agent picker.
See the built-in agent catalog for the full table of roles, triggers, and typical use cases.
How agents fit together
Section titled “How agents fit together”Ptah uses a three-tier orchestration model:
- Orchestrator — the top-level agent that plans, decomposes, and delegates.
- Senior leads — specialists (architect, backend-dev, reviewer, etc.) spawned as sub-agents.
- CLI helpers — external CLI agents (Copilot CLI, Gemini CLI, Codex CLI, ptah-cli) spawned in parallel for bulk or exploratory work.
Read more in Agent orchestration.
Where agents are stored
Section titled “Where agents are stored”Built-in agents are bundled with Ptah. Custom and modified agents are stored per workspace under:
<workspace-root>/.claude/agents/Each agent is a Markdown file with YAML frontmatter describing its name, description, tools, and system prompt. You can edit these directly or use the in-app editor — see Custom agents.