What's inside
- A header: ADR number, title, status, date, and who decided, was consulted and was informed.
- Context: problem statement, drivers and assumptions.
- Options considered: up to three options, each with pros and cons.
- Decision: the decision, the rationale and the conditions for revisiting it.
- Consequences: positive and negative consequences, risks, follow-on decisions and a review date.
- A completed example for a database migration decision.
Format: PDF (4 pages) and Word document.
How to use it
Write one when a significant architecture decision is made, and keep it with the code or architecture repository.
Get the template
It is free. We email the download link to your work address.