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.