What problem does it solve?
Untracked technical debt accumulates as TODOs, hacks, large/complex files, duplicated code, deprecated APIs, and missing tests, making maintenance slow and risky. This Skill centralizes discovery, categorization, and tracking so teams can make conscious trade-offs and plan remediation work.
Core Features & Use Cases
- Automated Scanning: Locate TODO, FIXME, HACK markers, @deprecated tags, large files (>500 lines), long functions (>50 lines), and duplicated code patterns.
- Debt Register Management: Append new entries, add manual items with impact/effort metadata, and maintain a markdown register at docs/tech-debt-register.md.
- Prioritization & Reporting: Score items by impact × frequency ÷ effort, re-sort the register for sprint planning, and generate read-only trend and category summary reports.
- Use Case: Run a scan at the start of each sprint to capture new debt, then prioritize top items for the next sprint backlog.
Quick Start
Run the tech-debt skill with the scan subcommand to detect debt indicators and optionally append findings to docs/tech-debt-register.md.