
When to Create an ADR

#113 - Architecture Decision Record (ADR) - Michael Keeling
Topic 11 of 18
Published Nov 14, 2022 · Clip 27:00–28:02 (1:02)
Michael identifies 'everything is an ADR' as the number one mistake of newcomers. His team uses heuristic questions: does the decision deal with an important quality attribute, does it bring new technical debt, does it materially change the structure, and can it be easily changed later? ADRs immediately expose what is and isn't architectural, like method naming conventions being good design but not architectural.