Discussion about this post

User's avatar
Alec Pritzos's avatar

The supersede-rather-than-rewrite property is the part of ADRs that maps best to agent ergonomics. An immutable record of design intent gives the next agent a stable retrieval target, while a line-level diff history forces it to reconstruct intent from edits and dates. Tolaria at 120+ ADRs is a useful ceiling test for whether the review surface scales without becoming the new bottleneck. The Caborn point about forcing AI by default to surface failure modes is the human-process complement: without that pressure, the decision records never get written in the first place.

Ex-Consultant in Tech's avatar

I think this is where AI changes career value too. The people who win are not just the ones who can produce more output. It’s the ones who can make judgment explicit enough that other humans and agents can reuse it.

That applies way beyond engineering. Product specs, GTM decisions, strategy docs, customer segmentation, pricing logic, ops playbooks. Same pattern: if the reasoning is not inspectable, AI mostly accelerates confusion.

No posts

Ready for more?