Skip to content

Commit 76233e7

Browse files
docs: add agent dispatch rules and handoff policy to AGENTS.md (#3414)
5-tier dispatch priority system and always-spawn-never-redirect handoff policy. Based on competitive analysis from gstack.
1 parent d57ba56 commit 76233e7

1 file changed

Lines changed: 27 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,33 @@ If the gate fails:
6565
2. Keep CI required checks green before merge.
6666
3. Prefer small, auditable PRs with clear test evidence.
6767

68+
## Agent Dispatch Rules
69+
70+
These rules govern how the orchestrating team routes work to agents.
71+
72+
### 5-Tier Dispatch
73+
74+
Work is routed through a structured priority system. When assigning tasks, match the tier:
75+
76+
| Tier | Type | Example | Route To |
77+
|------|------|---------|----------|
78+
| 1 | P1 hotfix | Security regression, data loss | Best available backend agent immediately |
79+
| 2 | Sprint-assigned bug | Bug from dogfooding, labeled `ready` | Assigned per sprint plan |
80+
| 3 | Feature implementation | Roadmap item, has issue + epic | Assigned per sprint plan |
81+
| 4 | Docs / polish | Documentation, competitive intel | Scribe or designated docs agent |
82+
| 5 | Spike / exploration | Research, prototyping | Unassigned, tracked in backlog |
83+
84+
Never skip tiers — a P1 blocks all lower-tier work for the assigned agent.
85+
86+
### Always Spawn, Never Redirect
87+
88+
When a user asks Agent A to do work that belongs to Agent B:
89+
90+
- **DO:** Spawn (create a session/send a message) to Agent B with the full context
91+
- **DO NOT:** Tell the user to go ask Agent B instead
92+
93+
The user asked *you*. Own the handoff. Include the request, context, and any decisions already made so Agent B can start immediately without re-asking.
94+
6895
## Anti-Drift and Anti-Trash Rules
6996

7097
These are common AI-agent failure modes and must be actively prevented.

0 commit comments

Comments
 (0)