Tactical debt management = quarterly cleanup sprints. Strategic management = system-wide approach to prevent and address.
Strategic dimensions:
1. Prevent debt accumulation.
- ARB process — gates new debt.
- Standards — define what's acceptable.
- Quality gates in CI — automated enforcement.
- Code reviews — catch debt at source.
- Architecture decisions documented in ADRs.
2. Measure debt.
- PMD / static analysis findings count.
- Test coverage trend.
- Custom field count per object.
- Active flow count per object.
- Time-to-deploy.
- Production incident rate.
- Days since last failed deploy.
3. Communicate debt.
- Quarterly debt dashboard to leadership.
- Stories of when debt cost money / time.
- Ratio of feature work to debt work.
4. Justify investment.
- ROI of debt reduction.
- Cost of NOT reducing debt.
- Concrete examples.
5. Allocate capacity.
- Reserve % of team time.
- Tech debt sprints quarterly.
- Per-feature debt cleanup.
- Major modernisation projects.
6. Pay down strategically.
- High-impact debt first.
- Quick wins early to demonstrate value.
- Long-term modernisation for big items.
7. Risk-rank debt.
- High risk: deprecated features, security issues, performance bottlenecks.
- Medium risk: outdated patterns, partial migrations.
- Low risk: cosmetic, naming.
Address high risk first.
8. Prevent regression.
- After cleanup, prevent same debt accumulating again.
- Add quality gate.
- Update ARB criteria.
Common pitfalls:
- No measurement — can't manage what you don't measure.
- No allocation — debt accumulates.
- All-or-nothing — debt accumulated for years isn't paid down in a quarter.
- Wrong priorities — fixing easy stuff while critical debt grows.
Cultural elements:
- Engineers proud of clean code — not "we'll fix it later".
- Architects model behavior — fix debt visibly.
- Leadership supports — protects debt budget.
Senior architect insight: debt is normal in evolving software. The question is whether it's managed or runaway.
The senior framing: strategic debt management is a long game. Quarterly progress; annual reviews; multi-year improvement. Doesn't show up in any single quarter; shows up in 3-year trends.
The most senior measure: deploy time, defect rate, and onboarding time over multi-year. All three improve with managed debt.
