What problem does it solve? Technical debt that depends on someone remembering to flag it always gets undercounted. This Skill automatically detects real antipatterns in a codebase — dead code, duplication, complexity hotspots, circular dependencies, and boundary violations — and records them in a persistent ledger so debt is visible and tracked instead of forgotten. ## Core Features & Use Cases - Automated Static Analysis: Runs fallow via npx against TypeScript/JavaScript code, either scoped to a goal's changed files or across the whole repository. - Idempotent Debt Ledger: Appends deduplicated findings (keyed by SHA-1 fingerprint) as JSON lines to .loop/memory/debt.nav and updates the memory index, so re-runs never double-count. - Read-Only Safety: Never modifies source files, never auto-fixes, and honestly reports unsupported languages (Python, Go, Rust) instead of fabricating findings. - Use Case: After closing a development goal, run the debt scan to catch newly introduced dead exports or duplicated logic and log them as tracked entries the owner can later resolve through a dedicated goal. ## Quick Start Ask the assistant to run a debt scan on this repository and report any antipatterns it finds.
