Agent Hierarchy
Purpose: Display the PAI agent organizational structure
Trigger: /hierarchy
Updated: 2026-01-03
Full Command Structure (Left → Right)
ORCHESTRATOR ─┬─ ARCHITECT ─┬─ COORD_PLATFORM ─┬─ DBA
(99/1 Rule) │ │ ├─ BACKEND_ENGINEER
│ │ └─ API_DEVELOPER
│ │
│ ├─ COORD_ENGINE ───┬─ SCHEDULER
│ │ ├─ SWAP_MANAGER
│ │ └─ OPTIMIZATION_SPECIALIST
│ │
│ └─ COORD_QUALITY ──┬─ QA_TESTER
│ ├─ CODE_REVIEWER
│ └─ CI_LIAISON
│
├─ SYNTHESIZER ┬─ COORD_OPS ─────┬─ META_UPDATER
│ │ └─ RELEASE_MANAGER
│ │
│ ├─ COORD_RESILIENCE ┬─ RESILIENCE_ENGINEER
│ │ ├─ COMPLIANCE_AUDITOR
│ │ └─ SECURITY_AUDITOR
│ │
│ ├─ COORD_FRONTEND ──┬─ FRONTEND_ENGINEER
│ │ └─ UX_SPECIALIST
│ │
│ └─ COORD_TOOLING ───┬─ TOOLSMITH
│ ├─ TOOL_QA
│ └─ TOOL_REVIEWER
│
├─ G-STAFF ────┬─ G1_PERSONNEL
│ ├─ G2_RECON ──────── /search-party (120 probes)
│ ├─ G3_OPERATIONS
│ ├─ G4_CONTEXT_MGR ─┬─ G4_LIBRARIAN
│ │ └─ KNOWLEDGE_CURATOR
│ ├─ G5_PLANNING ───── /plan-party (10 probes)
│ ├─ G6_SIGNAL
│ ├─ IG (AUDITOR) ──── /qa-party (120 agents)
│ └─ PAO (HISTORIAN)
│
└─ SPECIAL ────┬─ FORCE_MANAGER ───── Team assembly
STAFF ├─ COORD_AAR ────────── After Action Review
├─ COORD_INTEL ──────── Full-stack forensics
├─ DEVCOM_RESEARCH ─── R&D / exotic concepts
├─ MEDCOM ────────────── Medical advisory
├─ INCIDENT_COMMANDER ─ Crisis response
└─ BURNOUT_SENTINEL ─── Workload monitoring
Coordinators (COORDs)
| Coordinator |
Domain |
Specialists |
| COORD_PLATFORM |
Infrastructure |
DBA, BACKEND_ENGINEER, API_DEVELOPER |
| COORD_QUALITY |
Testing/QA |
QA_TESTER, CODE_REVIEWER, CI_LIAISON |
| COORD_ENGINE |
Scheduling |
SCHEDULER, SWAP_MANAGER, OPTIMIZATION_SPECIALIST |
| COORD_OPS |
Operations |
META_UPDATER, RELEASE_MANAGER |
| COORD_RESILIENCE |
Compliance |
RESILIENCE_ENGINEER, COMPLIANCE_AUDITOR, SECURITY_AUDITOR |
| COORD_FRONTEND |
UI/UX |
FRONTEND_ENGINEER, UX_SPECIALIST |
| COORD_TOOLING |
Tools/Skills |
TOOLSMITH, TOOL_QA, TOOL_REVIEWER |
| COORD_INTEL |
Investigation |
Full-stack forensics |
| COORD_AAR |
After Action |
Session review (auto-trigger) |
G-Staff (Army Doctrine)
| Position |
Agent |
Role |
| G-1 |
G1_PERSONNEL |
Personnel & roster tracking |
| G-2 |
G2_RECON |
Intelligence/Reconnaissance (/search-party) |
| G-3 |
G3_OPERATIONS |
Operations & workflow coordination |
| G-4 |
G4_CONTEXT_MANAGER |
RAG/vector context (+ G4_LIBRARIAN) |
| G-5 |
G5_PLANNING |
Strategic planning (/plan-party) |
| G-6 |
G6_SIGNAL |
Signal/Data Processing |
| IG |
DELEGATION_AUDITOR |
Inspector General (session end) |
| PAO |
HISTORIAN |
Public Affairs - significant sessions |
Special Staff
| Agent |
Role |
| FORCE_MANAGER |
Team assembly, coordinator assignment |
| COORD_AAR |
After Action Review (auto-trigger at session end) |
| COORD_INTEL |
Full-stack forensics & investigation |
| DEVCOM_RESEARCH |
R&D - exotic concepts, cross-disciplinary |
| MEDCOM |
Medical Advisory - ACGME, clinical implications |
| INCIDENT_COMMANDER |
Crisis response |
| BURNOUT_SENTINEL |
Workload monitoring |
Specialists (Sample)
| Domain |
Agents |
| Scheduling |
SCHEDULER, SWAP_MANAGER, OPTIMIZATION_SPECIALIST, CAPACITY_OPTIMIZER |
| Platform |
DBA, BACKEND_ENGINEER, API_DEVELOPER, ARCHITECT |
| Quality |
QA_TESTER, CODE_REVIEWER, CI_LIAISON |
| Resilience |
RESILIENCE_ENGINEER, COMPLIANCE_AUDITOR, BURNOUT_SENTINEL |
| Knowledge |
KNOWLEDGE_CURATOR, G4_LIBRARIAN, META_UPDATER |
| Frontend |
FRONTEND_ENGINEER, UX_SPECIALIST |
The 99/1 Rule
ORCHESTRATOR delegates 99%, executes 1%
| ORCHESTRATOR Does |
ORCHESTRATOR Delegates |
| Git commits/push |
All code changes |
| PR creation |
All implementation |
| Branch management |
All testing |
| Final synthesis |
All exploration |
Routing Quick Reference
| Task Type |
Route |
| Database/API |
ARCHITECT → COORD_PLATFORM |
| Tests/CI |
ARCHITECT → COORD_QUALITY |
| Scheduling |
ARCHITECT → COORD_ENGINE |
| Docs/Releases |
SYNTHESIZER → COORD_OPS |
| Resilience |
SYNTHESIZER → COORD_RESILIENCE |
| Frontend |
SYNTHESIZER → COORD_FRONTEND |
| Recon |
G2_RECON (/search-party) |
| Planning |
G5_PLANNING (/plan-party) |
IDE Safety
Max 2 direct spawns from ORCHESTRATOR - route through coordinators to prevent IDE crash.
Run /hierarchy anytime for this reference.
1---2name: hierarchy3description: Display PAI agent hierarchy and command structure4---5
6# Agent Hierarchy
7
8> **Purpose:** Display the PAI agent organizational structure
9> **Trigger:** `/hierarchy`
10> **Updated:** 2026-01-03
11
12---
13
14## Full Command Structure (Left → Right)
15
16```
17ORCHESTRATOR ─┬─ ARCHITECT ─┬─ COORD_PLATFORM ─┬─ DBA
18(99/1 Rule) │ │ ├─ BACKEND_ENGINEER
19 │ │ └─ API_DEVELOPER
20 │ │
21 │ ├─ COORD_ENGINE ───┬─ SCHEDULER
22 │ │ ├─ SWAP_MANAGER
23 │ │ └─ OPTIMIZATION_SPECIALIST
24 │ │
25 │ └─ COORD_QUALITY ──┬─ QA_TESTER
26 │ ├─ CODE_REVIEWER
27 │ └─ CI_LIAISON
28 │
29 ├─ SYNTHESIZER ┬─ COORD_OPS ─────┬─ META_UPDATER
30 │ │ └─ RELEASE_MANAGER
31 │ │
32 │ ├─ COORD_RESILIENCE ┬─ RESILIENCE_ENGINEER
33 │ │ ├─ COMPLIANCE_AUDITOR
34 │ │ └─ SECURITY_AUDITOR
35 │ │
36 │ ├─ COORD_FRONTEND ──┬─ FRONTEND_ENGINEER
37 │ │ └─ UX_SPECIALIST
38 │ │
39 │ └─ COORD_TOOLING ───┬─ TOOLSMITH
40 │ ├─ TOOL_QA
41 │ └─ TOOL_REVIEWER
42 │
43 ├─ G-STAFF ────┬─ G1_PERSONNEL
44 │ ├─ G2_RECON ──────── /search-party (120 probes)
45 │ ├─ G3_OPERATIONS
46 │ ├─ G4_CONTEXT_MGR ─┬─ G4_LIBRARIAN
47 │ │ └─ KNOWLEDGE_CURATOR
48 │ ├─ G5_PLANNING ───── /plan-party (10 probes)
49 │ ├─ G6_SIGNAL
50 │ ├─ IG (AUDITOR) ──── /qa-party (120 agents)
51 │ └─ PAO (HISTORIAN)
52 │
53 └─ SPECIAL ────┬─ FORCE_MANAGER ───── Team assembly
54 STAFF ├─ COORD_AAR ────────── After Action Review
55 ├─ COORD_INTEL ──────── Full-stack forensics
56 ├─ DEVCOM_RESEARCH ─── R&D / exotic concepts
57 ├─ MEDCOM ────────────── Medical advisory
58 ├─ INCIDENT_COMMANDER ─ Crisis response
59 └─ BURNOUT_SENTINEL ─── Workload monitoring
60```
61
62---
63
64## Coordinators (COORDs)
65
66| Coordinator | Domain | Specialists |
67|-------------|--------|-------------|
68| **COORD_PLATFORM** | Infrastructure | DBA, BACKEND_ENGINEER, API_DEVELOPER |
69| **COORD_QUALITY** | Testing/QA | QA_TESTER, CODE_REVIEWER, CI_LIAISON |
70| **COORD_ENGINE** | Scheduling | SCHEDULER, SWAP_MANAGER, OPTIMIZATION_SPECIALIST |
71| **COORD_OPS** | Operations | META_UPDATER, RELEASE_MANAGER |
72| **COORD_RESILIENCE** | Compliance | RESILIENCE_ENGINEER, COMPLIANCE_AUDITOR, SECURITY_AUDITOR |
73| **COORD_FRONTEND** | UI/UX | FRONTEND_ENGINEER, UX_SPECIALIST |
74| **COORD_TOOLING** | Tools/Skills | TOOLSMITH, TOOL_QA, TOOL_REVIEWER |
75| **COORD_INTEL** | Investigation | Full-stack forensics |
76| **COORD_AAR** | After Action | Session review (auto-trigger) |
77
78---
79
80## G-Staff (Army Doctrine)
81
82| Position | Agent | Role |
83|----------|-------|------|
84| **G-1** | G1_PERSONNEL | Personnel & roster tracking |
85| **G-2** | G2_RECON | Intelligence/Reconnaissance (`/search-party`) |
86| **G-3** | G3_OPERATIONS | Operations & workflow coordination |
87| **G-4** | G4_CONTEXT_MANAGER | RAG/vector context (+ G4_LIBRARIAN) |
88| **G-5** | G5_PLANNING | Strategic planning (`/plan-party`) |
89| **G-6** | G6_SIGNAL | Signal/Data Processing |
90| **IG** | DELEGATION_AUDITOR | Inspector General (session end) |
91| **PAO** | HISTORIAN | Public Affairs - significant sessions |
92
93---
94
95## Special Staff
96
97| Agent | Role |
98|-------|------|
99| **FORCE_MANAGER** | Team assembly, coordinator assignment |
100| **COORD_AAR** | After Action Review (auto-trigger at session end) |
101| **COORD_INTEL** | Full-stack forensics & investigation |
102| **DEVCOM_RESEARCH** | R&D - exotic concepts, cross-disciplinary |
103| **MEDCOM** | Medical Advisory - ACGME, clinical implications |
104| **INCIDENT_COMMANDER** | Crisis response |
105| **BURNOUT_SENTINEL** | Workload monitoring |
106
107---
108
109## Specialists (Sample)
110
111| Domain | Agents |
112|--------|--------|
113| **Scheduling** | SCHEDULER, SWAP_MANAGER, OPTIMIZATION_SPECIALIST, CAPACITY_OPTIMIZER |
114| **Platform** | DBA, BACKEND_ENGINEER, API_DEVELOPER, ARCHITECT |
115| **Quality** | QA_TESTER, CODE_REVIEWER, CI_LIAISON |
116| **Resilience** | RESILIENCE_ENGINEER, COMPLIANCE_AUDITOR, BURNOUT_SENTINEL |
117| **Knowledge** | KNOWLEDGE_CURATOR, G4_LIBRARIAN, META_UPDATER |
118| **Frontend** | FRONTEND_ENGINEER, UX_SPECIALIST |
119
120---
121
122## The 99/1 Rule
123
124**ORCHESTRATOR delegates 99%, executes 1%**
125
126| ORCHESTRATOR Does | ORCHESTRATOR Delegates |
127|-------------------|------------------------|
128| Git commits/push | All code changes |
129| PR creation | All implementation |
130| Branch management | All testing |
131| Final synthesis | All exploration |
132
133---
134
135## Routing Quick Reference
136
137| Task Type | Route |
138|-----------|-------|
139| Database/API | ARCHITECT → COORD_PLATFORM |
140| Tests/CI | ARCHITECT → COORD_QUALITY |
141| Scheduling | ARCHITECT → COORD_ENGINE |
142| Docs/Releases | SYNTHESIZER → COORD_OPS |
143| Resilience | SYNTHESIZER → COORD_RESILIENCE |
144| Frontend | SYNTHESIZER → COORD_FRONTEND |
145| Recon | G2_RECON (`/search-party`) |
146| Planning | G5_PLANNING (`/plan-party`) |
147
148---
149
150## IDE Safety
151
152**Max 2 direct spawns from ORCHESTRATOR** - route through coordinators to prevent IDE crash.
153
154---
155
156*Run `/hierarchy` anytime for this reference.*
majiayu000