hierarchy

name	hierarchy
description	Display PAI agent hierarchy and command structure

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.