Templates · Engineering & architecture
C4 architecture overview template
Origin: Simon Brown's C4 model (Context, Containers, Components, Code).
Sections
- System context
- Containers
- Components
- Key decisions
- Quality attributes
How a tough reader scores it
When you score a draft against this format, the Critic evaluates this architecture overview. The weights add up to 100; the fixes for the weakest criteria arrive as cards in the editor.
| Criterion | Weight |
|---|---|
| Context diagram is understandable by non-engineers | 15 |
| Containers and protocols are complete and accurate | 20 |
| Components shown where complexity warrants | 15 |
| Diagrams have legends and consistent notation | 15 |
| Decisions linked to ADRs | 15 |
| Quality attributes have measurable targets | 20 |
How it works in SecondPen.ai
Open the template and the editor writes the blank once, with a line of guidance under each heading that you delete as you fill it in. Write your abstract and the editor names the format it reads like. Ask for a document with a slash command and it offers to start from the matching format. When the draft is ready, the Critic scores it against the criteria above, the way this format's toughest reader would, and the three highest-leverage fixes become Editor cards.
More in Engineering & architecture
- Google design docGoogle engineering culture; the canonical pre-implementation review doc
- RFC (Request for Comments)IETF RFCs; modern engineering template from the Rust RFC process, also used at Uber, Sourcegraph, and HashiCorp
- Architecture Decision Record (ADR)Michael Nygard (2011); now standard in ThoughtWorks Tech Radar "adopt" practices
- Operational Readiness Review (ORR)AWS Well-Architected; Amazon's pre-launch checklist distilled from past COEs
- Threat model (STRIDE)Microsoft SDL; STRIDE by Loren Kohnfelder and Praerit Garg
- Runbook / playbookGoogle SRE and PagerDuty incident-response practice
- SLO documentGoogle SRE book and workbook
- READMEOpen-source convention (standard-readme, GitHub)