← ClaudeAtlas

reviewlisted

Audit the debt registry, rank survivors by churn × Fowler quadrant, surface a top-N list, then walk paydown on user follow-up. Use when the user asks to review debt, see what to pay down, work through entries, or invokes $review. Stale entries drop with "drop A,B,C".
bcanfield/agentic-tech-debt · ★ 6 · Code & Development · score 71
Install: claude install-skill bcanfield/agentic-tech-debt
# review — audit + (on follow-up) walk paydown Two modes. First turn: print the audit and stop. On a user follow-up ("fix the top one," "walk these," "do A," "pay some down"), apply the rubric below. ## First turn: print the audit Run the bundled `review.py` (it lives in this skill's `scripts/` directory — reference it with the relative path; Codex resolves it against the skill root): ```bash python3 scripts/review.py ``` Optional: `--top N` to surface more than the default 3 candidates. **Re-emit the helper's stdout verbatim in a fenced code block.** Codex may collapse long bash outputs — if you don't print it yourself, the user might not see it. Copy exactly: no preamble, no summary, no "want me to fix the top one?" The fenced block preserves column alignment. Then stop. The user picks the next move. ## Paydown mode (only on user follow-up) Work through requested entries one at a time. Confirm before each fix. Never auto-batch. Never auto-commit. For each entry, read the registry file, the hotspot, and adjacent tests. Apply this rubric: - **Already fixed?** If the marker/symptom the entry describes no longer appears in the hotspot file, say so and add the entry's letter to the drop list. Don't re-fix. - **Cold area?** Churn=0 since `created:` and age >90d → propose deferring. ~20% of files generate ~80% of debt-related rework; don't pay down vanity refactors. - **Prudent-deliberate with payoff_trigger not met?** Honor the trigger. Skip with a one-line "trigger no