The archive
Comic cover for issue 007: Coffee and Technical Debt
Issue #007
Coffee Break 4 min read· 25 Apr 2026

Coffee and Technical Debt

A short one. On the surprising similarity between the espresso machine nobody descales and the codebase nobody refactors.

Share
The strip
Panel 1 · Monday
It still makes coffee. Sort of.
Panel 2 · Month 6
The coffee tastes like the build pipeline feels.
Panel 3 · Month 7
New machine. Same maintenance schedule. Same outcome pending.

The office espresso machine had a descaling light that had been on for eight months. Everyone saw it. Everyone assumed someone else owned it. The coffee got worse by degrees so small that no single morning justified action.

Technical debt behaves identically. No individual shortcut is worth stopping for. The degradation is always gradual enough to normalise, right up until onboarding a new engineer takes three weeks.

Debt isn't the shortcuts you took. It's the shortcuts you stopped noticing.

The fix in both cases is the same and equally unglamorous: a recurring slot, a named owner, and a definition of 'done' that includes cleanup.

The descaling light has been on for eight months. So has the flaky test.

We put twenty percent of every sprint into maintenance and made the maintenance visible in the same demo as the features. Within two quarters nobody argued about it anymore.

CTO takeaway

The lesson, minus the scar tissue.

  • Budget maintenance as a fixed percentage, not as an occasional heroic project.
  • Demo the cleanup work. Invisible work gets cut first.
  • Gradual degradation is the hardest failure mode to see. Set thresholds in advance.
Comments

War Stories.

Survived something similar? Add it to the record — the best lessons in this archive came from other people's outages.

  • Priya · CTO, logistics startup

    We had the exact same Friday. Except ours was a DNS TTL of 86400 and we spent the weekend explaining caching to the board.

  • Marcus · Founder

    Read this on a Monday morning and immediately cancelled a rewrite. Three seams, not a clean slate. Thank you.

Never miss an issue

Get the next Chronicle in your inbox.

A comic, a story and a takeaway every other week. Written for founders who inherited a codebase they didn't choose.

Free forever. Unsubscribe in one click.

Related Chronicles.