Matt Pocock: ADRs are essential for coding agents — don't remove a fence before you know why it's there

mattpocockuk · x · 2026-11-21

TypeScript educator Matt Pocock argues against the idea that "anything in the system should be challenged," invoking Chesterton's Fence: don't remove a fence until you know why it was put up. He contends ADRs (Architecture Decision Records) are essential for agents — they stop agents from repeatedly recommending avenues you've already explored, and let anyone inheriting the system see the history of surprising decisions.

Related event: Matt Pocock: Put the 'Why' in ADRs, Not Code Comments(2 posts)→

Original post →

More from coding & agent

coding & agent channel →