technical-debt-prioritization

Identifies, classifies and prioritizes technical debt in codebases by analyzing metrics and team input.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/a53ali/ai-dev --skill technical-debt-prioritization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-debt-prioritization
Source: https://github.com/a53ali/ai-dev/tree/main/skills/manager/technical-debt-prioritization
Command: npx skills add https://github.com/a53ali/ai-dev --skill technical-debt-prioritization

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps manage technical debt by identifying, classifying, and prioritizing it based on business impact, streamlining the process of refactor efforts.

Core Features & Use Cases

  • Debt Identification: Gather evidence from developer pain points, high-churn files, slow features, test coverage gaps, and known workarounds.
  • Debt Classification: Use the Debt Quadrant to categorize debt as reckless, prudent, or inadvertent.
  • Debt Scoring: Apply a scoring matrix considering business impact, developer pain, risk, and effort to fix.
  • Stakeholder Framing: Frame tech debt in business terms to advocate for necessary work.
  • Capacity Allocation: Suggest allocation models for debt reduction.

Quick Start

Run the skill with the provided command to identify and prioritize technical debt in your codebase.

Frequently Asked Questions about technical-debt-prioritization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prioritize technical debt based on business impact?

To prioritize technical debt based on business impact, you can use a scoring matrix that evaluates developer pain, risk, effort, and business value. This approach frames refactor efforts in terms stakeholders understand.

What is the best way to communicate technical debt to stakeholders?

The best way to communicate technical debt to stakeholders is by framing codebase health issues in business terms. Categorize debt using a quadrant model and highlight developer pain points to advocate for necessary refactor capacity allocation.

How do I identify technical debt in a codebase?

Identify technical debt by gathering evidence from developer pain points, high-churn files, slow features, test coverage gaps, and known workarounds. Analyzing these codebase metrics reveals areas needing immediate refactoring attention.

How do I classify technical debt as reckless or prudent?

Classify technical debt as reckless, prudent, or inadvertent by using the Debt Quadrant framework. This categorization helps teams understand the context behind codebase health issues and plan appropriate refactoring strategies.

Does debt prioritization work without codebase metrics and team input?

Debt prioritization requires analysis of codebase metrics and team input to be effective. Relying solely on automated tools without developer pain points and stakeholder communication limits the accuracy of the scoring matrix.

How do I allocate capacity for technical debt reduction?

Allocate capacity for technical debt reduction by using suggested allocation models derived from your debt scoring matrix. This ensures refactor efforts are distributed based on business impact and risk rather than ad-hoc decisions.