Justin McKelvey
Fractional CTO · 15 years, 50+ products shipped
AI Technical Debt: What Your Vibe-Coded App Actually Owes (2026)
Quick Answer
AI technical debt is what accumulates when AI writes code faster than humans understand it. I named it Vibe Debt, and it comes in three flavors: comprehension debt (nobody can explain it), drift debt (five patterns for one job), and dependency debt (bloat nobody chose). It differs from classic tech debt in one brutal way: nobody knows they borrowed.
Verified August 2026 · Author: Justin McKelvey — I coined "Vibe Debt" and fix this debt for a living via Vibe Code Rescue
TL;DR: Debt Nobody Signed For
Classic technical debt is a loan you chose. AI technical debt is a loan you didn't know you signed. That one sentence is the whole problem, and as of 2026 it's sitting inside a meaningful share of every codebase I'm asked to review.
The economics that create it are real and mostly good: vibe coding an MVP now costs almost nothing — often under $100 in tool spend to a launched product. Speed like that is worth having. But every AI session makes a hundred small decisions, each locally fine, and no human holds the ledger. The balance comes due the day real users arrive.
The Three Flavors (and Which One Bankrupts You)
- Comprehension debt — nobody can explain the code. The expensive one. Every future change starts with archaeology; every incident response starts with "who knows how this works?" and the answer is a browser tab. When I run technical due diligence, this is the finding that moves deal prices — not code style, comprehension.
- Drift debt — five patterns for one job. Each AI session reinvented the wheel: three ways to call the API, two auth middlewares, four date formats. Every bug now has five places to hide.
- Dependency debt — bloat nobody chose. Packages that arrived because a generation step reached for them. They widen your attack surface and rot quietly. Nobody defends them in review because nobody remembers adding them.
The full field guide to spotting these from the outside is in how to tell if code was written by AI — the tells are readable in an afternoon.
Why It's Worse Than the Debt You Know
Engineering has managed technical debt for decades — the discipline works when the borrower knows the balance. AI technical debt breaks the model in three places:
- No ledger. Nobody logged the shortcuts because nobody experienced them as shortcuts. The AI's output looked finished.
- False confidence at the worst moment. The demo works, so the team scales marketing instead of review. The debt surfaces at peak traffic — the day you least want it to.
- Refinancing disguised as repayment. The instinctive fix — "ask the AI to clean it up" — adds another hundred unreviewed decisions to the pile. Without a human building comprehension, you're not paying the loan; you're rolling it over at a worse rate.
How to Measure Yours (Free, Today)
You don't need a consultant to get a first reading. Three checks:
- The explain test. Pick your auth flow. Can anyone on the team walk it end-to-end on a whiteboard without opening the repo? That's comprehension debt, quantified in stammers.
- The pattern count. Grep for how many distinct ways the codebase makes an HTTP call or formats a date. More than two is drift.
- The dependency audit. Read your lockfile and mark every package no one can justify out loud. That list is your dependency debt, itemized.
Security-flavored debt gets its own pass: the 20-point vibe coding security checklist covers the failure modes that cost more than subscriptions.
Paying It Down (What Works, What's Refinancing)
The order matters: triage the money paths first — auth, billing, data writes — then consolidate drifted patterns, delete unjustified dependencies, and write tests that encode intent, with a human understanding each system as it's touched. The rule I hold clients to: no AI-refactors-AI without a human comprehension step in the loop.
If the balance is past DIY: my Vibe Code Rescue starts with a free repo audit — 20 minutes of Loom plus a written summary, no strings — and the fixed-price rescue runs $25K–$50K for most production codebases, lighter cases from $15K, complex SaaS $60K–$100K, in 4–8 weeks. The triage methodology itself is public at The Crash Cart.
What to Do Next
Micro-action today: run the explain test on your auth flow at your next standup. Sixty seconds, zero tooling, and you'll know which flavor of debt you're carrying before it knows you.
Related guides: how to tell if code was written by AI, technical due diligence, is vibe coding bad, vibe coding cost, Vibe Debt.
Next step Get the free repo audit →
What your AI stack actually costs
Prices changed 3x this year. The always-current cost sheet: sticker price vs what heavy use actually costs for Cursor, Claude, Replit, Lovable, Bolt & more.
Frequently Asked Questions
- What is AI technical debt?
- AI technical debt is the maintenance burden that accumulates when AI generates code faster than the humans responsible for it build understanding of it. I coined the term Vibe Debt for this in the vibe-coding context: the app works, the demo is beautiful, and nobody on the team can explain the auth flow. Unlike classic technical debt — which someone consciously took on as a shortcut — AI technical debt is usually invisible to the people holding it, which is exactly what makes it dangerous.
- How is AI technical debt different from regular technical debt?
- Classic technical debt is a loan someone chose: we'll hardcode this now, ship, and fix it later — the borrower knows the balance. AI technical debt is debt nobody chose and nobody logged. The AI made a hundred small decisions per session, each locally reasonable, and no human holds the ledger. That's why it shows up as surprise: everything works until real users arrive, and then failures happen in code nobody remembers generating. The interest rate is the same; the difference is that no one knew they'd signed.
- What are the three types of AI technical debt?
- Comprehension debt: nobody on the team can explain what the code does — the most expensive flavor, because every future change starts with archaeology. Drift debt: the codebase solves the same problem five different ways because each AI session reinvented the pattern — multiplying the surface area of every bug. Dependency debt: packages nobody chose on purpose, added because a generation step reached for them — bloating installs, widening the attack surface, and rotting silently.
- How do you fix AI technical debt?
- In order: measure it (have someone senior read the code — the tells are readable in an afternoon), triage it (money paths first: auth, billing, data writes), then pay it down by consolidating patterns, deleting unused dependencies, and writing tests that encode what the system is supposed to do. What doesn't work: asking the same AI to refactor its own output with no human comprehension added — that's refinancing, not repayment. My entry point is a free 20-minute repo audit; a full fixed-price rescue runs $25K–$50K for most production codebases, lighter cases from $15K.
- Is AI-generated code always technical debt?
- No — and I'd start a new product with AI tools myself. Generated code that a human read, understood, and tested is just code. It becomes debt at the moment of the skipped review: shipped without senior eyes, under deadline, with the demo standing in for verification. The tool isn't the debt. The unreviewed merge is.
More on Vibe Code Rescue
Base44 Tutorial (2026): Build and Ship a Working Internal Tool in an Afternoon, Step by Step
A Base44 tutorial from someone who maintains 8+ Base44 apps: build a job tracker with a form, a table, and a status filter in ten prompts, add login and permissions, import your real data, and publish it, on the free plan's 25 credits. The exact prompt at each step, the four places builds go wrong, and the point where you stop and rebuild properly.
Is Emergent Free? (2026) What the $0 Plan's 10 Credits Actually Buy, Where the $20 Tier Starts, and the Cost That Is Not on the Pricing Page
Emergent has a free plan, and it is exactly as free as ten credits a month. Read from emergent.sh/pricing on September 15, 2026: Free is $0 with 10 monthly credits, Standard is $20 a month ($17 annual) for 100 credits and private hosting, Pro is $200 ($167 annual) for 750 credits, Enterprise is custom. Here is what ten credits buys on an agent that plans, codes, and deploys a whole app, the moment you have to pay, how it lines up against Lovable's and Base44's free tiers, and the cost every free plan leaves off the page.
Antigravity vs Claude Code (2026): Google's $0 Agent IDE That Runs Claude vs the Terminal Agent Metered on Your Claude Plan
Antigravity vs Claude Code, as of September 2026: Google's Antigravity is generally available at $0 for individuals with unlimited Tab and Command and weekly rate limits on its agents, and its model menu includes Claude Sonnet and Opus 4.6. Claude Code is Anthropic's terminal agent, included on Pro from $17 a month, Max from $100, and Team seats, running the current Sonnet 5 and Opus 5 against a five-hour usage pool. Free last-generation Claude in an IDE vs current Claude in a terminal: the decision, the limits, and the math.
Codex Usage Limits Explained: The 5-Hour Window, the Weekly Cap, and What Actually Resets (2026)
Codex doesn't have a message count. It has a rolling five-hour allowance that varies by model, a weekly cap that may sit on top of it, and a set of behaviors that quietly burn it faster. Here's what OpenAI's own pricing page says the limits are on Plus, Pro 5x, Pro 20x, and Business as of September 2026, what happens when you hit one mid-task, and the three moves that stretch the allowance before you pay $100 more a month.
Written by
Justin McKelvey
Fractional CTO & AI consultant in Austin, TX. 15 years building software, 50+ products shipped, $53M+ in client revenue generated. I help $1M–$50M founders ship production software and automate operations with AI — without hiring a full-time executive team.
Work with me