Sub-agents
DOCS / WORK WITH VIBES

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.

EXAMPLE REQUEST

“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

ToolPurpose
create_agentDefine a specialist for later work.
spawn_agentDefine and run a one-off specialist.
list_agentsInspect 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.

Improve this page Grounded in the Vibes source.

Find a guide, command, or concept.