AI Governance

Comprehension Debt: The AI Liability You're Not Measuring

RC

Ryan Carmichael

LinkedIn

Managing Partner, Orienteer AI

AI ships working software faster than any team can understand it. The industry calls the result comprehension debt, and the standard advice is to understand more and slow down. That advice is mostly unworkable. The fix isn't understanding more, it's understanding the right things: knowing which systems you can't afford to run without understanding, and letting the machine own the rest.

The debt nobody is tracking

Every engineer knows technical debt: the shortcuts you take to ship faster, the workarounds, the brittle dependencies, the “we'll fix it later” promises that accumulate until one day you can't ship anything new without first paying back what you owe. The thing about technical debt is that it is at least visible. It shows up in code reviews, in sprint retros, in the eternally growing list of tickets nobody has time to close.

Its sibling can't be pointed to at all. The industry has started calling it comprehension debt, and the name is apt. Where technical debt is the code you can't change, comprehension debt is the systems you can't supervise: AI deployments your team shipped faster than it could understand, and now can't extend, debug, or govern without first rebuilding the understanding that was skipped at build time. There's no ticket for “nobody understands the agent now handling a large share of inbound support.” There's no dashboard for the gap between what you shipped and what your team can maintain. It accumulates entirely off the balance sheet, which is exactly why it is the more dangerous of the two.

What it actually looks like

If you've been near an AI-enabled engineering team for the last 18 months, you've seen some of this.

Engineers who can't debug what they shipped

The AI wrote most of it. They reviewed the diff, ran the tests, merged it, and never built a mental model of how it works. When it breaks under real load, they are reading it for the first time, with nothing to reason from.

Fear of touching production

Once enough systems are running that nobody fully understands, every change feels like a coin flip. The team goes risk-averse, not because the work got riskier, but because the understanding needed to assess the risk no longer exists.

Ship-velocity outrunning comprehension-velocity

Your team ships faster than it did 18 months ago. It builds genuine understanding of what it shipped at about the same rate as before, or slower, because the surface area keeps expanding. The gap between those two rates is the accumulation.

Senior people losing the thread

This isn't a junior problem. Engineers with decades of experience report losing the firm mental model of applications they built with AI. Writing code used to force comprehension. AI breaks that link, and seniority doesn't exempt you.

“Effectively using Claude requires supervision, and supervising Claude requires the very coding skills that may atrophy from AI overuse.”

Anthropic, How AI Is Transforming Work at Anthropic (December 2, 2025)

Read that twice. The capability that lets you supervise the machine is the same capability that using the machine quietly wears away.

The mistake isn't the debt. It's treating it uniformly.

Here is where most of the advice goes wrong. Faced with all of this, the standard prescription is: understand more, slow down, measure the gap until comprehension catches up. That sounds responsible. It is also mostly unworkable, and chasing it will cost you more than the debt itself.

Start with something everyone skips past. You already run your entire company on things no one fully understands. The billing system a contractor built in 2015 and left. The vendor platform that is a literal black box. The payroll software. You do not lie awake over any of them, and not because you understand them. You do not. You are fine with them because at some point someone decided they were safe to not understand, and moved on.

Comprehension was never the thing keeping you safe. Judgment about what you could afford not to understand was.

So the question is not “does the team understand the AI code.” It never fully will, any more than it understands the assembly its compiler emits. The question is which of your systems can end you, and which are harmless. The agent that prices a policy, moves a customer's money, or decides who gets approved is one you have to be able to open, explain, and answer for. The one that reformats an internal report is one you should be glad to never think about again.

The failure isn't comprehension debt. It is uniform comprehension debt: treating every system the same, which leaves two bad options. Try to understand all of it, which is impossible and fails anyway, or understand none of it, which is what most teams are quietly doing. The real discipline is neither. It is triage: decide, deliberately and in advance, the small set of systems you cannot afford to run without understanding, protect those completely, and let the machine own the rest, on purpose and with your eyes open.

Why triage is an operating-model problem, not an engineering one

Deciding which systems you must own is not a coding decision. It is a business decision, and it lives above the keyboard.

Engineering hygiene, more review, more pairing, more documentation, addresses comprehension at the level of a single change: did this engineer understand what they just merged? The triage decision sits one level up: does the organization know which of its AI systems it is on the hook for, who owns each of those, and whether the understanding of them will survive the person who has it? That is not about how careful any one engineer is. It is about whether the firm built the structures, ownership, governance, knowledge handoff, change management, that turn individual work into institutional capability.

Most firms haven't, because the bottleneck moved and the discipline didn't move with it. Tooling discipline was built for a world where the hard part was writing code: CI/CD, code review, deployment gates. The hard part now is knowing what was written, which of it matters, who owns it, and how to keep that knowledge alive as people change teams and leave. Same pipelines, different bottleneck, and the old hygiene doesn't reach it.

It shows up eventually: outages no one can root-cause, audits the firm can't answer, key-person dependency that turns existential the first time a senior engineer leaves, regulatory exposure when the answer to “what is this system authorized to do” is “we'd have to check.” By the time any of that reaches your operating review, the debt has been accruing for quarters, and the interest is what's now due.

The connective role most firms are missing

Triage only works if someone owns it. In the firms that stay current, there is a person holding the whole picture: a role that connects the AI work across teams, requires that nothing reaches production without a named owner who can describe how it works, and treats team-level understanding as a deliverable rather than a hope.

Most firms don't have that role. The work is split across specialists: a strategy lead who owns the roadmap, an engineering lead who owns the build, a governance lead who owns the policies. Each is competent in a slice. None of them owns the seams between the slices, and the seams are exactly where comprehension debt collects. Tools don't close them (observability tells you what a system did, not whether your team could react), and outside vendors tend to add new seams rather than close existing ones. The connective role has to be played by someone, whether you build it in-house, hire for it, or bring it in on an engagement.

What to do about it

In order of leverage.

Step 1

Triage first

Take your production AI systems and sort them with one question each: could three people on the team extend this, debug it, and take it over if the original builder left next month? The ones where the answer is no, and that you would have to answer for, are your short list. That list, not the whole codebase, is what you protect. The rest you can leave alone, deliberately.

Step 2

Put a name on the ones that matter

For every system on the short list, require answers before it stays in production: who owns it by name, who can take over if that person leaves, what the runbook is when it fails, and what the team needs to know to extend it. No answers, the work isn't done, regardless of whether the code runs.

Step 3

Make team-level understanding the unit

If only one person understands a critical system, that system is an outage waiting for a vacation. Handoff requirements, documentation that is actually current, and reviews that test comprehension rather than just correctness are how you raise the bar from the person to the team.

Step 4

Audit what you already have

Most firms can't say which AI systems are running, who owns each, or how much comprehension debt has already built up. A structured audit that produces an inventory, a risk ranking, and an ownership-gap map is the prerequisite for everything above. You can't triage a portfolio you can't see.

Takeaways

Understanding everything is a losing race. You never will, the finish line moves every time a model improves, and you don't need to.

Name the few systems you cannot afford to run without understanding, protect those completely, and let the machine own the rest, on purpose.

Not sure how much comprehension debt you're carrying?

Start with the assessment to see where the gaps are, or talk to us about putting the discipline in place.