agent-hierarchy-diagram

Generate visual hierarchy diagrams of agent system showing levels and delegation. Use for documentation or onboarding.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

The Agent Hierarchy Diagram skill is a specialized developer tool designed to visualize the structural complexity of multi-agent systems. By generating ASCII trees, Mermaid diagrams, and GraphML files, it transforms abstract agent delegation logic into clear, readable visual hierarchies, essential for documenting orchestration flows and system architecture.

Use Cases

  • Technical Documentation: Automatically generate and embed Mermaid diagrams into GitHub READMEs or agent-specific documentation to show system structure.
  • Team Onboarding: Provide new developers with a clear visual map of agent relationships, levels (L0-L5), and delegation chains to accelerate project understanding.
  • Architecture Design & Review: Use visual diagrams to communicate complex multi-agent orchestration strategies to stakeholders and during architectural planning sessions.
  • System Debugging: Identify structural inefficiencies or incorrect delegation paths by visualizing the hierarchy of specialized agents and their supervisors.
nameagent-hierarchy-diagram
description"Generate visual hierarchy diagrams of agent system showing levels and delegation. Use for documentation or onboarding."
mcp_fallbacknone
categoryagent

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