c4-architecture

1# C4 Architecture Documentation
2 
3Generate software architecture documentation using C4 model diagrams in Mermaid syntax.
4 
5## Workflow
6 
71. **Understand scope** - Determine which C4 level(s) are needed based on audience
82. **Analyze codebase** - Explore the system to identify components, containers, and relationships
93. **Generate diagrams** - Create Mermaid C4 diagrams at appropriate abstraction levels
104. **Document** - Write diagrams to markdown files with explanatory context
11 
12## C4 Diagram Levels
13 
14Select the appropriate level based on the documentation need:
15 
16| Level | Diagram Type | Audience | Shows | When to Create |
17|-------|-------------|----------|-------|----------------|
18| 1 | **C4Context** | Everyone | System + external actors | Always (required) |
19| 2 | **C4Container** | Technical | Apps, databases, services | Always (required) |
20| 3 | **C4Component** | Developers | Internal components | Only if adds value |
21| 4 | **C4Deployment** | DevOps | Infrastructure nodes | For production systems |
22| - | **C4Dynamic** | Technical | Request flows (numbered) | For complex workflows |
23 
24**Key Insight:** "Context + Container diagrams are sufficient for most software development teams." Only create Component/Code diagrams when they genuinely add value.
25 
26## Quick Start Examples
27 
28### System Context (Level 1)
29```mermaid
30C4Context
31  title System Context - Workout Tracker
32 
33  Person(user, "User", "Tracks workouts and exercises")
34…