An ADR has three mandatory fields: context (the situation that forced the decision), decision (what was chosen) and consequence (what we accept losing in return). It lives in the repository, versioned like the code. Each ADR gets a number, a descriptive title and becomes immutable once accepted — if the decision changes, a new ADR supersedes the previous one.
GLOSSARY
ADR
What is ADR?
Architecture Decision Record. A short document that captures context, decision and consequence of a technical choice. Standard in the industry since Michael Nygard (2011).
Want to see this in your product?
Describe the idea. The pipeline maps the solution and you approve before anything runs.
Share your idea