Agent skill

hierarchy

Display PAI agent hierarchy and command structure

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/hierarchy

SKILL.md

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.

Didn't find tool you were looking for?

Be as detailed as possible for better results