gsd-cleanup

To archive completed milestones, this skill targets accumulated phase directories in your planning workspace and moves them into versioned historical folders. It operates only after generating a dry-run summary and receiving your explicit confirmation.

The best way to organize old planning phases while maintaining versioned history is to move them into deterministic milestone archives. This skill relocates phase directories into `.planning/milestones/v{X.Y}-phases/` folders, keeping history organized by version.

Yes, you can preview directory changes before archiving planning phases because this skill produces a dry-run summary. It identifies completed milestones and shows you exactly what will be moved, ensuring directories are only archived after explicit user confirmation.

Yes, this milestone cleanup workflow requires project teams to maintain a `.planning/phases/` directory across milestone cycles. It specifically targets this structure to find accumulated phase directories and move them into `.planning/milestones/v{X.Y}-phases/`.

You should run a workflow cleanup for completed milestones when accumulated phase directories cause clutter and confusion in your planning workspace. This skill targets completed milestones to prevent long-term disorganization by archiving their phase directories.