Matt Pocock on ADRs: keep them short, only for surprising hard-to-reverse decisions
mattpocockuk · x · 2026-11-21
In a thread debating whether to keep comments or ADRs, Matt Pocock argues ADRs don't have to be long — short and sharp is when they work best — and you only need them for surprising decisions that are hard to reverse. He prefers ADRs to comments because comments can also be used as excuses. The debate started from the counterpoint that docs bloat hurts agents, just like too much context hurts LLMs.
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
- SwiftTerm maintainer: ~80% of PRs now involve AI, in distinct waves — film_girl · 2026-11-21
- Open-source MCP server gives coding harnesses a shared long-term memory with your personal agent — Empty_Pizza9768 · 2026-11-21