Agents Overview
MeowKit includes 15 specialist agents. Each owns a specific concern — no two agents modify the same files.
| Agent | Role | Phase | Auto-activates |
|---|---|---|---|
| orchestrator | Task routing + complexity classification | 0 | Every task |
| planner | Two-lens planning + Gate 1 | 1 | Standard/complex tasks |
| brainstormer | Solution evaluation + trade-offs | 1 | Explicit or complex |
| researcher | Tech research + library evaluation | 0,1,4 | Explicit |
| architect | ADRs + system design | 1 | Complex tasks |
| tester | TDD red/green/refactor | 2 | After planning |
| security | Security audit + BLOCK verdicts | 2,4 | Auth/payment changes |
| developer | Implementation (TDD) | 3 | After tester |
| reviewer | 5-dimension review + Gate 2 | 4 | After developer |
| shipper | Ship pipeline + PR creation | 5 | After Gate 2 |
| documenter | Docs sync + changelog | 6 | After ship |
| analyst | Cost tracking + patterns | 0,6 | Session start/end |
| journal-writer | Failure documentation | 6 | On failure |
| git-manager | Stage, commit, push (conventional commits) | 5, any | On "commit"/"push" |
Context engineering
Every agent includes:
- Required Context — what to load before invoking
- Failure Behavior — what to do when blocked
- Ambiguity Resolution — how to handle unclear inputs (high-priority agents)