C4 Architecture Documentation

Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure, create C4 diagrams, or generate context/container/component/deployment diagrams. Triggers include "architecture diagram", "C4 diagram", "system context", "container diagram", "component diagram", "deployment diagram", "document architecture", "visualize architecture".

Workflow

1. Understand scope — Determine which C4 level(s) are needed based on audience
2. Analyze codebase — Explore the system to identify components, containers, and relationships
3. Generate diagrams — Create Mermaid C4 diagrams at appropriate abstraction levels
4. Document — Write diagrams to markdown files with explanatory context

C4 Diagram Levels

Select the appropriate level based on the documentation need: