← All posts

Dec 9, 2025

How I Think About Technical Debt

Technical debt is not evil by default. Unpriced and invisible debt is the real problem.

ArchitectureEngineeringSystems Design

Technical debt is not just messy code. It is any shortcut whose future cost is real but not accounted for.

Examples:

  • no tests on critical flows
  • no staging parity
  • poor observability
  • ad hoc scripts with no ownership
  • one service doing too much
  • manual recovery steps that live in someone’s head

Debt becomes dangerous when nobody can explain:

  • why it exists
  • how risky it is
  • when it must be paid down

I do not believe in pretending debt can be eliminated. I believe in making it visible, measurable, and intentional.