Matt Pocock: comments are a bad store of codebase why — put decisions in ADRs
mattpocockuk · x · 2026-11-21
Matt Pocock argues that comments are a poor store of the 'why' behind a codebase, and architecture decision records (ADRs) are a better place. Responding to the claim that everything in a system should be challenged, he invokes the Chesterton's fence principle: don't remove a fence until you know why it was put up. He also notes not every piece of code needs an ADR.
Related event: Matt Pocock: Put the 'Why' in ADRs, Not Code Comments(2 posts)→
More from coding & agent
- Meta FAIR's Agents Write Their Own Memory Prompts, Beating Human-Crafted Ones 56.0 vs 44.6 — winer666 · 2026-11-21
- CCORE-Web-Coder-4B preview: 4B local model builds sites as single HTML — ConfidentDinner6648 · 2026-11-21
- Standard Bank automates genAI risk assessment on AWS with LLM-as-a-judge across 300+ controls — AWS ML Blog · 2026-11-21
- 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 on ADRs: keep them short, only for surprising hard-to-reverse decisions — mattpocockuk · 2026-11-21
- SwiftTerm maintainer: ~80% of PRs now involve AI, in distinct waves — film_girl · 2026-11-21