Design Tips
Best practices for designing effective multi-agent workflows.
Core Principles
Single Responsibility
Each agent should do one thing well:
- Writer writes code
- Reviewer reviews code
- Tester runs tests
Start Simple
- Begin with 2-3 agents
- Add complexity gradually
- Test as you go
Common Patterns
Sequential
[A] ──→ [B] ──→ [C]
Each step depends on the previous.
Feedback Loop
[Writer] ←──→ [Reviewer]
Reviewer can send work back for revision.
Parallel
┌──→ [A] ──┐
[S] ├──→ [B] ──┼──→ [Result]
└──→ [C] ──┘
Multiple independent analyses at once.
Quick Tips
- Use Haiku for simple tasks (faster, cheaper)
- Set reasonable retry limits (2-3)
- Keep agent instructions clear and focused