c4-architecture

Generate C4 context, container, component, deployment, and dynamic diagrams in Mermaid syntax.

10|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/alexanderop/dotfiles --skill c4-architecture-alexanderop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: c4-architecture
Source: https://github.com/alexanderop/dotfiles/tree/main/claude/skills/c4-architecture
Command: npx skills add https://github.com/alexanderop/dotfiles --skill c4-architecture-alexanderop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documents and communicates software architecture using the C4 model in Mermaid syntax to improve clarity, onboarding, and design reviews.

Core Features & Use Cases

  • Generate C4Context, C4Container, C4Component, C4Deployment, and C4Dynamic diagrams using Mermaid syntax.
  • Produce output in doc-friendly formats (Mermaid diagrams) and guidance aligned to audience levels (executives to DevOps).
  • Use during system context reviews, containerization decisions, and deployment planning, including microservices and event-driven architectures.

Quick Start

Describe the system or diagram you need, and the tool will generate the corresponding Mermaid C4 diagram(s).

Frequently Asked Questions about c4-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate C4 architecture diagrams using Mermaid syntax?

You can generate C4 architecture diagrams using Mermaid by describing your system context, containers, or components. The tool outputs standardized C4Context, C4Container, C4Component, C4Deployment, and C4Dynamic diagrams in Mermaid syntax to visualize software architecture.

What is the best way to document software architecture for onboarding and design reviews?

Documenting software architecture for onboarding and design reviews is best done using the C4 model in Mermaid syntax. It provides clear architectural communication through standardized boundaries, naming conventions, and ADR linkage guidance tailored for developers and technical stakeholders.

Can I use Mermaid C4 diagrams for microservices and event-driven architectures?

Yes, you can use Mermaid C4 diagrams for microservices and event-driven architectures. The tool supports system context reviews, containerization decisions, and deployment planning, generating diagrams suitable for these complex distributed environments.

How do I create a deployment diagram in Mermaid for system architecture?

To create a deployment diagram in Mermaid for system architecture, describe your deployment environment and infrastructure. The tool generates a C4Deployment diagram using Mermaid syntax, applying standardized boundaries and naming conventions to clarify your deployment topology.

Does the C4 model in Mermaid support dynamic diagrams for visualizing system interactions?

Yes, the C4 model in Mermaid supports dynamic diagrams for visualizing system interactions. You can generate C4Dynamic diagrams alongside context, container, component, and deployment diagrams to illustrate runtime behaviors and communication flows.

When do I need to use C4 component diagrams instead of container diagrams?

You need to use C4 component diagrams instead of container diagrams when drilling down into the internal modules of a specific container. Component diagrams show the internal code-level structure and dependencies, whereas container diagrams focus on the high-level executable applications and data stores.