c4-diagramming

Create four-level C4 architecture diagrams with Mermaid or Structurizr DSL outputs.

86|9|Updated Jun 5, 2026

Search Tags:#architecture #mermaid #mapping #diagram #c4 #pyramid #structurizr

Ready to run

npx skills add https://github.com/magnus919/hermes-profiles --skill c4-diagramming

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: c4-diagramming
Source: https://github.com/magnus919/hermes-profiles/tree/main/skills/architecture/c4-diagramming
Command: npx skills add https://github.com/magnus919/hermes-profiles --skill c4-diagramming

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

C4 Diagramming helps architects and engineers produce consistent four-level diagrams mapped to Artifact Pyramid layers, enabling clear communication of system structure from context to code.

Core Features & Use Cases

Four-level mapping: System Context, Container, Component, and Code diagrams aligned with pyramid layers.
Flexible export formats: Mermaid diagrams and Structurizr DSL exports for integration into docs and tooling.
Reference-driven workflow: Quick access to architecture references (ADR/arc42) for integrated documentation and governance.
Use Case: An architectural team creates a 4-diagram package to share a system's overview with executives, engineers, and operations.

Quick Start

Define the architecture in a C4 model and generate all four diagrams using the recommended exports.

Frequently Asked Questions about c4-diagramming

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

FAQPage Schema

How do I generate C4 architecture diagrams using Mermaid or Structurizr DSL?▼

To generate C4 architecture diagrams, you define your system model and map it across System Context, Container, Component, and Code levels. This Skill outputs both Mermaid diagrams and Structurizr DSL exports for integration into documentation and tooling.

What is the Artifact Pyramid and how does it map to C4 diagram levels?▼

The Artifact Pyramid is a structural framework that C4 diagrams map onto across System Context, Container, Component, and Code zoom levels. This mapping aligns technical architecture visualization with organizational artifact layers for clearer structural communication.

Can I link C4 diagrams to existing architecture references like ADRs and arc42 documentation?▼

Yes, C4 diagrams can be directly linked to architecture references like ADRs and arc42. This reference-driven workflow integrates structural visualization with governance and documentation, ensuring diagrams connect seamlessly to established architectural decisions.

What's the best way to create a four-level architecture diagram package for executives and engineers?▼

The best way to create a four-level architecture package is generating System Context, Container, Component, and Code diagrams mapped to Artifact Pyramid layers. This approach provides executives, engineers, and operations teams with clear structural visualization across multiple zoom levels.

Do I need Structurizr or Mermaid to produce C4 diagrams for my documentation?▼

You do not strictly need one specific tool; the workflow supports both Mermaid and Structurizr DSL as flexible export formats. You can choose the output format that best integrates with your existing documentation pipelines and tooling.

When should I use Component and Code level C4 diagrams instead of just a System Context diagram?▼

You should use Component and Code level C4 diagrams when engineers or operations teams need detailed structural visualization beyond a high-level overview. Mapping all four levels to Artifact Pyramid layers ensures clear communication across different technical zoom levels.