What problem does it solve? Technical debt accumulates silently across a large repository: outdated dependencies, dead code, stale documentation, silent error swallowing, and bloated agent-facing docstrings. This Skill defines the Ava repo's debt classes and tracker rules so a sweeper engine can systematically find, record, and reconcile that debt instead of letting it drift. ## Core Features & Use Cases - Ten debt classes: Covers outdated deps (uv/npm), docs-aging, fail-fast anti-patterns, inline TODO/FIXME markers, dead code via vulture, architectural boundary drift, skill description length, docstring budget violations, stale copied docs, and rebase-bypassed merge-conflict markers. - Tracker integration: Records findings in future/infra/debt-tracker.md as the single living view of open debt, with entries landing as pull requests through the general sweeper engine. - Standalone mechanical runner: run.sh executes the five greppable/tool-checkable classes cron-style with zero agent involvement, printing a scan report to stdout. - Use Case: A maintainer says "/sweep" weekly; the agent runs the mechanical scans, reasons over recently merged PRs for boundary debt, and opens a PR proposing fixes plus tracker updates. ## Quick Start Ask the agent to run a tech-debt sweep of the Ava repo and report which debt classes have new findings since the last watermark.
