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.