Technical debt management

Debt is a deliberate trade: taking on future cost to move faster now. Most of what gets called debt is not that — it is mess, which was never a decision, or drift, where the world moved and the code did not. The distinction matters because the arguments and remedies differ.

Classify before prioritizing

• Deliberate debt — a known shortcut with a reason. Has a principal and interest. Legitimate.
• Mess — nobody chose it; it accumulated. No trade was made, so there is nothing to defend.
• Drift — the code was right for a context that has changed. Neither shortcut nor carelessness.
• Not debt at all — code someone dislikes, or would have written differently. Taste is not debt, and rewriting on taste is how remediation budgets get spent with nothing to show.

Cost is a rate, not a total

Debt matters proportional to how often you pay it. Ugly code in a module nobody has touched in three years costs nothing; a moderate awkwardness in the file every feature crosses costs continuously.