Technical debt as a deliberate decision with bookkeeping

What it is

In a 1992 OOPSLA experience report, Ward Cunningham described shipping first, not-quite-right code as taking out a loan: a little debt speeds up development as long as it is repaid soon by rework; every minute spent on not-quite-right code counts as interest, and entire organizations can come to a standstill under the burden. Fowler's quadrant adds two axes: reckless or prudent, deliberate or inadvertent. Prudent, deliberate debt ("ship now, consequences known") is a legitimate trade-off; reckless debt arises when a team knows good practice and works "quick and dirty" anyway, or when it does not know good practice at all.

Why it matters

The metaphor gives people without a programming background a model for why maintenance takes time and why a shortcut taken today becomes more expensive tomorrow. But it only works if the debt is visible: a known shortcut, a ticket, a note giving the reason. Invisible debt has no creditor and is never repaid.

How to apply

• When taking a shortcut, create the entry immediately: an issue, an ADR, or a TODO with an identifier, each stating the reason, the expected extra work, and the trigger that makes repayment due ("as soon as a second tenant is added").
• Review the register regularly and pay off first whatever carries the highest interest: the places that change most often and cost the most time or defects when they do.
• Reserve capacity for repayment in planning instead of hoping for a quiet period that never comes.
• Do not record every disliked decision as debt: a module that is never touched again costs no interest, however ugly it is.
• When a debt is repaid, close the entry and reference it in the commit so the bookkeeping stays credible.

Pitfalls

"We'll clean this up later" without an entry is not debt but a hope. A rewrite that "pays off all debt" often recreates it elsewhere. Interest is paid in time and defects; the measure of debt is therefore friction when making changes, not aesthetics. And anyone who uses the term for every dissatisfaction loses the argument with those who approve the time.