hierarchy
Display PAI agent hierarchy and command structure
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Agent Hierarchy
Purpose: Display the PAI agent organizational structure Trigger:
/hierarchyUpdated: 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.
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!