Technical Debt — an illustrated card from The IT Arcana
XV·the devil

Technical Debt

The shortcut that feels free tonight and compounds interest for years, quietly, in one file.

upright

Just This Once

It's late, the deadline's real, and there's a version of this fix that's clean and correct and would take two more days, and a version that's ugly but works and would take twenty minutes. You know exactly which one you're about to choose. There's no illusion here — you're not fooling yourself that this is the right way, you're making a clear-eyed trade, ship tonight, pay for it later, and writing the TODO comment that both of you know is a formality.

This is the Devil's honest bargain, not a trap sprung on the unaware — a real choice with a real cost, made consciously. That's actually fine, sometimes. The danger was never the shortcut itself. It's forgetting you took it.

what may cross your path

  • A 'just this once' shortcut gets typed into the code with a TODO comment right above it.
  • You ship something you know isn't the real fix, and it works, tonight, exactly as needed.
  • A deadline forces a trade you make with your eyes fully open.
  • You write the ticket for the proper fix even as you commit the temporary one.
Take the shortcut if the deadline is real, but file the follow-up ticket the same hour — the debt is fine as long as someone's actually planning to pay it.

I can take the shortcut and still remember I took it.

conscious tradeoffshortcuttemporary fixcalculated riskdeadline pressure
reversed · the shadow

Three Years, Compounding

You open the file to make what should be a small change, and instead you find a fossil record — six different 'temporary' fixes stacked on top of each other, each one written by someone reasonably trying to ship fast under their own version of tonight's deadline, none of them ever revisited, all of them now load-bearing in ways nobody fully understands. The interest has been compounding since before some of the current team was hired.

This is the Devil's bargain matured into its true cost — not one bad decision, but years of small, individually defensible ones nobody circled back to pay off. The fix now is bigger than any single shortcut ever would have been. It's still worth doing. It'll just take longer than it should have, because it always does once the debt's this old.

what may cross your path

  • You open a file and find three separate 'temporary' fixes stacked on top of each other, none removed.
  • A comment reading 'TEMP FIX — REMOVE BEFORE LAUNCH' has a timestamp from three years ago.
  • Untangling a small bug takes an entire day because everything around it is quietly load-bearing.
  • Someone asks 'why does it work like this' and the answer traces back through five different authors.
Budget real time to pay this down, not just patch around it again — every cycle you defer it, the interest gets more expensive, not less.

The debt is old, not permanent. I can still start paying it off today.

compounding debtlegacy messdeferred costaccumulated shortcutsoverdue reckoning