technical-debt

Identify and classify technical debt using the Cunningham/Fowler quadrant.

5|1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/roanbrasil/engineer-grade-agent-skills --skill technical-debt-roanbrasil
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-debt
Source: https://github.com/roanbrasil/engineer-grade-agent-skills/tree/main/skills/technical-debt
Command: npx skills add https://github.com/roanbrasil/engineer-grade-agent-skills --skill technical-debt-roanbrasil

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unmanaged technical debt slows development velocity, introduces recurring bugs, creates security vulnerabilities, and leaves teams unsure how to prioritize fixes or avoid repeating past mistakes.

Core Features & Use Cases

  • Debt Taxonomy & Identification: Classify debt using the Ward Cunningham/Martin Fowler quadrant, spot code and architecture red flags, and use automated fitness functions to catch violations early.
  • Quantification & Prioritization: Calculate debt ratios, estimate interest rates, and score debt items to focus on high-impact fixes first.
  • Paydown Strategies & Governance: Apply proven patterns like the Boy Scout Rule and Strangler Fig, reserve sprint capacity for debt work, and use ADRs to document architectural decisions to prevent future inadvertent debt. Use Case: A team struggling with a legacy auth module that blocks new SSO features can use this skill to classify the debt, calculate its high interest rate, prioritize it for the next sprint, and apply the Strangler Fig pattern to replace it incrementally without disrupting existing users.

Quick Start

Use the technical-debt skill to audit your current codebase for technical debt, generate a prioritized debt register, and create a 20% sprint capacity plan for debt paydown.

Frequently Asked Questions about technical-debt

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

FAQPage Schema
How do I identify and quantify technical debt in a polyglot codebase?

Identify technical debt in a polyglot codebase by classifying code and architecture red flags using the Ward Cunningham and Martin Fowler quadrant, then calculate debt ratios and estimate interest rates to quantify the impact. This process generates a prioritized debt register highlighting high-impact fixes.

What is the best way to prioritize technical debt for sprint capacity allocation?

The best way to prioritize technical debt for sprint capacity allocation is to score debt items by calculating their interest rates and impact on development velocity. This allows teams to systematically reserve sprint capacity for the highest-impact debt paydown work.

How do automated architecture fitness functions prevent unmanaged technical debt?

Automated architecture fitness functions prevent unmanaged technical debt by continuously enforcing architecture governance rules and catching violations early. This automated enforcement stops structural degradation before it introduces recurring bugs or blocks new features.

When should I use the Strangler Fig pattern to pay down legacy module technical debt?

Use the Strangler Fig pattern to pay down legacy module technical debt when you need to incrementally replace high-interest debt without disrupting existing users. It allows systematic replacement of problematic modules while maintaining system stability.

How do ADRs help with architecture governance and preventing inadvertent technical debt?

Architecture Decision Records (ADRs) help with architecture governance by systematically documenting architectural decisions and their context. This structured decision documentation prevents inadvertent technical debt by ensuring future teams understand past choices and constraints.