tidy-project Audit

A read-only, three-phase audit of project structure that produces a ranked, prioritized execution plan for reducing maintenance burden on a solo developer. All outputs are persisted to .agents/tidy/project/ — no source files are modified.

Activation

This skill activates ONLY when the user explicitly invokes it via the /tidy-project slash command. Do NOT auto-activate on natural-language requests such as "audit my repo," "review my codebase," "simplify my project," "clean up my project," or "what can I delete" — those phrasings must not trigger this skill.

Output directory convention

Outputs go to .agents/tidy/project/ at the repo root. If a project doesn't use that convention, substitute the output path globally in this SKILL.md workflow. The skill itself doesn't care which path is used; it only cares that all outputs land in one directory.

Re-run behavior

If .agents/tidy/project/ already contains files from a prior run, stop and ask the user before proceeding. Options to offer:

1. Fresh run — move the old directory to .agents/tidy/project-archive/YYYYMMDD/ and start over.
2. Resume — pick up where the previous run left off (e.g. if Phase 1 completed but Phase 2 didn't, skip re-running Phase 1).
3. Incremental update — keep 01-inventory.md if the user confirms the stack hasn't changed, but re-run Phase 2 findings against current code.