gsd-cleanup

Archiving phase directories after milestones involves moving completed phase folders from `.planning/phases/` into versioned `.planning/milestones/v{X.Y}-phases/` locations. This process keeps your planning workspace clean and preserves historical phase data for future reference.

Yes, you can generate a dry-run summary to preview exactly which phase directories from completed milestones will be archived. This allows you to verify the cleanup targets before making any actual changes to your planning folders.

Milestone-aware archiving detects completed milestones and automatically targets their accumulated phase directories for archiving. It moves these phase folders into `.planning/milestones/v{X.Y}-phases/`, ensuring only historical phase data from finished work is removed from the active planning area.

Yes, phase directory archiving requires explicit confirmation before executing. The workflow produces a dry-run summary of what will be archived and only proceeds to move the phase directories into the milestones folder after you provide confirmation.

You should clean up phase directories whenever your `.planning/phases/` directory contains historical phase data from completed milestones. Archiving these old phase folders prevents workspace clutter and organizes past milestone data into versioned folders.