A minimal but complete example of defining a software architecture as version-controlled YAML using the C4 model (System → Container → Component → Code).
Diagrams drawn in GUI tools drift out of date the moment code changes. Keeping your C4 model in a plain-text file next to your code means it is:
- Version-controlled — history, blame, and rollbacks like any other file.
- Reviewed in pull requests — architecture changes are discussed where code is.