rtazima

Debt — Development skill for Claude Code

Development community

Scan codebase for technical debt and produce a prioritized report.

How to install Debt

Installs to ~/.claude/commands/rtazima-claude-proj-blueprint-debt.md

Terminal
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/rtazima/claude-proj-blueprint/HEAD/.claude/commands/debt.md -o ~/.claude/commands/rtazima-claude-proj-blueprint-debt.md

Restart Claude Code, or start a new session, for it to be picked up.

What Debt does

Scan codebase for technical debt and produce a prioritized report.

Arguments: $ARGUMENTS (optional: directory to scan, or "full" for everything)

Workflow:

  1. Activate the tech-debt skill
  2. Phase 1 — Automated scan: TODOs, type suppressions, large files, high-churn files, outdated deps, skipped tests
  3. Phase 2 — Manual assessment: classify each finding as real debt or justified exception
  4. Phase 3 — Prioritize: score by frequency × severity × (1/effort)
  5. Phase 4 — Write report to docs/ar

Alternatives in Development

  • Triage PRs — Classify all open PRs by module, review state, scope, and architectural impact — produces a prioritized triage 12.6k ★
  • /surface — View the prioritized attack surface for a target 1.8k ★
  • Analyze Codebase To Book — Prompt: Turn Any Codebase Into a Technical Book 1.7k ★

Full documentation available on GitHub

View Source Repository