Tidy — refactor a doc/knowledge folder

Audit a folder of documentation/notes for drift, propose a reorganization, execute it preserving every piece of context and git history, then verify nothing broke. This is the docs analog of code refactoring.

Scope: markdown, research, notes, knowledge bases. NOT source code, not Claude config (/setup-audit), not docs-vs-code sync (that lives in /wrap-up Step 11). If pointed at a code folder, say so and redirect.

The golden rule: never lose context. Files get merged and folded, never silently dropped. Everything runs through git so it's recoverable.

Steps

1. Scope + inventory

• Resolve the target folder (the $ARGUMENTS path, or ask if none given). Confirm it's inside a git repo — if not, warn that moves/deletes won't be recoverable and ask before proceeding.
• List every file (path, size, modified date, type). Note the entry point if one exists (README.md or similar).
• Run the mechanical check to get a baseline: python3 ~/.claude/skills/tidy/scripts/check_docs.py <folder> — reports broken links + orphan files (no inbound links). Keep the output; you'll re-run it at the end.