cheriftj

cheriftj / c4-model-skill

Public

Interactive Claude Code skill for C4 architecture diagrams (Simon Brown's model) — mode-driven workflow with Mermaid / Structurizr / PlantUML output and filesystem or MCP (Notion / Linear / Drive) destinations.

architecture-diagrams c4-model claude-code claude-code-skill documentation
17
0
100% credibility
Found Apr 25, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

A skill for Claude Code that guides users through creating, documenting, reviewing, or updating C4 architecture diagrams via interactive conversations.

How It Works

1
🔍 Discover the skill

While planning a new software project or documenting an existing one, you find this helpful tool for creating clear architecture diagrams.

2
📥 Add it easily

You quickly install the skill into your AI coding assistant by picking it from the marketplace or copying it to your project folder.

3
Pick your starting point
🆕
Design from scratch

Start with a new idea and build step by step.

💻
Document your code

Point to your project files for automatic insights.

📝
Review or update

Share an existing diagram for feedback or changes.

4
💬 Chat and build together

Answer a few simple questions at a time in a friendly conversation, watching your diagram take shape level by level.

5
👀 Review each part

Check the context, containers, and details to make sure everything matches your vision.

6
✨ Finalize and save

Give the thumbs up, and it creates beautiful documents with your diagrams ready to share.

🎉 Celebrate clear docs

Your team now has professional pictures explaining how the system works, making everything easier to understand.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is c4-model-skill?

This c4 model skill turns Claude Code into an interactive architecture diagramming tool for Simon Brown's C4 model, handling everything from greenfield design to reviewing existing diagrams via structured slash commands like /c4m:design or /c4m:auto. It runs mode-driven workflows—design, document codebases, parse prose specs, review, or update—with batched questions and validation before outputting Mermaid, Structurizr DSL, or PlantUML diagrams to files or MCP destinations like Notion, Linear, or Google Drive. Built in Shell as a Claude Code plugin, it delivers one Markdown doc per C4 level (Context, Container, optional Component) with embedded visuals.

Why is it gaining traction?

Developers dig the claude interactive diagrams and claude interactive prompt maker that enforce C4 rules like mandatory tech tags and intent-labeled relations, skipping vague "uses" arrows for precise ones. The five modes with auto-detection and claude interactive mcp integration beat manual diagramming, while claude interactive visualization supports extras like System Landscape on demand. It's a smart hook for interactive claude code in Claude Code projects, blending natural prompts with rigorous checklists from c4model.com.

Who should use this?

Software architects prototyping event-sourced systems or microservices via /c4m:design. Backend teams documenting repos with /c4m:code or pasting specs into /c4m:prose. Reviewers critiquing diagrams and updaters tweaking them in collaborative architecture sessions.

Verdict

Try it for quick C4 wins in Claude Code setups—solid docs and examples make the 17 stars and 1.0% credibility score forgivable for an early MIT-licensed skill. Still maturing, so test on non-critical docs first.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.