Verified:GitHub

gsd-cleanup

Archives phase directories from completed milestones into milestone-specific storage.

Updated Feb 18, 2026

Search Tags:#project planning #cleanup #milestones #archive #workspace maintenance #phase directories

One-click install

npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-cleanup-jjchambers80

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/jjchambers80/judgesdirectory/tree/main/.github/skills/gsd-cleanup
Command: npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-cleanup-jjchambers80

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Over time, the `.planning/phases/` directory accumulates phase folders from milestones that are already finished, cluttering the active workspace and making it hard to see current work. This Skill archives those completed phase directories into organized milestone storage. ## Core Features & Use Cases - Milestone Detection: Identifies which milestones are complete and which phase directories belong to them. - Dry-Run Summary: Shows a preview of what will be archived before making any changes, so nothing is moved by surprise. - Confirmed Archiving: Moves phase directories into `.planning/milestones/v{X.Y}-phases/` only after user confirmation. - Use Case: After shipping version 1.2 of a project, your `.planning/phases/` folder still holds six old phase directories. Run this Skill to review them and archive them under `.planning/milestones/v1.2-phases/`. ## Quick Start Ask the assistant to clean up and archive the phase directories from completed milestones in the .planning folder.

Frequently Asked Questions about gsd-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I clean up old phase directories after a milestone is complete?▼

Run the cleanup workflow, which identifies completed milestones and shows a dry-run summary of the phase directories to be archived. After you confirm, the directories are moved into .planning/milestones/v{X.Y}-phases/.

Where do archived phase directories get moved?▼

Archived phase directories are moved from .planning/phases/ into .planning/milestones/v{X.Y}-phases/, where {X.Y} is the version number of the completed milestone they belong to.

Does the cleanup delete any phase directories?▼

No, the cleanup archives directories rather than deleting them. It shows a dry-run summary first and only moves directories into milestone storage after you confirm the operation.

When should I run the milestone cleanup workflow?▼

Run it when .planning/phases/ has accumulated directories from past milestones that are already complete. It is intended for periodic maintenance after finishing a milestone, not during active phase work.