The counterpoint: keep the comment, skip the ADR — less bloat, better agent work
mattpocockuk · x · 2026-11-21
The original take in this thread: keep the comment, skip the ADR. Less bloat, and an agent enabled to do better work — "the now" matters more than "how did we get here," just as we fight LLMs to drop so much history into docs. Matt Pocock's rebuttals (short ADRs only for surprising, hard-to-reverse decisions; Chesterton's Fence) appear elsewhere in the same thread, framing the debate over how much historical context agents should get.
Related event: Developers Debate Whether ADRs Still Matter in the Age of AI Agents(3 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