gsd-cleanup

Archive completed milestone phase directories into versioned milestone archives.

Updated May 21, 2026
One-click install
npx skills add https://github.com/jedmamosto/m-and-ms --skill gsd-cleanup-jedmamosto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/jedmamosto/m-and-ms/tree/main/.agents/skills/gsd-cleanup
Command: npx skills add https://github.com/jedmamosto/m-and-ms --skill gsd-cleanup-jedmamosto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents project clutter by archiving accumulated .planning/phases/ directories from completed milestones so future planning stays focused and manageable.

Core Features & Use Cases

  • Milestone-aware cleanup: Detects completed milestones and targets their accumulated phase directories for archiving.
  • Dry-run summary: Produces a preview of what will be moved before making changes.
  • Confirmed archival: Moves archived phase directories into .planning/milestones/v{X.Y}-phases/ only after user confirmation.

Quick Start

Run the gsd-cleanup skill to dry-run, review the proposed archived directories, and then archive them into .planning/milestones/v{X.Y}-phases/.

Frequently Asked Questions about gsd-cleanup

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

FAQPage Schema
How do I archive old phase directories from completed milestones?▼

To archive old phase directories, the skill identifies completed milestones, generates a dry-run summary of directories targeted for archival, and moves them into `.planning/milestones/v{X.Y}-phases/` only after you confirm the changes.

What is the best way to organize a cluttered .planning/phases/ workspace?▼

Organizing a cluttered `.planning/phases/` workspace involves detecting completed milestones and consolidating their accumulated phase directories into versioned milestone archives, keeping future planning focused and manageable.

Can I preview directory changes before archiving completed milestone phases?▼

Yes, you can preview directory changes using the dry-run summary feature, which produces a detailed overview of the accumulated phase directories that will be moved before any actual file system modifications occur.

How does milestone-aware directory archiving work for project maintenance?▼

Milestone-aware directory archiving works by detecting milestones marked as completed, targeting their specific phase directories, and relocating them into a structured `.planning/milestones/v{X.Y}-phases/` path upon explicit user confirmation.

Do I need bash automation to consolidate accumulated planning phase directories?▼

Using bash automation streamlines the consolidation of accumulated planning phase directories by automatically identifying completed milestones and executing confirmed directory archival into versioned milestone folders.

When should I avoid archiving phase directories into milestone archives?▼

You should avoid archiving phase directories when milestones are not yet completed, as the process specifically targets and consolidates phase directories from milestones that have already reached completion.