Skip to main content

    FIELD NOTE / 9 MIN READ

    The AI technical debt nobody put on the roadmap.

    By Alex Cinovoj, Founder & CTO, TechTide AI · 13 years of mixed IT, last 2 focused on AI implementation.

    Six months after the first AI feature ships, the debt shows up. Not as a dramatic outage, usually, but as a slow accumulation of things nobody can explain: why the prompt says what it says, why one tool call has no input validation, why last month's numbers looked different from this month's with no code changes in between. AI technical debt is real debt with real interest, and it compounds faster than the code-level debt most engineering teams are used to managing, because so little of it is visible in a normal code review. Here are the six line items we find on nearly every engagement, and the order to pay them down in.

    Why AI technical debt hides better than code debt

    A pull request review catches duplicated logic and missing error handling. It does not catch a prompt that quietly relies on a specific model version's quirks, or a tool call that trusts the model's output without validating it against a schema. These issues live in the gap between "the code compiles and the demo works" and "this behaves correctly on the 500th real user input," and that gap is exactly where AI technical debt accumulates.

    The debt is invisible until something forces it into view: a model provider ships an update, a new engineer joins and can't find any documentation for why a prompt is worded the way it is, or a customer reports an answer that's subtly wrong in a way nobody can reproduce. By then, the fix costs far more than it would have during the original build.

    The six line items on the AI technical debt ledger

    1. No eval baseline. Without a regression suite of real tasks, there's no way to know if a change made things better or worse. This is the root cause that makes every other item on this list expensive.
    2. Prompt sprawl. The same instruction, worded four different ways, copy-pasted across files with no shared source of truth. A fix to one copy doesn't propagate, and nobody remembers all four locations exist.
    3. Untyped tool calls. Tool inputs and outputs with no schema validation, so a malformed model response silently corrupts downstream data instead of failing loudly and safely.
    4. Silent model drift. A provider updates the model behind an API endpoint, and behavior changes with no code change on your side to flag it. Without monitoring, this is discovered by users before it's discovered by the team.
    5. No cost attribution. Token spend tracked in aggregate, not per workflow or per customer, so nobody can say which feature is actually profitable and which is quietly burning margin.
    6. Undocumented tribal knowledge. The one engineer who remembers why the retrieval pipeline chunks documents a certain way leaves, and the reasoning leaves with them.

    How each item actually costs you money

    No eval baseline costs you every time you ship a change blind and discover a regression from a support ticket instead of a test run. Prompt sprawl costs you every hour spent hunting down which of four copies of an instruction actually governs production behavior. Untyped tool calls cost you the incident where bad data reached a customer-facing report because nothing caught it at the boundary.

    Silent model drift costs you the week spent debugging "why did accuracy drop" before someone thinks to check whether the provider changed anything. No cost attribution costs you the board meeting where you can't answer "is this feature profitable" with a number. Undocumented tribal knowledge costs you the month a new hire spends re-deriving decisions that already existed, badly, in someone's head.

    None of these show up on a balance sheet directly, which is exactly why they don't get prioritized until they cause a visible incident. This is the same dynamic behind why agentic projects get cancelled: the debt accumulates quietly until the cost of maintaining it exceeds the will to keep going.

    A checklist for paying down the debt, in order

    • Start with the eval baseline. Fifty real tasks, scored against a written rubric. Everything else on this list becomes measurable once this exists.
    • Consolidate prompts into one versioned source. Store every prompt in a single repo location, version-controlled, with a changelog. Delete the duplicates once you've confirmed the canonical version.
    • Add schema validation to every tool call. Reject malformed inputs and outputs at the boundary instead of letting them flow downstream.
    • Set up model drift monitoring. Run your eval suite against the live model endpoint monthly, and alert on any pass-rate drop beyond a small tolerance.
    • Tag token spend by workflow. Even a rough tagging scheme gives you enough to identify which features are profitable.
    • Document the reasoning, not just the code. A short design doc for each major AI workflow: why this chunking strategy, why this model, why this escalation threshold. Future engineers need the "why," not just the "what."

    Most of these can happen incrementally, one workflow at a time, without pausing feature work. Prompt consolidation is the one item that sometimes needs a dedicated week, since it touches every existing workflow simultaneously.

    Who should own this debt

    AI technical debt gets ignored when ownership is unclear. If a separate "AI team" builds the workflow and then hands it to a product team with no shared on-call rotation, nobody is incentivized to fix debt that doesn't show up as their pager going off. The team that owns production reliability for a workflow should own its technical debt, full stop, the same way that team owns any other reliability concern.

    This is also why we build MCP tool layers and eval suites directly with the client's engineering team during an engagement, rather than handing over a black box. Ownership has to transfer with the code, or the debt just resets to zero documentation the day the consultants leave.

    The month-four moment

    We call it month four because that's roughly when this debt tends to surface on the engagements we see: long enough after launch that the original build details have faded from memory, and long enough for a provider model update or two to have happened quietly in the background. Teams that built an eval baseline and documented their reasoning from day one sail through month four without incident. Teams that didn't spend that month debugging problems that a day of process discipline, months earlier, would have prevented.

    If you're approaching that point and can't confidently answer whether your prompts are documented, your tool calls are validated, or your model has drifted since launch, that's worth a hard look before it becomes an incident. Our $1,000 AI Audit is built exactly for this: a written, ranked list of where your AI technical debt actually sits, in 48 hours.

    Frequently asked

    • Regular technical debt is usually visible in the code: duplicated logic, missing tests, outdated dependencies. AI technical debt hides in places code review doesn't reach, like prompt wording scattered across files, tool calls with no input validation, and a model that quietly changed behavior after a provider update nobody tracked.

    About the author

    Alex Cinovoj, Founder and CTO, TechTide AI

    13 years of mixed IT, the last 2 focused entirely on AI implementation. Alex runs TechTide AI, an implementation studio that takes stalled AI pilots into production. He writes about the work in progress at alexcinovoj.com.

    Related field notes

    All field notes →

    Not sure how much AI technical debt is already on your books?