Multi-Agent Orchestration
Overview
Split complex work across roles. You remain the orchestrator: define tasks, merge results, and own the final answer.
Roles (pick what you need)
| Role |
Responsibility |
Typical tools |
| Architect |
design, interfaces, risks |
read_file, grep |
| Implementer |
code / config changes |
edit / write_file, exec |
| Reviewer |
bugs, regressions, style |
read_file, grep, exec tests |
| Analyst |
data, metrics, SQL |
exec, web tools |
| Researcher |
docs, competitors, APIs |
web_search, web_fetch |
Workflow
- Decompose with
task-planner thinking: which tracks are independent?
- Spawn only independent work via
spawn(task=..., label=...).
- Put the full brief in
task - subagents do not see your full history.
- Include success criteria and “out of scope”.
- Independent tracks go out together, in one batch: they run concurrently and
each reports back on its own, so waiting for one before starting the next
buys nothing.
- Serialize conflicting edits - never spawn two writers on the same files.
- Integrate results: resolve conflicts, run verification, present one coherent outcome.
- Review gate: for user-facing or production changes, run a reviewer pass (same chat or
spawn) before claiming done.
Task brief template (put inside spawn.task)
Role: Implementer
Goal: ...
Context paths: ...
Constraints: ...
Done when: ... (copy acceptance from the mission/board step)
Validation: test|lint|verify|manual|none
Do not: ...
Ledger step id: ...
Return evidence the parent can pass to board ledger_progress / done.
Rules
- Prefer 1-3 subagents; more creates merge chaos.
- You deliver the final summary - never dump raw subagent noise.
- If a subagent fails, retry with a tighter brief or finish yourself.
- If a result never reaches you,
spawn(action="results") says how the finished
ones ended. Use it instead of assuming a subagent never ran.
- Security / prod deploys always need an explicit reviewer step.
- Parent marks board
done only after merging evidence that satisfies validation.
1---2name: multi-agent-orchestration3description: Coordinate specialized subagents (architect, implementer, reviewer, analyst, researcher) with clear roles, handoffs, and validation. Use spawn for parallel independent tracks.4metadata:5 source: https://skillmd.com/skills/navinspire-ia/multi-agent-orchestration6 navin:7 emoji: 🕸️8 category: intelligence9---1011# Multi-Agent Orchestration1213## Overview1415Split complex work across roles. You remain the orchestrator: define tasks, merge results, and own the final answer.1617## Roles (pick what you need)1819| Role | Responsibility | Typical tools |20|------|----------------|---------------|21| Architect | design, interfaces, risks | `read_file`, `grep` |22| Implementer | code / config changes | `edit` / `write_file`, `exec` |23| Reviewer | bugs, regressions, style | `read_file`, `grep`, `exec` tests |24| Analyst | data, metrics, SQL | `exec`, web tools |25| Researcher | docs, competitors, APIs | `web_search`, `web_fetch` |2627## Workflow28291. **Decompose** with `task-planner` thinking: which tracks are independent?302. **Spawn only independent work** via `spawn(task=..., label=...)`.31 - Put the full brief in `task` - subagents do not see your full history.32 - Include success criteria and “out of scope”.33 - Independent tracks go out together, in one batch: they run concurrently and34 each reports back on its own, so waiting for one before starting the next35 buys nothing.363. **Serialize conflicting edits** - never spawn two writers on the same files.374. **Integrate** results: resolve conflicts, run verification, present one coherent outcome.385. **Review gate**: for user-facing or production changes, run a reviewer pass (same chat or `spawn`) before claiming done.3940## Task brief template (put inside spawn.task)4142```text43Role: Implementer44Goal: ...45Context paths: ...46Constraints: ...47Done when: ... (copy acceptance from the mission/board step)48Validation: test|lint|verify|manual|none49Do not: ...50Ledger step id: ...51```5253Return evidence the parent can pass to `board` `ledger_progress` / `done`.5455## Rules5657- Prefer 1-3 subagents; more creates merge chaos.58- You deliver the final summary - never dump raw subagent noise.59- If a subagent fails, retry with a tighter brief or finish yourself.60- If a result never reaches you, `spawn(action="results")` says how the finished61 ones ended. Use it instead of assuming a subagent never ran.62- Security / prod deploys always need an explicit reviewer step.63- Parent marks board `done` only after merging evidence that satisfies validation.