Templates
Reusable templates for documenting architecture decisions and engineering practices.
Available Templates
Decision Page Template
For documenting architecture decisions with context, constraints, options, and trade-offs. View Template →
Operating System Playbook Template
For documenting repeatable engineering practices that teams can adopt. View Template →
When to Use Each
| Template | Use When |
|---|---|
| Decision Page | Making an architecture or technical decision that affects multiple teams or has long-term implications |
| Playbook | Documenting a repeatable practice that teams should follow consistently |
Tips
- Copy the template — Don’t edit the template itself
- Fill in all sections — Even if brief, each section adds value
- Link to evidence — Reference data, discussions, or prior decisions
- Get review — Share with stakeholders before finalizing
- Keep it updated — Decisions and practices evolve
Last updated on