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.