Cleanup Workflow (/cleanup-temp)

In plain terms

Tidies up your project folder by moving stray scripts and temporary files out of the way, so the main directory stays clean before you save.

What this skill does

Keeps the root directory clean by moving ad-hoc scripts and temporary files to a gitignored .temp directory

[!TIP] Use this to declutter your workspace and organize "one-off" scripts before committing.

Trigger Conditions

• Keywords: "Clean up files", "Move temporary scripts", "Organize workspace", "Declutter"

---

1. Discovery

• [ ] Scan: Look for files in the root or src/ that look temporary:
• Patterns: temp_*, test_*.ts, *.old.ts, backup_*, migration_v*_debug.sql
• Lint output: lint-output.txt, lint-report.json, lint*.json — remove once linting issues are resolved
• Backup files: *.backup.ts, *.backup.py
• Debug SQL: *_debug.sql
• Python artifacts: *.pyc, __pycache__/
• [ ] Classify: For each file found, determine:
• Its intended use (read comments or logic)
• If it's still needed or can be deleted

2. Organization

• [ ] Prepare: Ensure the .temp/ directory exists in the project root
• [ ] Gitignore: Ensure .temp/ is in .gitignore
• [ ] Move: Move the identified files to .temp/

3. Reporting

• [ ] List: Provide the user with a summary table:

Original Path	New Path	Intended Use
...	.temp/...	...

4. Final Review

• [ ] Deletion: Ask the user if any moved files can be deleted permanently
• [ ] Architecture: Ensure no critical modules were accidentally moved