Agent Team Orchestration

Production playbook for running multi-agent teams with clear roles, structured task flow, and quality gates.

Roles

| Role | Purpose | Model guidance |

|---|---|---|

| Orchestrator | Route work, track state, make priority calls | High-reasoning model |

| Builder | Produce artifacts - code, docs, configs | Cost-effective models |

| Reviewer | Verify quality, push back on gaps | High-reasoning model |

| Ops | Cron jobs, standups, health checks | Cheapest reliable model |

Task States

Inbox -> Assigned -> In Progress -> Review -> Done | Failed

Handoffs

When work passes between agents:

1. What was done
2. Where artifacts are (exact file paths)
3. How to verify (test commands or acceptance criteria)
4. Known issues
5. What's next

Common Pitfalls

• Spawning without clear artifact output paths
• No review step = quality drift
• Agents not commenting on task progress
• Not verifying agent capabilities before assigning
• Orchestrator doing execution work