The C4 model: misconceptions, misuses and mistakes
summary
C4 defines four abstractions — system, container, component, code — and claims that the real value is the shared vocabulary rather than diagrams alone; common mistakes include treating container != Docker, copying the default blue/gray templates, and forcing waterfall handoffs between diagram levels. Tooling makes C4 scale: Structurizr DSL and archetypes, D3 force graphs, PlantUML/Mermaid exports, and automated generation from service registries, OpenTelemetry, or Terraform reduce drift. Trainer reports teaching C4 to over 200 clients across 40 countries and proposes a four‑level diagramming → modeling maturity path.
AI-written summary · about
chapters (36)
- 0:00Introduction to C4
- 0:57C4 core abstractions
- 3:02Context and containers
- 4:00C4 model principles
- 5:18Closing the model code gap
- 6:33Notation and coloring
- 7:37C4 with UML
- 9:22Decisions and runtime
- 10:20Supplementary diagrams
- 11:25Deployment and perspectives
- 12:29C4 versus DDD
- 14:00Event-driven modeling
- 15:39Message bus modeling
- 17:00Arrow direction trade-offs
- 19:27C4 scalability issues
- 21:46Precision in terminology
- 23:40Decathlon case study
- 24:14Tooling and DSLs
- 25:30Custom abstractions risks
- 27:00Modeling advanced concepts
- 27:58Shared libraries
- 30:24Microservices modeling
- 32:04Startup to scale journey
- 33:45Conway's Law mapping
- 35:10Coupling between systems
- 36:54Cross-system containers
- 38:29Shared database issues
- 39:43Automating C4 diagrams
- 40:50Structurizr demo
- 42:56Slicing the model
- 44:17Interactive visualizations
- 45:22Queryable models
- 46:05Static analysis automation
- 48:01Infrastructure as code
- 49:05Architecture maturity model
- 50:41Conclusion
related talks
41mThe C4 Model – Misconceptions, Misuses & Mistakes
42mThe C4 model for visualising software architecture
36mVisualising software architecture with the C4 model
15mC4 Model, the Solution to Standardize My Architecture Diagrams?
40mThe C4 Model — A Way to Clear Architecture
48mVisualising software architecture with the C4 model
43mC4 models as code
42mC4 — A Lightweight Approach to Documenting Architecture