What problem does it solve? Repositories that have grown unruly accumulate ad-hoc TODO files, inline TODO/FIXME comments, stray documentation outside docs/, and orphan files nobody remembers. Manually auditing and reorganizing this mess is tedious and risky, since a wrong move can lose history or delete something still needed. ## Core Features & Use Cases - Read-only audit: Sweeps the repo for loose work (TODO.md, NOTES.md, inline TODO:/FIXME: clusters), loose docs outside docs/, and orphan files (*.bak, scratch scripts, dead configs), respecting .gitignore and skipping generated output. - Timestamped migration report: Writes a reviewable report to docs/resources/_reports/tidy-repo/ with proposed I-NNN inbox ids, destination mappings, and a delta against the previous report, then stops for explicit user approval before changing anything. - Non-destructive apply: After approval, creates well-formed inbox idea files, moves docs with git mv to preserve history, only flags orphans (never deletes), and reconciles ledgers with at ledger. - Use Case: You inherit a repo with a root TODO.md, design notes scattered in notes/, and old backup scripts. Run the tidy to get a full inventory and migration plan, approve it, and end with everything sorted into docs/tasks_manager/_inbox/ and docs/resources/ ready for triage. ## Quick Start Ask the agent to tidy this repo by inventorying scattered TODOs, loose docs, and orphan files and proposing a migration plan into docs/tasks_manager and docs/resources.
