mad-c4

Generate C4 architecture diagrams from plan.md files in PlantUML, Mermaid, or Structurizr DSL.

Updated May 7, 2026
One-click install
npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill mad-c4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mad-c4
Source: https://github.com/tmalcolm-0607/mad-council-claw/tree/main/.claude/skills/mad-c4
Command: npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill mad-c4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious, error-prone manual work of creating C4 model architecture diagrams by automatically extracting infrastructure and integration details from your project's plan.md file, saving development and architecture teams hours of documentation effort.

Core Features & Use Cases

  • Multi-Level C4 Diagram Generation: Create Context, Container, Component, Code, and Deployment diagrams on demand, with Levels 1-2 generated by default per C4 best practices.
  • Multiple Output Formats: Export diagrams to PlantUML (stable default), Mermaid (for GitHub/VS Code native rendering), or Structurizr DSL for cloud-based architecture tools.
  • Seamless Workflow Integration: Auto-inserts diagram references into plan.md when used alongside the mad-plan skill, keeping documentation in sync with project plans.
  • Use Case: After finalizing a feature's infrastructure section in plan.md, use this Skill to instantly generate standardized, shareable architecture diagrams for stakeholder reviews without manual drawing tools.

Quick Start

Use the mad-c4 skill to generate default Context and Container C4 diagrams from your active feature's plan.md file in PlantUML format.

Frequently Asked Questions about mad-c4

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

FAQPage Schema
How do I generate C4 architecture diagrams from a plan.md file?

To generate C4 architecture diagrams from a plan.md file, you can automatically extract infrastructure and integration details to produce Context and Container diagrams, eliminating manual drawing and ensuring standardized system documentation.

Can I export C4 model diagrams to Mermaid and PlantUML?

Yes, you can export C4 model diagrams to PlantUML as the stable default, Mermaid for native rendering in GitHub or VS Code, and Structurizr DSL for cloud-based architecture tools.

What is the best way to keep architecture diagrams synced with project specifications?

The best way to keep architecture diagrams synced with project specifications is to auto-insert diagram references into plan.md, ensuring documentation remains consistently up-to-date with the extracted infrastructure details.

Does this diagram generation approach support all C4 levels including Deployment diagrams?

Yes, this diagram generation approach supports all C4 levels, including Context, Container, Component, Code, and Deployment diagrams, with Levels 1 and 2 generated by default per best practices.

How does automated C4 diagram generation prevent architectural hallucinations?

Automated C4 diagram generation prevents architectural hallucinations by applying built-in anti-hallucination checks that ensure every diagram element is sourced directly from the plan.md content.

Do I need a specific markdown structure to generate system design diagrams automatically?

You need a project plan.md file containing infrastructure and integration details to automatically generate system design diagrams, as the extraction process relies directly on this content.