Agent Hierarchy Diagram

Generate visual diagrams showing agent system structure and relationships.

When to Use

• Documenting agent system for team
• Understanding delegation structure
• Onboarding new contributors
• Visualizing agent relationships for presentations

Quick Reference

bash
1# Generate ASCII tree diagram
2./scripts/generate_hierarchy_diagram.sh
3
4# Generate Mermaid diagram
5./scripts/generate_mermaid_diagram.sh > hierarchy.mmd
6
7# Save to documentation
8./scripts/generate_hierarchy_diagram.sh > agents/hierarchy-visual.txt

ASCII Tree Format

text
1Chief Architect (L0)
2├── Foundation Orchestrator (L1)
3│   ├── Repository Design (L2)
4│   │   ├── Directory Specialist (L3)
5│   │   │   └── Junior Engineer (L5)
6│   │   └── Config Specialist (L3)
7│   └── Config Design (L2)
8├── Shared Library Orchestrator (L1)
9│   └── Tensor Module Design (L2)
10│       └── Tensor Specialist (L3)
11└── Tooling Orchestrator (L1)

Mermaid Format

mermaid
1graph TD
2    A[Chief Architect L0] --> B[Foundation Orchestrator L1]
3    B --> C[Repository Design L2]
4    C --> D[Directory Specialist L3]
5    D --> E[Junior Engineer L5]

Use Cases

• Add to /agents/hierarchy.md for reference
• Include in onboarding documentation
• Create presentation materials
• Understand delegation chains
• Communicate structure to stakeholders

Output Formats

ASCII: Human-readable in terminals, copy-pasteable in docs

Mermaid: Renders in GitHub markdown, editable in Mermaid editor

GraphML: Import into diagram tools (yEd, Graphviz)

References

• /agents/hierarchy.md - Existing hierarchy documentation
• agent-test-delegation - Validate diagram accuracy
• .claude/agents/ - Agent configuration source