Technical Debt Baselines and Remediation Plans

Build an evidence-backed debt register, compare reliable baselines, and create a prioritized remediation plan with closure checks.

Development / Engineeringtechnical-debtcodebase-audit
by AgentVoltv1.0.0
Free to sign up · every skill included with AgentVolt Pro

Before & after

Same prompt, same agent — the only difference is the skill.

Prompt“What's most urgent to fix in my codebase?”
Beforegeneric AI agent
Technical debt is something that accumulates in codebases over time. There are various things that could be causing issues - old dependencies, poorly structured code, missing tests, things like that. You might want to do a code review to identify areas that need work. Some codebases have more debt than others depending on how long they've been around and how many people worked on them. Prioritizing what to fix is important. Think about what causes the most problems or slows you down the most. Different teams approach cleanup differently.
Afterwith Technical Debt Baselines and Remediation Plans
TECH DEBT SCAN & PRIORITY MATRIX

TOP 3 URGENT (fix this sprint):

1. DEPENDENCY SECURITY (score: 94/100 severity)
Oldest vulnerable lib: lodash 3.10.1 (2018, 4 critical CVEs)
Affected files: 12 imports across utils/
Fix effort: 4hrs (bump to v4.17.21, check deprecated API usage)
Blocked by: None
Payoff: Unblocks security audit, removes risk of breach

2. TEST COVERAGE CLIFF (score: 78/100)
Payment module: 0% coverage (critical path)
15 test cases needed for stripe-integration.ts
Fix effort: 8hrs
Blocked by: Need Stripe test API keys
Payoff: Confidence for next refactor; catches bugs before production

3. CIRCULAR IMPORTS (score: 64/100)
models/User.ts ← → services/AuthService.ts
Causes tree-shake failures, increases bundle +47KB
Fix effort: 6hrs (extract shared enum)
Payoff: Smaller JS, faster cold start

MODERATE (next quarter):
• Deprecated React lifecycle methods in 2 components (score: 42)
• Flaky integration tests (score: 38)
• Monolithic service class (score: 31)

SCORE METHODOLOGY: Severity × Frequency × Fix-effort trade-off

REMEDIATION ROADMAP: Start with dependencies (unblock security), then tests (unblock features), then structure (long-term velocity).

About this skill

Your debt backlog keeps growing, but another list of TODOs will not tell you what to fix next or whether last sprint actually helped. This skill turns repository evidence into a prioritized remediation register, then compares subsequent scans without confusing newly discovered debt with newly introduced debt.

What it does

  • Scans for consequential duplication, deprecated interfaces, risky test gaps, dependency constraints, and maintenance bottlenecks.
  • Ranks findings using demonstrated impact, dependency reach, and recent change frequency, with uncertainty shown explicitly.
  • Gives each underlying issue a stable identity so moved files and repeated symptoms do not inflate the backlog.
  • Compares baselines using matched scope, history windows, and scoring rules; flags incompatible comparisons.
  • Converts priorities into bounded work packages with prerequisites, effort ranges, regression checks, and closure criteria.
  • Distinguishes verified fixes, accepted debt, deferred work, and findings that could not be rechecked.

What you get

A scoped debt register and a practical fix-first plan, backed by code locations and observable consequences. For repeat assessments, you also get a baseline comparison that separates new discoveries, verified resolutions, changed exposure, and coverage gaps.

Best for

Engineering leads and maintainers who need to choose cleanup work, justify modernization slices, or track whether debt remediation is producing verified results across releases.

SKILL.md preview

SKILL.md
---
name: technical-debt-baselines-and-remediation-plans
description: >-
  Scan repository evidence for technical debt, rank findings by impact, blast radius, and change frequency, and create bounded remediation plans. Track stable finding IDs across comparable baselines and require evidence before closing issues. Use when the user says "scan this codebase for technical debt", "what should we refactor first?", "our debt backlog keeps growing", "did the cleanup sprint help?", "compare code health across releases", "plan a legacy modernization", or "estimate the work to fix these hotspots".
---

# Technical Debt Baselines and Remediation Plans

… (sign up to view the full skill)
Sign up to view, copy, and install the full skill

Featured in

More development skills

View all Development skills →