Dev deletes all ADRs: 49% superseded in days, codebase is now your source of truth

sloppenheimer · x · 2026-11-20

Developer ericclemmons recounts deleting all ADRs from his codebase: 49% had been superseded, on average just 3 days after being written, and 7% were superseded the same day. His takeaway — AI has made "leave it better than you found it" fiscally viable, so your codebase today is your ADR and old patterns should be short-lived.

0xblacklight adds: don't track specs/architecture in your codebase; the code is the source of truth, and doc drift will confuse and mislead your agents.

Original post →

More from coding & agent

coding & agent channel →