Tech Debt Tracker

Scan codebases to identify, prioritize, and track technical debt.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/Tonybleything76/more-claude-skills --skill tech-debt-tracker-tonybleything76
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Tech Debt Tracker
Source: https://github.com/Tonybleything76/more-claude-skills/tree/main/engineering/tech-debt-tracker
Command: npx skills add https://github.com/Tonybleything76/more-claude-skills --skill tech-debt-tracker-tonybleything76

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ast, json, os, re, sys, collections, datetime, pathlib, typing, dataclasses, statistics, math, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps engineering teams systematically identify, prioritize, and manage technical debt, reducing development friction and improving code quality.

Core Features & Use Cases

  • Automated Debt Detection: Scans codebases to find various types of technical debt like large functions, complexity, and security risks.
  • Intelligent Prioritization: Ranks debt items based on business impact and effort using frameworks like Cost of Delay.
  • Trend Analysis: Tracks debt over time to show progress and forecast future impact.
  • Use Case: A team can run the scanner, get a prioritized backlog of debt items, and allocate specific items to their next sprint, leading to a cleaner codebase and faster feature delivery.

Quick Start

Run the debt scanner on the current directory to find technical debt.

Frequently Asked Questions about Tech Debt Tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify and prioritize technical debt across a software project?

Technical debt identification uses automated scanners with AST parsing and regex to find large functions, complexity, and security risks. Prioritization frameworks like Cost of Delay and WSJF then rank these debt items by business impact and effort.

What types of technical debt can automated code quality scanning detect?

Automated scanning detects various technical debt types including architectural debt, testing gaps, documentation deficiencies, dependency risks, and infrastructure debt, alongside specific code quality issues like large functions and security vulnerabilities.

How do I track technical debt trends over time to forecast future impact?

To track technical debt trends over time, you run periodic codebase scans that log historical debt metrics. This trend analysis monitors progression, shows remediation progress, and forecasts future impact on developer productivity.

Does technical debt tracking work with agile processes for sprint planning?

Technical debt tracking supports agile processes by generating a prioritized backlog of debt items based on Cost of Delay. Teams allocate specific items to their next sprint, balancing feature delivery with software maintenance to improve code quality.

Can I use AST parsing for refactoring large functions and architectural debt?

AST parsing supports refactoring large functions and architectural debt by analyzing source code structure to detect complexity and security risks. It identifies specific refactoring targets to reduce development friction and improve codebase maintainability.

What is the best way to manage dependency risks and infrastructure debt in software maintenance?

Managing dependency risks and infrastructure debt requires systematic scanning to identify vulnerabilities and documentation deficiencies. Utilizing prioritization frameworks like WSJF calculates their Cost of Delay to rank remediation efforts against business impact.