← ClaudeAtlas

tech-debtlisted

Discover and classify technical debt from mechanical signals, apply closed-set fixes when requested, and publish structured reports (override via TECH_DEBT_DIR or report_file from detect JSON / Constraints). Use for scheduled automation scans, ad-hoc surveys from detection JSON, or when the user asks to fix safe documentation/dependency debt. Default is survey only; write report_file and apply fixes only when the user explicitly requests apply or automation sets may_edit in Constraints. Delegate structural work to refactor.
y-miyazaki/config · ★ 1 · Data & Documents · score 68
Install: claude install-skill y-miyazaki/config
**UTILITY SKILL** — technical debt survey and closed-set apply, not structural refactor. ## Input - **Interactive:** natural-language request; run this skill's detect script unless detect JSON is already in context — parse per [category-input-schema.md](references/category-input-schema.md) - **Automation:** detect JSON in prompt; read `may_edit`, `write_target`, and `report_file` from `## Constraints` per [category-automation-envelope.md](references/category-automation-envelope.md) Path allowlist, when present, arrives in `## Constraints`. ## Output Specification Tech-debt report per [common-output-format.md](references/common-output-format.md). Survey shape when `report_file` is not written; apply shape when written — within [category-scope.md](references/category-scope.md). ## Execution Scope ### USE FOR: - Classify mechanical `signals[]` and `hotspots[]` into prioritized debt findings - Survey: emit Candidates with Delegate hints (`refactor`, `docs-updater`, `self`, `human`) - Apply: write `report_file`; apply closed-set fixes (`broken_doc_ref`, `stale_doc`, simple `pin_drift`) within allowlist ### DO NOT USE FOR: - Structural refactors or architecture changes (use refactor) - CI repair (use ci-sweeper) - Security remediation beyond reporting - Edit caller state files (owned by the caller after verification) ## Reference Files Guide - [category-debt-taxonomy.md](references/category-debt-taxonomy.md) (always read) - [common-checklist.md](references/common-checkl