
Append-Only ADRs and Reflection

#113 - Architecture Decision Record (ADR) - Michael Keeling
Topic 12 of 18
Published Nov 14, 2022 · Clip 28:02–29:28 (1:26)
Michael explains the append-only principle: don't delete or rewrite old decisions to look smart; instead write a new decision and update the old one with cross-references. His teams add a reflection section at the bottom of old ADRs asking how the decision worked out months later. Minor fixes like typos are fine; the spirit is not to rewrite history.