technical-debt-management

Registers, prioritizes, and funds technical debt paydown using principal, interest, and trigger estimates.

Updated Dec 29, 2025
One-click install
npx skills add https://github.com/snoodleboot-io/discrecontinual_equations --skill technical-debt-management-snoodleboot-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-debt-management
Source: https://github.com/snoodleboot-io/discrecontinual_equations/tree/main/.claude/skills/technical-debt-management
Command: npx skills add https://github.com/snoodleboot-io/discrecontinual_equations --skill technical-debt-management-snoodleboot-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Technical debt that lives only in engineers' heads cannot be prioritized, funded, or argued for. This Skill turns vague complaints about messy code into a quantified debt register where every item carries a principal (cost to fix), interest (recurring carrying cost), and trigger (condition for paydown), making debt a capital allocation decision instead of an unwinnable argument. ## Core Features & Use Cases - Debt Register Entries: Structures each item with location, origin story, principal, evidence-based interest, trigger, growth, and owner, capped at 15-30 live items. - Fowler's Quadrant Classification: Sorts debt into prudent/reckless and deliberate/inadvertent cells, each with a distinct remedy ranging from refactoring to process escalation. - Paydown Funding Models: Compares percentage allocation, debt sprints, feature riders, and dedicated crews, with rules for protecting the allocation during crunch. - Executive Translation: Converts engineering framing into money, risk, and delivery predictability using the formula "costs X per quarter, Y once to stop it, pays back in Z months." - Use Case: A team discovers pricing logic duplicated in three places. The Skill guides writing a register entry quantifying 12 engineer-days/year of interest and 8 days of principal, then ranking it against other items by interest times change frequency divided by principal. ## Quick Start Ask the assistant to create a technical debt register entry for a problematic module, including its principal, interest, trigger, and a priority ranking against other known debt.

Frequently Asked Questions about technical-debt-management

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

FAQPage Schema
How do I prioritize technical debt against feature work?

Rank debt items by interest per change times changes per year plus incident cost, divided by principal. Change frequency is the dominant term, so debt in frequently touched code outranks uglier code that is rarely modified.

What is Fowler's technical debt quadrant?

Fowler's quadrant classifies debt as prudent or reckless, deliberate or inadvertent. Each cell has a different remedy: prudent-deliberate needs a register entry at decision time, reckless-deliberate requires escalating the schedule pressure, and reckless-inadvertent needs capability building.

How much sprint capacity should go to technical debt?

The typical default is 15-20% of each sprint's capacity as a protected allocation. It must stay protected during crunch, never be scheduled last in the sprint, and each completed item should report the interest it removed.

When should you not pay down technical debt?

Skip paydown when code is scheduled for deletion within two quarters, is stable and untouched, when payback exceeds remaining lifetime, or when the area is frozen for compliance. Ugly but quiet code charges no interest and is not debt.

How do I explain technical debt to executives?

Convert each item into money, time, risk, or delivery predictability using the formula: this costs X per quarter and is growing, costs Y once to stop it, and pays back in Z months. Report paydown outcomes in the same units used to request funding.