| name | clean |
| description | Remove old sprint directories with safety checks and archiving options |
| argument-hint | [--all | --keep-latest | --keep N] |
Clean Sprints Command
You are cleaning up old sprint directories.
IMPORTANT WARNING
Sprint directories contain valuable artifacts:
- Specification files (api-contract.md, backend-specs.md, etc.)
- Implementation reports from agents
- Status summaries
- Test reports
The user is responsible for:
- Creating checkpoints (git commits) before cleanup
- Backing up important sprint data
- Deciding which sprints to keep
Workflow
Step 1: List Existing Sprints
ls -la .claude/sprint/
Show the user:
- Sprint directories found
- Last modified dates
- Size of each directory
Step 2: Confirm Action
Ask the user which sprints to clean:
Options:
- Clean all - Remove all sprint directories
- Keep latest - Remove all except the most recent sprint
- Keep N latest - Remove all except the N most recent sprints
- Select specific - Let user specify which to remove
- Cancel - Do nothing
Step 3: Safety Check
Before deletion, verify:
git status --porcelain .claude/sprint/
If there are uncommitted changes, WARN the user:
WARNING: You have uncommitted changes in sprint directories.
Uncommitted files:
[list files]
Recommendation: Commit your changes before cleaning.
git add .claude/
git commit -m "Checkpoint before cleanup"
Continue anyway? (y/N)
Step 4: Execute Cleanup
Based on user choice:
Clean all:
rm -rf .claude/sprint/*/
Keep latest:
LATEST=$(ls -d .claude/sprint/*/ | sort -V | tail -1)
find .claude/sprint/ -mindepth 1 -maxdepth 1 -type d ! -path "$LATEST" -exec rm -rf {} +
Keep N latest:
ls -d .claude/sprint/*/ | sort -V | head -n -[N] | xargs rm -rf
Select specific:
rm -rf .claude/sprint/[selected]/
Step 5: Report
After cleanup:
Cleanup complete.
Removed:
- .claude/sprint/1/
- .claude/sprint/2/
- ...
Remaining:
- .claude/sprint/[N]/
Tip: Create a checkpoint now:
git add -A && git commit -m "Cleanup old iterations"
Quick Mode
For quick cleanup without prompts:
/sprint:clean --all - Remove all sprints
/sprint:clean --keep-latest - Keep only the latest
/sprint:clean --keep 3 - Keep the 3 most recent
Archive Option
Instead of deleting, offer to archive:
tar -czf .claude/sprint-archive-$(date +%Y%m%d).tar.gz .claude/sprint/
Then proceed with deletion.
User Responsibility Notice
Always remind the user:
REMINDER: You are responsible for checkpointing your work.
Before cleaning, consider:
1. git add .claude/ && git commit -m "Checkpoint"
2. Push to remote if you want off-machine backup
3. Keep sprint specs if you might need to reference them
Sprint artifacts are valuable documentation of:
- Architectural decisions
- API contracts
- Implementation reports
- Test results