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

Original post →

More from coding & agent

coding & agent channel →