Generate Arc42-based architecture documentation with C4 diagrams. Use when documenting system architecture, creating architecture docs, or explaining how the system is structured.
Generate comprehensive architecture documentation using the Arc42 template structure with C4 model diagrams. This produces "Explanation" type documentation in the Diátaxis framework.
Before writing ANY documentation, review ../DOCUMENTATION_PRINCIPLES.md for:
These principles override any template suggestions that conflict with them.
When documenting system architecture:
templates/arc42.md/docs/architecture/[system].mdUse the template at: .claude/skills/document-architecture/templates/arc42.md
The template includes all 12 Arc42 sections:
Use Mermaid with C4 naming conventions:
graph TB
subgraph "System Context"
User[User]
System[ACR Automotive]
External[External System]
end
User --> System
System --> External
| Level | Purpose | When to Use |
|---|---|---|
| 1. Context | System in environment | Always |
| 2. Container | High-level tech components | Always |
| 3. Component | Internal structure | For complex containers |
| 4. Code | Class/function level | Rarely, only when needed |
| Scope | Output Path |
|---|---|
| Full system | /docs/architecture/OVERVIEW.md |
| Subsystem | /docs/architecture/[SUBSYSTEM].md |
Before completing:
/docs/architecture/OVERVIEW.md/docs/architecture/SEARCH.md/docs/architecture/DATA_IMPORT.md