How is comprehension debt different from technical debt?#
Technical debt lives in the code. Comprehension debt lives between the code and the people accountable for it. A codebase can be clean and well tested and still carry heavy comprehension debt if nobody who owns it can explain why it works the way it does. AI coding agents widen the gap by changing systems faster than anyone reads them.
Who else has described this?#
Margaret-Anne Storey wrote about cognitive debt in a team's shared understanding in February 2026. A month later, Addy Osmani described comprehension debt in codebases. Both echo Peter Naur's 1985 argument that a program's real substance is the theory held by its programmers. Understanding used to arrive as a by-product of doing the work. Delegate the work and it stops arriving.
Paying the debt down is what state reconstruction and the re-entry brief are for.