Matt Pocock: Put the 'Why' in ADRs, Not Code Comments
Matt Pocock argued that the reasoning behind code decisions belongs in ADRs rather than comments, making them essential context for agents, while invoking Chesterton's Fence to warn against removing existing system design without understanding it.
2026-11-21 ~ 2026-11-21 · 2 related posts
- Matt Pocock: ADRs are essential for coding agents — don't remove a fence before you know why it's there — mattpocockuk · 2026-11-21
- Matt Pocock: comments are a bad store of codebase why — put decisions in ADRs — mattpocockuk · 2026-11-21