houseclean

1# /houseclean — Storage Audit and Cleanup
2 
3Use when disk space is low, AI tool caches are bloated, or worktrees need cleanup.
4Do NOT use for project structure issues (use `/organize`) or pre-merge worktree review (use `/merge-review`).
5 
6## Orientation
7 
8**Use when:** cross-drive storage audit -- finds orphaned repos, stale branches, and large directories across all drives.
9**Don't use when:** auditing project infrastructure only (use /infra-audit); cleaning a specific directory (use Bash directly).
10 
11## Invocation Forms
12 
13```
14/houseclean              # Full audit — all phases
15/houseclean --quick      # Drive survey + quick wins only (no deep scan)
16/houseclean --worktrees  # Orphaned worktree audit only
17/houseclean --ai-tools   # AI tool cache audit only
18/houseclean --projects   # Project artifact scan only (node_modules, .venv, etc.)
19/houseclean --migrate X  # Migration instructions for a specific tool (ollama, gemini, npm, cursor)
20```
21 
22## Protocol
23 
24### Phase 1: Drive Survey
25 
26**Windows (PowerShell):**
27```powershell
28Get-PSDrive -PSProvider FileSystem | Select-Object Name, Used, Free, Root | Format-Table -AutoSize
29```
30 
31Present as a table with Drive, Total, Used, Free, Label columns.
32 
33Thresholds: C: free < 5 GB → CRITICAL. C: free < 20 GB → WARNING.
34Store which drives have free space — these are migration targets.
35 
36### Phase 2: C Drive Hot Spots
37 
38**Windows (PowerShell):**
39```powershell
40Get-ChildItem "C:\Users\$env:USERNAME" -Directory -ErrorAction SilentlyContinue |
41…