
from tech-debt-skill503
Run a deliberate, file-cited technical debt and architecture audit that outputs a TECH_DEBT_AUDIT.md with prioritized findings and remediation recommendations.
This skill runs a structured, opinionated technical-debt audit of a codebase and produces a written audit (TECH_DEBT_AUDIT.md) with file:line-cited findings, severity tags, effort estimates, and prioritized remediation steps. It mandates orientation (read manifests, map modules) before judgment and uses concrete tooling where available to ground findings.
Use when you need a comprehensive snapshot of code health: architecture decay, test coverage gaps, dependency issues, performance hotspots, and security hygiene. Ideal for repo maintainers preparing refactors, release readiness checks, or pre-onboarding audits.
Designed for Claude Code or similar code-aware agents that can invoke repo tooling, run commands, and write files. Works best when the agent can spawn subagents for very large repos.
This skill has not been reviewed by our automated audit pipeline yet.