c4-model

Installation
SKILL.md

C4 Model: Design-to-Code Sync Hub

The C4 model is a hierarchical approach to describing software architecture. This skill set focuses on Design-to-Code Sync: ensuring your diagrams reflect actual code reality and your code follows intended design.

🎯 Stakeholder Mapping

Level Name Audience Focus
L1 System Context Executives, PMs, Users, Devs Business value, User Journeys, Scope
L2 Container Architects, Developers, Ops Tech Stack, Deployable units, API boundaries
L3 Component Developers, Architects Internal logic, Layering, Code structure
L4 Code Developers Implementation details, ERDs, Class diagrams

🚫 Architectural Anti-Patterns (The "Don'ts")

  1. The "Spaghetti" Diagram: Drawing more than 20 elements in one diagram. Solution: Break into multiple views.
  2. Tech Leakage in L1: Mentioning "React" or "PostgreSQL" in System Context. Solution: Focus on the "What", not "How".
  3. Missing Descriptions: Boxes with only names. Solution: Every box needs a one-sentence responsibility description.
  4. Ambiguous Arrows: Labels like "Uses", "Sends", "Connects". Solution: Use action verbs like "Authenticates user via", "Publishes order event to".
Related skills
Installs
6
Repository
kinhluan/skills
GitHub Stars
1
First Seen
Mar 15, 2026