| name | source-command-audit-tech-debt-sweep |
| description | Audit the codebase against the constitution — deterministic scan + your interpretation. |
source-command-audit-tech-debt-sweep
Use this skill when the user asks to run the migrated source command tech-debt-sweep.
Command Template
🧹 Tech Debt Sweep
Run the deterministic scanner first, then interpret. Profile: $ARGUMENTS
(default full; quick = red zone only).
-
Run the scanner and write the board:
node contextkit/tools/scripts/tech-debt-scan.mjs --write # full
node contextkit/tools/scripts/tech-debt-scan.mjs --write --quick # red zone only
It checks: file length vs l5.lineBudget, SRP "And/Or/E" names, TODO/FIXME
markers, and React state-loops — and writes contextkit/memory/tech-debt-board.md.
-
Interpret the board with judgment the regex can't: which findings are real
debt vs acceptable cohesion? Which oversized file genuinely hides multiple
responsibilities? Add any smells the scanner can't see (leaky abstractions,
duplicated logic, missing error handling) — referencing AGENTS.md.
-
Report + hand off. Surface the top 5 with the one-line fix each — the
board contextkit/memory/tech-debt-board.md is the full report. Do NOT fix here.
Create no task automatically. Offer to open a focused, explicitly scoped
/dev-start on the worst accepted finding.