A reusable architecture for coordinating multiple specialized AI agents within a single system. Extracted from oh-my-hermes.
Human (strategic decisions)
│
▼
Orchestrator Agent (routes, monitors, reports)
│
├── Specialist Agent 1 (specific domain)
├── Specialist Agent 2 (specific domain)
├── Specialist Agent 3 (specific domain)
└── Specialist Agent N
│
▼
Coordination Layer (kanban / shared state)
Each agent does ONE thing well. Don't make one agent do everything. The PM doesn't code. The Security agent doesn't deploy. Clear boundaries = better output.
Agents don't communicate directly. They read/write to a shared coordination layer (kanban, task board, shared memory). This decouples agents — any agent can be swapped without breaking others.
The orchestrator (CTO in Oh My Hermes) doesn't DO the work. It: - Monitors the coordination layer - Routes tasks to the right specialist - Reports status to the human - Handles escalation
The system runs autonomously. Human is only consulted for: - Strategic decisions (direction, priority) - Approval gates (ship/no-ship) - Exception handling (when automated flow breaks)
Each specialist agent loads only the skills relevant to their role. This keeps context lean and output focused.
| Agent | Role | Kanban Ownership |
|---|---|---|
| Strategist | Audience research, campaign planning, messaging | Brief |
| Copywriter | Headlines, body copy, CTAs, scripts | Creative |
| Designer | Visual direction, asset production, brand consistency | Production |
| Deployer | Social media, EDM, print, platform management | Deploy |
| Analyst | Performance tracking, A/B testing, reporting | Measure |
Brief → Strategy → Creative → Production → Review → Deploy → Measure
| Dimension | Single Agent | Agent Team |
|---|---|---|
| Context window | Everything loaded | Only relevant skills |
| Output quality | Generalist | Specialist |
| Coordination | Implicit (same context) | Explicit (shared state) |
| Failure isolation | One failure = all fails | One agent fails, others continue |
| Human oversight | Every decision | Only strategic decisions |