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