pp-clean

Clean Project Files

Clean up temporary files and archive useful markdown.

Arguments

$ARGUMENTS

Purpose

After tasks/updates, clean up the project:

1. Delete truly temporary files (test outputs, scratch, debug logs)
2. Archive potentially useful markdown (drafts, notes, old versions)
3. Keep project directory clean while preserving history

Execution Instructions

Step 1: Scan for Files to Clean

Look in project root and common locations for:

Temporary files (to DELETE):

• *_test.md, test_*.md
• scratch*.md, temp*.md, tmp*.md
• debug*.md, *_debug.md
• *.log (unless in logs/ folder)
• output*.md, *_output.md
• Files with DELETE or TEMP in name

Potentially useful markdown (to ARCHIVE):

• draft_*.md, *_draft.md
• notes_*.md, *_notes.md
• research_*.md
• old_*.md, *_old.md, *_backup.md
• v1_*.md, *_v1.md (old versions)
• Any .md file in root that's not part of standard structure
• User-created markdown during session

Step 2: Parse Optional Query

If query provided, focus on:

• Specific pattern: /pp-clean test files
• Specific folder: /pp-clean webhook/
• Specific action: /pp-clean archive only or /pp-clean delete only

Step 3: Show Preview

## Cleanup Preview

### To DELETE (temporary files)
- scratch_booking.md
- test_output.md
- debug_log.md

### To ARCHIVE (move to .context/project/archive/)
- draft_system_prompt.md
- research_notes.md
- old_booking_flow.md

### No Action
- (files that look fine)

---
Proceed with cleanup? (yes/no/edit)

If user says "edit", allow them to:

• Move items between delete/archive
• Skip specific files
• Add files to clean

Step 4: Execute Cleanup

Delete temporary files:

rm {temp_files}

Archive useful markdown:

# Create dated archive subfolder if multiple files
mkdir -p .context/project/archive/cleanup_{date}
mv {markdown_files} .context/project/archive/cleanup_{date}/

Or if single file:

mv {file} .context/project/archive/{file}