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)→

Original post →

More from coding & agent

coding & agent channel →