Architecture Blueprint
📝 ADR library
An Architecture Decision Record captures one significant decision: the context, the options, what you decided and what follows from it. The format follows Documenting Architecture Decisions (Michael Nygard, 2011), with an explicit “options considered” section added.
The template
- Title — a short noun phrase for the decision.
- Status — proposed, accepted, deprecated, superseded.
- Context — The forces at play: technical, business, political, constraints. What problem needs a decision now?
- Options considered — Two or more real options, including 'do nothing'. One line each on why it could work.
- Decision — What we will do, in full sentences and active voice: 'We will…'.
- Consequences — Everything that follows — good, bad and neutral. What becomes easier, harder, more expensive?
Your ADRs
Sign in to write ADRs with this template, keep them private, and share the ones you want reviewed.
Sign inShared by the community
No shared ADRs yet — share yours for review.