c4-architecture

Overview

C4 Architecture is a Claude Code skill that generates software architecture documentation using C4 model diagrams in Mermaid syntax. It produces multi-level architecture diagrams -- from high-level system context to detailed deployment views -- following the C4 model methodology to document software systems at appropriate abstraction levels.

Key Features

• Multi-Level Diagrams - Generates all four C4 diagram levels: System Context (Level 1), Container (Level 2), Component (Level 3), and Deployment (Level 4), plus Dynamic diagrams for request flows
• Audience-Appropriate Views - Selects diagram levels based on the target audience, from everyone (Context) to developers (Component) to DevOps (Deployment)
• Mermaid Syntax Output - Produces diagrams in Mermaid C4 syntax that can be rendered in markdown, GitHub, and documentation tools
• Codebase Analysis - Analyzes the actual codebase to identify components, containers, and relationships for accurate architecture documentation
• Pragmatic Approach - Follows the principle that Context and Container diagrams are sufficient for most teams, only creating Component and Deployment diagrams when they add genuine value

Who is this for?

This skill is designed for software architects, technical leads, and developers who need to document or communicate their system architecture using industry-standard C4 model diagrams. It is ideal for teams that want to generate architecture documentation directly from their codebase without manually drawing diagrams, and for organizations that need consistent architecture documentation across projects.