Sub-agents
Focused workers that turn one large task into smaller, concrete pieces.
Delegate a bounded piece of work
The main agent can delegate through task, delegate, and parallel_delegate. Each worker has a specific system prompt and tool allowlist, and reports a result to the parent.
“Review the authentication flow. Delegate an independent review of the tests, then combine the findings.”
Sub-agents use a lean plugin set focused on files, shell, skills, artifacts, and planning. They do not duplicate the main agent’s full memory and summarization setup.
Create specialists at runtime
| Tool | Purpose |
|---|---|
create_agent | Define a specialist for later work. |
spawn_agent | Define and run a one-off specialist. |
list_agents | Inspect the available roster. |
The registry is mutable: the main agent is not limited to a baked-in list. Workers can inherit custom tools configured for the parent.
Results and completion
A worker can complete naturally with a final answer. It can optionally call report_result for a structured summary and file list. Results may be saved under subagent_results/.
Keep delegated tasks concrete: a question to answer, files to review, or a result to produce. Independent work is easier to combine than overlapping edits.