Are ADRs an anti-pattern for LLM coding agents? Devs debate decision records vs comments

ItsPatrickU · x · 2026-11-21

Developer ItsPatrickU argues ADRs (architecture decision records) are an anti-pattern when working with LLMs: challenging an existing decision used to be costly, which justified ADRs, but now everything in a system should be challengeable — and long historical docs can steer agents down the wrong path. Matt Pocock counters that ADRs describe what code can't. PatrickU's proposal: keep a code comment stating what is, drop the history of how we got here — the same way we already fight LLMs to not ingest so much history.

Related event: Developers Debate Whether ADRs Still Matter in the Age of AI Agents(3 posts)→

Original post →