Cognitive Debt

The growing gap between how much code or content exists and how much any human genuinely understands — the accumulated bill of unreviewed AI output.

Also known as: cognitive debt, Cognitive debt, comprehension debt, Comprehension debt, chain of understanding

How authors use it

Oldest first (extraction date when no publication date is known).

AuthorTheir termTheir meaning
Cognitive Surrender
AddyOsmani.com · 2025-01-01
comprehension debtThe growing gap between how much code exists in a system and how much any human genuinely understands; the accumulated bill from repeated acts of cognitive surrender.
Simon Wardley's Post — Industrialisation of ML: nine notes on what to expect
Simon Wardley · 2025-12
chain of understandingThe end-to-end ability of humans (and human-AI teams) to comprehend what a system is doing and why. As code production accelerates, this comprehension chain becomes the new bottleneck.
We Studied 150 Developers Using AI (Here's What's Actually Changed...)
Dave Farley (Modern Software Engineering) · 2026-01-27
Cognitive debtThe erosion of a developer's own understanding and skill over time from not thinking hard about code an AI generates — a slow, compounding risk distinct from, but related to, code bloat.
The Future Of Software Engineering
Thoughtworks · 2026-02
cognitive debtThe growing gap between system complexity and human understanding, a successor to traditional technical debt when AI-generated code changes faster than humans can comprehend
Fragments: February 9
Martin Fowler · 2026-02-09
cognitive debtThe loss of the development team's understanding of both the domain and the software when much of the building work is sent off to LLMs, leaving the team knowing less about what was built and why
Fragments: February 13
Martin Fowler · 2026-02-13
cognitive debtThe accumulating cost of a team losing its shared 'theory of the system' — the understanding of why design decisions were made and how parts fit together; Fowler maps it onto his technical-debt metaphor, where the cognitive equivalent of cruft is ignorance of the code and its domain
Eating My Own Dog Food: How I Used the Framework to Write the Post About the Framework
Marc Millstone · 2026-05
cognitive debtThe accumulated cost of not understanding AI-generated code or content you depend on -- analogous to technical debt but in the human's mental model.
The Psychological Costs of Adopting AI
Guy Champniss · 2026-05
Cognitive debtThe cumulative loss of cognitive processing and decision-making skills from offloading difficult tasks to AI; over time, ownership and understanding of solutions erode
The Orchestration Tax is You
AddyOsmani.com · 2026-05-25
Cognitive debtVia Margaret-Anne Storey: the mental-model decay accumulated when you merge code you didn't read carefully. Pairs with technical debt and is the long-tail cost of unpaid orchestration tax.
The Orchestration Tax is You
AddyOsmani.com · 2026-05-25
Comprehension debt(Linked from an earlier Osmani post.) The accumulating gap between what is in the codebase and what you understand about it. Spawning more agents without review accelerates accrual.
The Intent Debt
Addy Osmani (addyosmani.com) · 2026-06-06
Cognitive debt (Osmani's framing within the triple model)Erosion of shared understanding — the gap between how much code exists and how much any human actually understands. Lives in people. Accumulates when the system grows faster than the team's mental model of it. Recoverable in a way underrated: you can ask the agent to explain the code back to you. Osmani equates it with what he previously called comprehension debt.
AI coding creates two kinds of debt. You're only measuring one
Antonija Bilić Arar · 2026-06-18
Cognitive debtThe accumulated loss of understanding of what a system does, why, and who on the team knows what — a property of the system/project, not of an individual ('there is no my cognitive debt'). You can have clean, well-tested code and still carry it if the people who built it can no longer account for it, or if understanding is concentrated in one person.
Finding Comfort in the Uncertainty
Annie Vella · 2026-07-07
cognitive debtKnowledge losing its stickiness because AI unlocks so much volume that we skim everything — an extension of technical debt into the mind
Five studies that are changing how I think about AI in software engineering
Engineering Enablement · 2026-07-10
cognitive debtStorey: debt that 'lives in people' — accumulates when a team's shared understanding of a system erodes faster than it is replenished, producing 'an accumulation of not knowing'.
Software Factories, Light and Dark
AddyOsmani.com · 2026-07-20
Comprehension debtThe widening gap between how much code exists and how much any human still understands. A dark factory doesn't pay this down — it accumulates it as fast as possible, with tests staying green the whole time.
From Technical Debt to Cognitive and Intent Debt: Rethinking Software Health in the Age of AI
Margaret-Anne Storey · 2026-07-28
Cognitive debtA team-level, project-level property: the accumulated erosion of shared understanding (Naur's 'theory of the system') across a team over time -- not an individual's confusion, and not reducible to the state of the code. Explicitly distinguished from Kosmyna et al.'s use of the same term for measurable individual neural-engagement reduction, and from Alakmeh et al.'s 'comprehension debt' (the code-vs-understanding gap) -- Storey's usage is specifically the team-level, longitudinal dimension.
Guillaume Barrois' Post
Guillaume Barrois · 2026-10-08
cognitive debtBorrowed from Margaret-Anne Storey: the accumulating gap between how a system was built (by a fast-moving coding agent) and how well the engineer actually understands it — repaid by rebuilding a mental model (reading code/docs, writing tests, running experiments), not by a mechanical fix.

Documents (33)

Propositions touching this concept (37)

By publication month, oldest first (extraction month when no publication date is known).

2025-01

2025-12

2026-01

2026-02

2026-04

2026-05

2026-06

2026-07

2026-08

2026-09

2026-10

Tensions

Is the value question genuinely settled by evidence, or does uncertainty and sampling bias still dominate?
from: What did the participants of the Thoughtworks 'Future of Software Engineering' Europe retreat (mid-2026) conclude about how agentic AI is reshaping software engineering?
Assessment: The single sharpest divergence, and it sits directly under the headline whether-to-how convergence: they narrate the same shift but disagree on what it establishes. Edwards-Alexander and Herlein read the room's confidence as evidence; Vella and Ruby read the same room as a self-selected in-group. Ruby has the better of it methodologically — he is the only one to interrogate the sample and to notice the evidence is asymmetric (upside anecdotal, downside studied), which is uncomfortable precisely because the cohort's confidence is built on the weaker side.
If code is no longer the bottleneck, what is the new binding constraint?
from: What did the participants of the Thoughtworks 'Future of Software Engineering' Europe retreat (mid-2026) conclude about how agentic AI is reshaping software engineering?
Assessment: They agree code/delivery has ceased to be the constraint but name three different successors, with different investment implications — expand decision-making capacity (Vella), optimise for learning (Edwards-Alexander), or capture tacit knowledge (Herlein). These are complementary in principle but rivalrous for attention and budget; the disagreement matters because each implies a different 'first thing to fix.'
Is code a durable artifact to be maintained, or an ephemeral byproduct regenerated from a more durable source (spec/objective)?
from: What is the future of software development in the agentic/AI age?
Assessment: The most-cited open question of the corpus, and genuinely unresolved (Herlein: 'no consensus here. None.'). The 'code is the better spec' counter is strong — code is unambiguous, executable, deterministic, whereas a prose spec is reinterpreted each run, which sits in tension with verifiability being the quality bar. Ruby's move is the most defensible: it dissolves the code-vs-spec fight by locating durability in the evaluation rather than any representation. Verraes and Ördög expose the load-bearing empirical unknown — nobody has data on regenerate-vs-patch cost or on long-term evolvability of agent-maintained code.
Where does the non-delegable human asset now live — the harness/platform, the oracle, the fundamentals, or the developer's understanding?
from: What is the future of software development in the agentic/AI age?
Assessment: This is the deepest structural disagreement — every author agrees a human residue remains but nominates a different residue, and the choice determines what to invest in and what to teach. The harness-centric (Edwards-Alexander), oracle-centric (Ruby), fundamentals-centric (Nilsson/Bangser), and understanding-centric (Fowler) camps are not merely emphases: they imply different career ladders, different hiring, and different failure modes. Ruby's oracle and Bangser's operational-learning are the most operationally concrete; Nilsson's is the least argued. The absence in the corpus of anyone who holds 'nothing is non-delegable' is itself telling (see unexamined assumptions).
Does the current evidence favor optimism or doubt about agentic engineering's payoff?
from: What is the future of software development in the agentic/AI age?
Assessment: The sharpest divergence in the corpus, because it is about the epistemic ground of every other claim. Nilsson's optimism is explicitly consensus-of-the-in-group and self-flagged as biased; Ruby and the Thoughtworks report both bring the only genuinely external evidence (DORA reversal, HBR intensification, outside surveys) — and it points the other way. On the current record, the skeptics have the stronger footing precisely because the optimistic case is methodologically weakest (a 'sample of one,' as Ruby says of his own best data). The whole cohort's cautious optimism may be an artifact of who was in the room.
Does AI adoption improve output and developer experience together, or do they decouple — with more output bought at the cost of the developers?
from: What is the future of software development in the agentic/AI age?
Assessment: This is the specific, evidence-bearing form of the optimism/pessimism split, and it cuts directly against any simple reading of 'DevEx = AgentEx' as good news. The harmony camp (Nilsson, Ördög) speaks from felt experience and in-group mood; the decoupling camp (Thoughtworks, Vella) and Fowler's own cited HBR study bring the harder data, and it shows output and wellbeing pulling apart. Notably Fowler holds both 'same-size teams do much more' and the burnout finding without resolving them — the single clearest internal contradiction in the corpus, and a sign the harmony framing is doing more reassuring than the evidence supports.
Is preserving human understanding of the system a first-order value, or is comprehension safely offloadable so long as output is verifiable?
from: What is the future of software development in the agentic/AI age?
Assessment: The optimist-practitioner vs. skeptic-humanist axis. Fowler and Nilsson treat comprehension and craft as intrinsic goods whose loss is a harm even when output is fine; Herlein and Ocytko treat comprehension as instrumental — replaceable by verification and platform guardrails. The humanist camp has the stronger long-run argument (Fowler's cognitive-debt case and Ocytko's own 'who-guards-the-guards' problem both show verification and guardrails are themselves fallible artifacts that someone must understand), but the offloadable camp is describing what is actually happening at scale. The crux is whether verifiability can ever be robust enough to make understanding optional — which Ruby's own Goodhart gap (a passable oracle diverging from true intent) suggests it cannot fully be.
If code was never the bottleneck, what is the binding constraint now?
from: What is the future of software development in the agentic/AI age?
Assessment: A productive three-way split downstream of the shared 'code was never the bottleneck' finding. They are not incompatible so much as differently located — decision capacity (Vella) is organisational, learning (Edwards-Alexander) is about the team's rate of understanding the problem, and knowledge (Herlein) is about capturing rationale. But they imply different investments: expand downstream absorption, restructure around learning, or build knowledge-capture pipelines. The corpus has not reconciled which is the true binding constraint, and each author generalizes from a different vantage (a retreat-floor convergence, an org-design frame, a knowledge-engineering frame).

Open gaps (66)