Agent Coordination
Master guide to orchestrating the multi-agent system. Includes category routing, model selection, and sprint management for rapid, TDD-driven feature development.
Agent Hierarchy
See AGENTS.md for the full agent table.
Category Routing
Route tasks to optimized agents based on category instead of specifying agents manually:
| Category | Agent | Use For | |----------|-------|---------| | Deep | Athena, Hephaestus | Complex planning, AI pipelines | | Quick | Talos, Apollo | Fast fixes, codebase search | | Visual | Aphrodite, Argus | UI components, visual analysis | | Ultrabrain | Zeus, Chiron | Multi-agent orchestration, model routing |
Sprint Workflow
1. User describes feature
2. @athena creates PLAN with phases and agents
3. User approves PLAN (GATE 1)
4. Zeus dispatches agents to phases (parallel when possible)
5. Each agent: TDD cycle β writes IMPL artifact
6. @themis reviews all phases (GATE 2)
7. User reviews Themis findings
8. If approved β user commits (GATE 3)
9. @mnemosyne updates memory bank
Parallel Execution Declaration
π PARALLEL EXECUTION β Phase 2
Running simultaneously:
- @hermes β backend tests β .tmp/IMPL-phase2-hermes.md
- @aphrodite β frontend β .tmp/IMPL-phase2-aphrodite.md
- @demeter β migrations β .tmp/IMPL-phase2-demeter.md
Themis reviews all three after completion.
Artifact Protocol
All phase outputs go to docs/memory-bank/.tmp/. See instructions/artifact-protocol.instructions.md for the complete protocol (who generates what, templates, lifecycle).
Safety Gates
| Gate | When | Why | |------|------|-----| | GATE 1 | After PLAN | User confirms scope | | GATE 2 | After Themis review | User sees changes | | GATE 3 | Before git commit | User controls history |
Model Selection (via Chiron)
- Deep tasks β High-quality models (Claude, GPT-4)
- Quick tasks β Fast/cheap models (Haiku, 4o-mini)
- Visual tasks β Multimodal models (GPT-4V, Claude Vision)
- Cost optimization β Route to cheapest model that meets quality bar
Anti-Patterns
- β Zeus doing implementation work (orchestrates, doesn't code)
- β Skipping TDD cycle (RED β GREEN β REFACTOR)
- β Auto-committing without user approval
- β Parallel phases with dependencies (order matters)
- β Ignoring Themis CRITICAL findings