| name | tech-debt |
| description | Scans codebase for technical debt indicators (TODO, FIXME, HACK, complexity), tracks and prioritizes debt items. |
| argument-hint | [scan|report] |
| user-invocable | true |
| allowed-tools | Read, Glob, Grep, Write |
When this skill is invoked:
-
Determine mode:
scan: Search codebase for debt indicators
report: Generate summary from previous scans
-
For scan mode:
- Search for TODO, FIXME, HACK, TEMP, WORKAROUND comments
- Identify files > 300 lines (complexity risk)
- Find methods > 40 lines
- Detect code duplication patterns
- Check for missing error handling in MCP tools
- Flag deprecated Unity API usage
-
Categorize debt:
- Architecture: Wrong patterns, tight coupling
- Code Quality: Complex methods, duplication
- Documentation: Missing descriptions on MCP tools
- Testing: Untested systems
- Performance: Known slow paths without optimization
- Dependency: Outdated packages
-
Output:
## Tech Debt Report — [Date]
### Summary
- Total items: X
- Critical: X | Major: X | Minor: X
### By Category
| Category | Count | Top Item |
|----------|-------|----------|
| Architecture | X | ... |
| Code Quality | X | ... |
| ...
### Top 5 Priority Items
1. [Item] — Impact: HIGH, Effort: LOW (quick win)
### Aging Alert
[Items older than 30 days]