Software Technical Debt Allocation and Remediation Matrix
Balance engineering capacity between tech debt remediation and feature velocity using a structured decision matrix.
Use this template when planning engineering capacity splits across refactoring, bug fixes, and roadmap features. It systematically quantifies system risk to justify engineering maintenance time.
Role: Director of Engineering Operations specializing in agile capacity planning, codebase health, and developer velocity.
Context
- Engineering Organization: {{engineering_org}}
- Target Codebase Subsystems: {{codebase_modules}}
- Total Available Headcount: {{team_headcount}}
- Production Incident Frequency: {{incident_frequency}}
- Upcoming Strategic Milestone: {{growth_milestone}}
- Planning Cycle Duration: {{cycle_duration}}
Task
Design a technical debt remediation matrix for {{engineering_org}} that evaluates {{codebase_modules}} to balance maintenance work against feature delivery, ensuring stability for {{growth_milestone}} over {{cycle_duration}}.
Method
- Evaluate historical defect trends and operational strain across {{codebase_modules}} relative to {{incident_frequency}}.
- Quantify developer drag and deployment friction associated with each subsystem.
- Determine blast radius and severity risk if each technical debt item remains unaddressed.
- Calculate an Urgency Score (1-5) and Remediation Effort (in story points or staff-days) for each module.
- Establish capacity thresholds across {{team_headcount}} (e.g., 70% features, 20% debt, 10% unallocated).
- Allocate specific sprint capacity to high-scoring debt remediation tickets within {{cycle_duration}}.
- Establish automated guardrails and test coverage KPIs to prevent technical debt recurrence.
Constraints
- You MUST assign an actionable remediation tactic to every item in {{codebase_modules}}.
- Total allocated remediation effort MUST NOT exceed 25% of total capacity across {{team_headcount}}.
- All scoring values must be explained via quantitative criteria rather than subjective impressions.
- Dependencies between feature releases for {{growth_milestone}} and debt remediation must be explicitly mapped.
Output format
1. Debt Categorization Model
A concise taxonomy defining severity levels (Critical, Severe, Moderate, Low) and capacity budget ratios.
2. Technical Debt Prioritization Matrix
A Markdown table containing the following fields: | Subsystem / Module | Debt Type | Production Risk (1-5) | Dev Velocity Drag (1-5) | Est. Effort (Days) | Remediation Strategy | Target Sprint | Owner Role |
3. Resource Allocation Summary
A concise tabular allocation breakdown illustrating sprint-by-sprint distribution of {{team_headcount}} across feature work vs. debt resolution for {{cycle_duration}}.
Self-review
- Ensure all subsystems from {{codebase_modules}} are accounted for in the matrix.
- Check that total remediation days do not violate the 25% capacity ceiling of {{team_headcount}}.
- Verify that critical dependencies for {{growth_milestone}} are addressed in early sprints.
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.