Engineering Manager's Guide to Tech Debt
Last updated . Sources are named and dated inline - how we source claims.
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."
The Middle Position
You are the only person who sees both the sprint board and the roadmap. That is what makes the role worth having, and it is also why both sides quietly assume you are representing the other one.
Only Translating Upward
You defend every estimate and never carry bad news down. It feels like loyalty. It produces predictability: leadership can guess your answer before you speak, so escalations stop carrying information.
Only Translating Downward
Decisions arrive and you pass them along intact. It feels neutral. But the team learns that telling you something changes nothing, so they stop, and you lose the input that made you worth listening to upward.
The job is carrying accurate information in both directions, including the one where it is unwelcome. Telling your director the migration will not land this quarter is unwelcome upward. Telling your team you asked for another engineer and were turned down is unwelcome downward. Both need saying, by the same person, in the same week.
Self-check: in the last month, what did you tell leadership that it did not want to hear, and what did you tell your team that it did not want to hear?
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 Source: DORA (Google Cloud), "DORA's software delivery performance metrics" -- five metrics, not the original four keys. | Change Lead Time | Commit to production -- how fast is your pipeline |
| Deployment Frequency | How often you ship to production | |
| Failed Deployment Recovery Time | How fast you restore service after a deployment fails | |
| Change Fail Rate | Share of deployments that degrade service and need remediation | |
| Deployment Rework Rate | How often a deploy forces unplanned follow-up work | |
| 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
Month one buys you honest numbers, not fixes. 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.
Protecting the Capacity You Reserved
A debt allocation is not protected by announcing it. You can put it in the sprint template, get your director to nod, and still end the quarter with almost none of it spent. It leaked.
What erodes it
What protects it
An allocation nobody measures is a statement of intent, not a policy.
Translating in Both Directions
Going Up
- Lead with the delivery consequence. Not "the auth service is a mess" but "any change to login takes most of a week because six paths get tested by hand."
- Bring a trend, not a bad week. One rough sprint is weather. The same line across several quarters is climate. Only one is worth a director's attention.
- Bring the specific ask. "Something has to change" hands the problem back. "Two sprints next quarter, and I will trade the reporting refresh" is decidable today.
Going Down
- Explain why it went that way. Name the constraint honestly, even when it is unflattering. "We were behind a compliance deadline" is workable. "It was not prioritized" is a shrug.
- Never sell a decision you disagree with as your own preference. It buys one smoother meeting and costs every honest conversation after it.
- Never disown a decision you carried up and lost. "I argued for this, I lost, here is what we are doing" is credible. "They decided" is not.
Two habits of a relay
Your value is that things arrive at both ends in a form the receiver can act on.
Seeing Burnout Before Attrition Does
Attrition is a lagging indicator. By the time someone resigns, the decision was made months earlier, in a stretch that looked fine from where you stood.
Signals you can see earlier
What to do about it
When Leadership Says No
You made the case, brought the trend, brought the ask, and got no. Work out which no it was; they are four different problems.
"Not now"
The case landed; the timing did not. Get the condition written down that brings it back.
"Not this"
They accept the risk but not your fix. Ask which part they object to, then bring back only that.
"Not you"
The decision is being made somewhere else. Ask your director to carry it to whoever owns it.
"Not convinced"
Nothing connected the technical condition to something they are accountable for. Change the evidence, not the volume.
Then, whichever no it was
When the risk happens anyway
You were right, and being right is the least useful thing to carry into the room. Open with the incident, the fix, and what is still exposed. Then connect it back without the accusation: "This is the risk in last quarter's note, and here is the same ask, scoped down." The record argues for you.
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 fail 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 widely used starting point is 15-20% of sprint capacity allocated to debt reduction and maintenance. There is no published tier table that tells you the right number for your team, so treat that figure as a starting allocation and adjust it against your own baseline: raise it while you are paying down severe debt, lower it once the friction is gone. 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 far more on debt-related work than they realize, just invisibly. Making the allocation explicit gives you control over where that time goes instead of letting it be consumed by firefighting. See Measuring Tech Debt for how to establish that baseline.
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 fail 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.