# Skill Tech Debt

> Tech debt inventory, paydown strategy, prioritization (Critical/High/Medium/Low), deprecation planning, communicating to stakeholders, refactoring initiatives. Use when managing technical debt, planning paydown, or assessing refactoring ROI.

- Skill: `saitarrun/skill-tech-debt` (Agent Skill)
- Install (CLI): `npx skillmds@latest add saitarrun/skill-tech-debt`
- Raw SKILL.md: https://api.skillmd.com/api/skills/saitarrun/skill-tech-debt/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: saitarrun (https://skillmd.com/u/saitarrun)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/saitarrun/skill-tech-debt

---


# Skill: Tech Debt Management

Track, prioritize, and pay down tech debt systematically. Don't let it spiral.

## Tech Debt Scoring

**Impact × Effort Matrix**:

```
         LOW EFFORT → HIGH EFFORT
HIGH   |  Quick wins  | Strategic |
IMPACT |              |           |
LOW    | Skip (low ROI)| Avoid    |
```

**Quick wins**: High impact, low effort → Do first  
**Strategic**: High impact, high effort → Plan next quarter  
**Skip**: Low impact, any effort → Only if free time

## Inventory Template

```
## Tech Debt Inventory: [Service]

### CRITICAL (Ship next sprint)
- [ ] Remove Python 2 support (ends 2025, blockers future deps)
  - Effort: 2 weeks
  - Impact: Unblocks 5 dependencies
  - Owner: Backend lead

### HIGH (Backlog, 10% capacity/sprint)
- [ ] Refactor auth middleware (5 places copy-pasted)
  - Effort: 1 week
  - Impact: Reduces bugs, improves maintainability
  - Owner: TBD

### MEDIUM (Nice to have)
- [ ] Extract common utils from 3 services
  - Effort: 3 weeks (spans services)
  - Impact: Code reuse

### LOW (Skip unless free time)
- [ ] Rename internal variable
  - Effort: 1 hour
  - Impact: Readability (minimal)
```

## Paydown Strategy

**Allocate 10% of sprint to tech debt**:
- 80% features (business value)
- 10% tech debt (internal quality)
- 10% bugs (production stability)

**Communicate ROI**:
```
Tech debt paydown: Remove Python 2 support
- Effort: 2 weeks (1 engineer)
- Unblocks: 5 dependencies (new features)
- Prevents: 3+ security issues (old Python 2 libs)
- ROI: High (enables future work)
```

## Deprecation Planning

```
v1.0: Old API endpoint alive
v1.5: Announce deprecation (email, docs)
v2.0: Mark endpoints as "deprecated" (header warning)
v2.5: Remove endpoint (6 months later)
```

---

**Status**: Ready for tech debt management  
**Best for**: Debt prioritization, paydown planning, refactoring