Silently resolved ambiguity is comprehension debt of intent

In our theory, the development lifecycle is compressed, and the decisions that are made at “transition” points are moved to later. Even “transition” here is a bit nebulous, as stages of the lifecycle are overlapping more and more with each other. So instead, the types of decisions being made with AI tooling (and the debt they incur) is different. Decisions made with awareness reduce comprehension debt but incur naps; decisions you allow (intentionally or accidently) your agent to make prevent the nap but increase debt. Decide which decisions you should be making, and set your system up to surface them to you alongside relevant data.

The development lifecycle in the "double diamond" structure, with empathy starting small and expanding. Next is defining, which picks up big where empathy left off, and hones down. At that decision point, a problem definition is created. Ideation again expands the space, and an architectural decision record hands off to the prototyping stage, which starts to narrow the space down again. Finally, testing finishes out that point and the decision is whether or not to ship.
Empathy still expands and hands off to a defining stage. However, the definition stage is truncated and moves to a broader ideation stage with a problem definition that is broader. Testing begins in a narrow but straight shot in ideation, soon followed by and overlapping with a broad prototyping stage. When ideation completes, an ADR and goal document is written. Prototyping continues to its truncated point, and then testing finishes out and the final decision point of shipping still exists.
Continue reading

The interest rate on comprehension debt is set by how well relevant information survives

In the last post, we talked about how debt is an instrument, not a smell. We carry forward the intentionality and the financial metaphor into the thinking for this post.  

In particular, we want you to remember 

  1. Mark’s metaphor of “AI companies that sell coding agents are the equivalent of predatory credit card companies offering introductory cards on college campuses to freshmen.”
  2. Comprehension debt as a new and higher interest-rate loan. “Every agent is the new hire on day one, forever.”
  3. “The Last Responsible Moment” needs to account “for ‘holding costs’ [to] curtail sidequests and keep your project running tightly and in its desired direction.”

Building from these cornerstones, this post asks “if that’s comprehension debt, can we just not take on any? Can we pay for all of our understanding now, in cash?” The answer is “no,” for three reasons we’ll get into.

Continue reading

Agents and Acquiring Debt

I had a lovely chat with Kate Chapman and Tom Henderson recently, where we discussed how the shape of technical debt is changing as people become “genie wranglers” and “robot life coaches” (their clever terms, not mine). Specifically, what does using AI mean about addressing pre-AI and accruing post-AI technical debt. Our main takeaway from this session is that commitments should happen at “the last responsible moment,” and AI pushes that moment later.

Human context: Cowritten with Tom and some AI agents; lovingly curated, proofread, and fact-checked by us humans, including Mark. We’re still exploring these ideas, so very much consider this open for feedback. We tried to bridge our academic approach with making things useful in a business sense. We are assuming you have made it past the “spicy autocomplete” phase of using LLMs in your work for this piece. It’s up to you how much you care about code quality for the purposes of this piece, but we think we’ll get into that in a potential later piece. In this article/series, we assume debt is taken on intentionally. This is often not the case, but that is a different problem space than the one we intend to explore.

AI technical debt is different from software debt because it shifts when commitments can be made in the arc of gathering information. We have historically taken on debt early in order to realize some value sooner. Now, we can gather information more cheaply earlier (in theory), and make our difficult-to-change decisions later. That changes the type of debt we’re taking on. It also makes testing even more necessary. You won’t be surprised to know that we’re highlighting and contributing to human judgement throughout, rather than trying to replace the humans. We hint a bit at product commitment points-in-lifecycles and decision making throughout this post, but we said NO to that side quest (for now).

Continue reading