What problem does it solve?
When using the GSD (Get Shit Done) project workflow, the .planning/phases/ directory accumulates folders from completed milestones over time, creating clutter that makes it hard to locate active phase work and maintain a clean project structure. This Skill automates the process of sorting and archiving these old phase directories to eliminate that clutter.
Core Features & Use Cases
- Automatic Completed Milestone Detection: Scans your project's
.planning/phases/ directory to identify phase folders belonging to finished milestones without manual sorting.
- Safe Dry-Run Preview: Generates a full summary of all directories that will be archived before any changes are made, so you can verify the action is correct.
- Confirmed Archiving: Moves identified phase directories to the proper
.planning/milestones/v{X.Y}-phases/ storage path only after you give explicit approval.
- Use Case: After wrapping up a 6-month product development milestone with 18 completed phases, use this Skill to instantly move all those old phase folders out of your active workspace instead of manually sorting dozens of directories.
Quick Start
Invoke the gsd-cleanup skill to archive all accumulated phase directories from completed milestones in your project's planning folder.
