technical-debt-quantifier

Technical Debt Quantifier Skill

Measures, categorizes, and prioritizes technical debt to support informed decision-making for migration planning and debt remediation strategies.

Purpose

Enable technical debt management for:

• Debt categorization and inventory
• Remediation effort estimation
• Interest calculation (ongoing cost)
• Priority scoring
• Trend tracking

Capabilities

1. Debt Categorization

• Code debt (smells, complexity)
• Architecture debt (coupling, cohesion)
• Test debt (coverage gaps)
• Documentation debt
• Infrastructure debt

2. Remediation Effort Estimation

• Estimate fix time per item
• Calculate total remediation cost
• Identify quick wins
• Plan sprint allocation

3. Interest Calculation

• Calculate ongoing maintenance cost
• Estimate productivity impact
• Project future debt growth
• Model compound interest

4. Priority Scoring

• Score by business impact
• Weight by risk level
• Factor in remediation cost
• Calculate ROI of fixes

5. Debt-to-Value Ratio

• Compare debt to feature velocity
• Benchmark against industry
• Track debt percentage
• Set organizational targets

6. Trend Tracking

• Monitor debt over time
• Track remediation progress
• Identify debt sources
• Report debt velocity

Tool Integrations

| Tool | Purpose | Integration Method | |------|---------|-------------------| | SonarQube | Debt calculation | API | | CodeScene | Hotspot analysis | API | | Codacy | Quality metrics | API | | Code Climate | Maintainability | API | | NDepend | .NET debt analysis | CLI |

Output Schema

{
  "analysisId": "string",
  "timestamp": "ISO8601",
  "debt": {
    "total": {
      "estimatedHours": "number",
      "monetaryValue": "number",
      "items": "number"
    },
    "byCategory": {
      "code": {},
      "architecture": {},
      "test": {},
      "documentation": {}
    },
    "byPriority": {
      "critical": [],
      "high": [],
      "medium": [],
      "low": []
    }
  },
  "metrics": {
    "debtRatio": "number",
    "debtPerLoc": "number",
    "interestRate": "number"
  },
  "trends": {
    "thirtyDay": "number",
    "ninetyDay": "number"
  },
  "recommendations": []
}

Integration with Migration Processes

• legacy-codebase-assessment: Debt quantification
• technical-debt-remediation: Prioritization

Related Skills

• code-smell-detector: Debt identification
• static-code-analyzer: Quality metrics

Related Agents

• technical-debt-auditor: Deep debt analysis