| name | clean |
| description | Removes temporary screenshots, old backups, stale handoffs, and auto-active flags. Use when project has accumulated temp files. |
| triggers | ["clean"] |
| allowed-tools | Bash, Glob |
| model | haiku |
| user-invocable | true |
Clean
Remove Claude Code artifacts and temporary files.
Data Safety: Move, Do Not Delete
Files found in the project root (prd-archive-*.json, prd-backup-*.json, handoff-*.md, AUDIT-*.md) are moved to .claude/ subdirectories, not deleted. Deleting them destroys sprint history. The move step runs first before any deletion.
Process (Follow This Order)
Step 1: Move stray files from root (first)
mkdir -p .claude/archives .claude/handoffs .claude/reports
mv prd-backup-*.json .claude/archives/ 2>/dev/null
mv prd-archive-*.json .claude/archives/ 2>/dev/null
mv handoff-*.md .claude/handoffs/ 2>/dev/null
mv AUDIT-*.md .claude/reports/ 2>/dev/null
mv *-report.md .claude/reports/ 2>/dev/null
PowerShell:
New-Item -ItemType Directory -Force -Path .claude\archives, .claude\handoffs, .claude\reports | Out-Null
Move-Item prd-backup-*.json .claude\archives\ -Force -ErrorAction SilentlyContinue
Move-Item prd-archive-*.json .claude\archives\ -Force -ErrorAction SilentlyContinue
Move-Item handoff-*.md .claude\handoffs\ -Force -ErrorAction SilentlyContinue
Move-Item AUDIT-*.md .claude\reports\ -Force -ErrorAction SilentlyContinue
Move-Item *-report.md .claude\reports\ -Force -ErrorAction SilentlyContinue
Step 2: Delete expendable files (only from .claude/ subdirs)
| Target | Path | Rule |
|---|
| Screenshots | .claude/screenshots/*.png | Delete all |
| Auto flag | .claude/auto-active | Delete if stale |
| Idle marker | .claude/auto-idle-triggered | Delete always |
| Typecheck stamp | .claude/.typecheck-stamp | Delete always |
| Playwright | .playwright-mcp/ | Delete all |
| Backups | .claude/archives/prd-backup-*.json | Delete if older than 7 days |
| Handoffs | .claude/handoffs/handoff-*.md | Delete if older than 7 days |
| Reports | .claude/reports/*.md | Delete if older than 7 days |
Step 3: Archives — list only, do not auto-delete
List .claude/archives/prd-archive-*.json older than 30 days. Ask user before deleting. If user does not confirm, do not delete.
Step 4: Report
Show what was moved and what was deleted. Separate the two lists.
Rules
- Do not delete
prd-archive-*.json or prd-backup-*.json from project root — move them
- Do not auto-delete archives — prompt user first
- Do not touch source code, prd.json, or config files
- Report what was moved vs what was deleted
