Engineering Manager's Guide to Tech Debt
Metrics, team health, and organizational strategies for managing technical debt across your teams.
You own the outcomes but you do not write the code. Your job is to create the conditions where debt gets addressed systematically -- not heroically.
The Manager's Challenge
You own the outcomes but you do not write the code. Your job is to create the conditions where debt gets addressed systematically -- not heroically. That means shifting from reactive firefighting to proactive measurement, protection, and communication.
Measure What Matters
Go beyond coverage percentages. Track deployment frequency, debt resolution velocity, and onboarding time -- metrics that connect code health to business outcomes.
Protect Team Capacity
Guard your team's ability to do quality work. Allocate dedicated debt reduction time, prevent burnout from constant firefighting, and make quality a first-class priority.
Communicate in Business Terms
Translate technical health into language executives understand: cost, velocity, risk, and retention. Nobody gets budget by saying "the code is messy."
Deep Dive Guides
Metrics Dashboard Guide
Data & VisualizationWhat to measure, how to visualize it, and what the numbers actually mean for your organization. Build dashboards that drive action, not just decorate walls.
Explore Metrics GuideTeam Health & Tech Debt
People & CultureThe hidden link between code quality, developer satisfaction, and retention. Learn why your best engineers leave and what tech debt has to do with it.
Explore Team HealthKey Metrics at a Glance
| Category | Metric | What It Tells You |
|---|---|---|
| DORA Metrics | Deployment Frequency | How often you ship to production |
| Lead Time for Changes | Commit to production -- how fast is your pipeline | |
| Change Failure Rate | Percentage of deployments that cause incidents | |
| MTTR | Mean time to recover from failures | |
| Debt Metrics | Debt Ratio | Debt work vs feature work as a percentage of capacity |
| Debt Age | How long known debt items sit unresolved | |
| Resolution Velocity | Rate at which debt items get closed vs created | |
| Team Metrics | Developer Satisfaction | Survey scores on code quality and tooling |
| Onboarding Time | Weeks until a new hire ships meaningful code | |
| Voluntary Turnover | Attrition rate -- especially among senior engineers |
Your Action Plan
Month 1: Establish Baseline Measurements
You cannot improve what you do not measure. Set up tracking for DORA metrics, create a debt inventory, and run your first developer satisfaction survey. The numbers will be uncomfortable -- that is the point.
Month 2-3: Set Targets with Your Teams
Share the baseline data with your teams and collaboratively set improvement targets. Teams that help define targets are far more likely to hit them. Focus on 2-3 metrics, not 20.
Month 4-6: Implement Debt Allocation Policy (15-20%)
Reserve 15-20% of sprint capacity for debt reduction. This is not a suggestion -- it is the industry-proven allocation that prevents debt from compounding while still delivering features. Protect this time fiercely.
Month 7+: Review Quarterly, Adjust, Celebrate Progress
Run quarterly reviews comparing current metrics to baseline. Adjust targets based on what you have learned. Celebrate improvements publicly -- teams that see their work recognized keep investing in quality.
Downloads for Managers
KPI Dashboard Template
5-sheet Excel workbook with DORA metrics, debt tracking, team health surveys, AI code metrics, and executive summary.
Download XLSXAssessment Checklist
6-page checklist covering code quality, architecture, dependencies, testing, documentation, infrastructure, and process.
Download PDFOnboarding Guide
6-page guide for new hires: current debt landscape, first 30 days, processes, tools, and a quick-reference decision tree.
Download PDFExecutive Deck
8-slide presentation template: the problem, the risk, the opportunity, phased plan, resource allocation, success metrics, and next steps.
Download PDFManagement Guide
Complete PDF guide covering business case building, pitch templates, objection handling, and tactical tips for getting buy-in.
Download PDFTalking to YOUR Manager
As an engineering manager, you need to communicate up as effectively as you communicate down. When presenting tech debt to directors, VPs, and C-suite executives, follow these principles:
Frequently Asked Questions
Focus on outcome metrics, not activity metrics. Track deployment frequency, change failure rate, and debt resolution velocity at the team level -- not individual commit counts or lines of code. Use automated tooling like SonarQube or CodeClimate to surface trends without requiring developers to self-report. Run anonymous quarterly satisfaction surveys. The goal is visibility into system health, not surveillance of individual contributors. When developers see that metrics are used to improve their working conditions rather than judge them, they become allies in measurement.
The industry standard is 15-20% of sprint capacity allocated to debt reduction and maintenance. Teams with severe debt may need 25-30% temporarily. Teams with healthy codebases can run at 10-15%. Start by measuring your current implicit debt spend -- the time lost to workarounds, slow builds, and incident response. Many teams discover they are already spending 30-40% on debt-related work, just invisibly. Making the allocation explicit gives you control over where that time goes instead of letting it be consumed by firefighting.
Treat debt reduction as a first-class work item, not an afterthought. Include debt stories in sprint planning alongside feature stories. Use the Boy Scout Rule for opportunistic fixes during feature work. For larger efforts, negotiate with product: "If we spend 2 sprints on the checkout module, the next 5 features in that area will ship 3x faster." Frame it as an investment with measurable returns, not a tax on delivery. Track velocity before and after debt sprints to prove the investment pays off -- this data becomes your ammunition for future allocations.
Generally no. Dedicated debt teams create two problems: (1) The rest of the organization stops feeling responsible for code quality because "that is the debt team's job," and (2) the debt team lacks context on how code is actually used in production. Instead, embed debt reduction into every team's workflow. Each team owns the debt in their domain. For cross-cutting concerns like dependency upgrades or infrastructure modernization, form temporary working groups with members from affected teams. This spreads knowledge and keeps everyone invested in quality.
Resistance usually comes from one of three places: past trauma where quality initiatives were punitive, legitimate time pressure where they genuinely cannot afford the overhead, or lack of understanding about why it matters. For trauma, start small and show that this time is different -- quick wins that visibly improve their daily experience. For time pressure, reduce scope rather than cutting quality. For understanding gaps, show the data: "Your team spends 40% of time on incidents. Teams with lower debt spend 15%. That difference is 10 hours per week per engineer." Make the case personal and practical.
Show 5 metrics maximum -- executives tune out after that. Lead with (1) deployment frequency trend showing improvement, (2) change failure rate to demonstrate quality gains, and (3) feature velocity to prove debt reduction accelerates delivery. Add (4) developer satisfaction scores to show team health, and (5) cost savings or revenue impact for the financial story. Always show quarter-over-quarter trends with your baseline highlighted. Include one specific example: "We reduced checkout bugs by 80%, saving $6K per month in support costs." Concrete stories make abstract metrics memorable.
Ready to Lead the Change?
You have the metrics framework, the action plan, and the communication playbook. Now put them to work across your teams.