Video · 5 min

Debt Metaphor

Ward Cunningham · YouTube (Ward Cunningham) Free Beginner

The person who coined technical debt explains what he actually meant, and it is not what most founders assume. Cunningham says debt is fine when you ship with partial understanding and then pay it back with a rewrite as you learn, and the danger is never repaying it. Five minutes here reframes debt as a deliberate tool rather than a moral failing to be scrubbed away.

  • A little debt is a reasonable way to ship and learn faster
  • Debt only becomes dangerous when you never pay it back
  • Rewriting as understanding improves is the repayment, not a sign of failure

It answers 2 questions

  1. We ship fast but our codebase is turning into a mess. How much should a two-person startup care about tech debt?
  2. When is the right moment to stop iterating on the MVP and rebuild it properly, and how do I avoid the second-system rewrite trap?

Read with it

  1. The permission slip to recruit users by hand, do things manually, and deliver 'insanely great' experiences to your first few... paulgraham.com Essay · ~15 min read Do Things That Don't Scale Paul Graham
  2. Michael Seibel, who ran YC, makes the blunt case for shipping something almost embarrassingly simple and learning from real... Y Combinator Startup Library Video · ~10 min video How to Build an MVP Michael Seibel
  3. This is the canonical warning against throwing away working code and rebuilding from scratch, told through Netscape's rewrite... Joel on Software Essay · ~10 min read Things You Should Never Do, Part I Joel Spolsky
  4. This is the canonical explanation of what a reviewer actually means when they flag your inherited code as risky. Fowler frames... martinfowler.com Essay · About a 10 minute read Technical Debt Martin Fowler
  5. This is the canonical framing for exactly your question: not all messy code is the same. Fowler splits debt on two axes,... martinfowler.com Essay · About a 5 minute read Technical Debt Quadrant Martin Fowler
  6. Beck argues for small, cheap tidyings over grand restructurings, and gives you a way to reason about when cleanup is worth it.... O'Reilly Media (Kent Beck) Book · 120 pages Tidy First? A Personal Exercise in Empirical Software Design Kent Beck
eChai Partner Brands The partnership →