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.