agent-hierarchy-diagram

name	agent-hierarchy-diagram
description	Generate visual hierarchy diagrams of agent system showing levels and delegation. Use for documentation or onboarding.
mcp_fallback	none
category	agent
user-invocable	false

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

# Generate ASCII tree diagram
./scripts/generate_hierarchy_diagram.sh

# Generate Mermaid diagram
./scripts/generate_mermaid_diagram.sh > hierarchy.mmd

# Save to documentation
./scripts/generate_hierarchy_diagram.sh > agents/hierarchy-visual.txt

ASCII Tree Format

Chief Architect (L0)
├── Foundation Orchestrator (L1)
│   ├── Repository Design (L2)
│   │   ├── Directory Specialist (L3)
│   │   │   └── Junior Engineer (L5)
│   │   └── Config Specialist (L3)
│   └── Config Design (L2)
├── Shared Library Orchestrator (L1)
│   └── Tensor Module Design (L2)
│       └── Tensor Specialist (L3)
└── Tooling Orchestrator (L1)

Mermaid Format

graph TD
    A[Chief Architect L0] --> B[Foundation Orchestrator L1]
    B --> C[Repository Design L2]
    C --> D[Directory Specialist L3]
    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