Intent Debt

The absence of externalized rationale, goals and constraints in artifacts agents can read — the one debt AI cannot pay down because the why must originate with humans.

Also known as: intent debt, Intent debt, externalize (intent), tacit intent, load-bearing rationale, cold start (of an agent session), plausible guess (about intent), externalization, cognitive artifacts

How authors use it

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

AuthorTheir termTheir meaning
Externalization in LLM Agents: A Unified Review of Memory, Skills, Protocols and Harness Engineering
Chenyu Zhou, Huacan Chai, Wenteng Chen, Zihan Guo, Rong Shan, Yuanyi Song, Tianyi Xu, Congming Zheng, Jiachen Zhu, Zeyu Zheng, Zhuosheng Zhang, Xingyu Lou, Zhihui Fu, Jianghao Lin, Weinan Zhang · 2026-04-09
externalizationThe process of moving cognitive capabilities out of model weights into external runtime infrastructure (memory, skills, protocols, harness), reframing hard internal problems as more tractable external ones
Externalization in LLM Agents: A Unified Review of Memory, Skills, Protocols and Harness Engineering
Chenyu Zhou, Huacan Chai, Wenteng Chen, Zihan Guo, Rong Shan, Yuanyi Song, Tianyi Xu, Congming Zheng, Jiachen Zhu, Zeyu Zheng, Zhuosheng Zhang, Xingyu Lou, Zhihui Fu, Jianghao Lin, Weinan Zhang · 2026-04-09
cognitive artifactsExternal structures that transform cognitive burdens into forms a model can solve more reliably — the theoretical grounding borrowed from cognitive science
The Intent Debt
Addy Osmani (addyosmani.com) · 2026-06-06
Intent debtThe absence or erosion of the EXTERNALIZED rationale, goals and constraints that explain why the system is the way it is — recorded in artifacts (specs, AGENTS.md, ADRs, learnings files, commit messages) that a teammate, a future you, or an agent can actually read. Crucially distinct from understanding-in-your-head: intent that exists only inside the senior engineer's skull is enormous intent debt for everyone (and every agent) else.
The Intent Debt
Addy Osmani (addyosmani.com) · 2026-06-06
Externalize (intent)Move rationale OUT of human heads and INTO machine-readable artifacts. The verb does the work of the whole prescription section. 'External' means readable by an agent, not just by a teammate.
The Intent Debt
Addy Osmani (addyosmani.com) · 2026-06-06
Tacit intentThe why-of-the-system that humans absorb slowly through hallway conversations, code review comments, incident lore ('we don't do it that way because of an incident in 2023'), and senior-engineer mentorship. Worked for years because humans accumulated it; breaks under agents because agents do not.
The Intent Debt
Addy Osmani (addyosmani.com) · 2026-06-06
Cold start (of an agent session)Every agent session begins without the long-term memory humans build over years; whatever isn't in a readable artifact, the agent doesn't have. Multiplied by every agent you run, every session. The economic engine of the post.
The Intent Debt
Addy Osmani (addyosmani.com) · 2026-06-06
Plausible guess (about intent)What an agent produces when intent is missing from artifacts: a confident-sounding inference from the code that is structurally indistinguishable from real rationale, and worse than the agent admitting it doesn't know. Frames the failure mode as fabrication rather than absence.
The Intent Debt
Addy Osmani (addyosmani.com) · 2026-06-06
Load-bearing rationaleThe subset of why-decisions whose loss would be expensive to reconstruct or dangerous to get wrong. The triage criterion that resolves the 'you can't write down everything' objection: capture the load-bearing why, not the totality.
Five studies that are changing how I think about AI in software engineering
Engineering Enablement · 2026-07-10
intent debtStorey: debt that 'lives in artifacts' — accumulates when the goals, constraints, and rationale that humans and AI agents need are unclear, unwritten, or forgotten; becomes a first-order constraint on what AI can do.
From Technical Debt to Cognitive and Intent Debt: Rethinking Software Health in the Age of AI
Margaret-Anne Storey · 2026-07-28
Intent debtThe absence or erosion of explicit, externalized rationale, goals, and constraints that guide how a system evolves -- lives in artifacts (or their absence), not in code or in people's heads. Distinguished from mere 'missing documentation': it specifically concerns whether goals/constraints/rationale are captured anywhere a human or an AI agent can consult, and is framed as the layer that is hardest to recover once lost ('intent is best captured at the moment key decisions are made... recovering it later can be difficult and sometimes impossible').

Documents (15)

Propositions touching this concept (18)

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

2026-04

2026-06

2026-07

Open gaps (25)