borghei/Claude-Skills / engineering/tech-debt-tracker
tech-debt-tracker
VerifiedScan codebases for technical debt with AST parsing, prioritize by impact, and generate trend dashboards. Use when tracking tech debt, prioritizing refactoring, calculating cost-of- delay, planning sprint debt, or reporting debt to execs.
references/dashboards-and-examples.md
View on GitHub# Dashboards, Examples & Success Criteria
Read this when generating executive/engineering dashboards, running an end-to-end scan example, or validating that the tracker meets its quality bar.
## Executive Dashboard
```
TECH DEBT HEALTH
Overall Score: [0-100] | Trend: [improving/declining]
Cost of Delayed Fixes: [X development days]
High-Risk Items: [count]
MONTHLY REPORT:
1. Executive Summary (3 bullet points)
2. Health Score Trend (6-month view)
3. Top 3 Risk Items (business impact focus)
4. Investment Recommendation (resource allocation)
5. Success Stories (debt resolved last month)
```
## Engineering Dashboard
```
DAILY:
New items identified | Items resolved | Interest rate by component
SPRINT REVIEW:
Debt points completed vs planned | Velocity impact
Newly discovered debt | Team code quality sentiment
```
## Example: Scanning a Python Microservice
```bash
# Run debt scanner
python scripts/debt_scanner.py --repo ./payment-service --output debt_inventory.json
# Output summary:
# Total items found: 47
# Critical: 3 | High: 8 | Medium: 21 | Low: 15
#
# Top 3 by cost-of-delay:
# 1. DEBT-001: payment_processor.py - nested exception handling (CoD: 420)
# 2. DEBT-002: db/migrations/ - 12 unapplied migrations (CoD: 315)
# 3. DEBT-003: tests/ - 62% coverage on payment flow (CoD: 280)
# Prioritize items
python scripts/debt_prioritizer.py --inventory debt_inventory.json --sprint-capacity 40
# Generate executive report
python scripts/debt_dashboard.py --inventory debt_inventory.json --baseline previous_scan.json
```
## Success Criteria
- Scan completes in under 60 seconds for repositories up to 100,000 lines of code.
- Every detected debt item includes a unique ID, file path, line number (where applicable), severity, and debt type -- no fields left as null or unknown.
- Health score correlates with manual code review assessments within 15 points on the 0-100 scale when validated against a senior engineer's judgment.
- Prioritized backlog produces a clear top-10 list where the first item has at least 2x the priority score of the tenth item, confirming meaningful differentiation.
- Sprint allocation recommendations fit within the configured capacity (no single sprint exceeds 100% of debt budget) and cover all high-priority items within the first 3 sprints.
- Dashboard trend analysis correctly identifies improving, declining, or stable directions when compared against at least 3 historical snapshots with known trajectories.
- Cost-of-delay calculations produce actionable dollar-equivalent values that engineering managers can use directly in sprint planning and quarterly roadmap discussions.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |