Architecture decision record (ADR) template
Coming soon
Write down a decision while the reasons are fresh: what prompted it, the options, what you chose and what it changes. Future you will thank you.
Coming soon
Stetley Pages is in preview with a few teams. It opens to everyone soon.
What’s in it
Status: Proposed
Context
What is the issue that we’re seeing that motivates this decision?
Options
Option · For · Against
We will …
Consequences
What becomes easier or harder because of this change?
How to use it
Write one record per decision, and give it a number and a short title.
Keep the context factual: the problem and the forces at play, not the answer.
List the real options, including doing nothing, with what’s for and against each.
Send it for review. Once approved it’s published, and its history shows how it changed.
When a decision is replaced, mark the old record as superseded and link the new one.
More templates · About Stetley Pages
Questions
What is an architecture decision record?
A short document that records one significant decision: its context, the options considered, the choice and its consequences. Teams keep them together so anyone can see why things are the way they are.
Where should ADRs live?
Somewhere the whole team can read and search them, with history. In Stetley Pages each record is versioned and can require approval before it’s published.
Coming soon