gsd-cleanup

Archive completed milestone phase directories into versioned archive folders after dry-run confirmation.

4|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/electroheadfx/efx-mux --skill gsd-cleanup-electroheadfx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/electroheadfx/efx-mux/tree/main/.codex/skills/gsd-cleanup
Command: npx skills add https://github.com/electroheadfx/efx-mux --skill gsd-cleanup-electroheadfx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you clean up a project’s planning area by moving finished phase directories out of the active workspace and into milestone archives, reducing clutter and making ongoing work easier to manage.

Core Features & Use Cases

  • Milestone Archiving: Identifies completed milestones and prepares their phase directories for archival.
  • Dry-Run Review: Produces a summary before any changes are made so you can confirm the archive plan safely.
  • Confirmation-Based Execution: Archives the selected phase directories only after approval, helping prevent accidental moves.
  • Use Case: A project has accumulated many old phase folders under .planning/phases/; this Skill organizes them into versioned milestone archives for a cleaner active workspace.

Quick Start

Use the gsd-cleanup skill to review completed milestones in this repository and archive the corresponding phase directories after I confirm the dry-run summary.

Frequently Asked Questions about gsd-cleanup

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

FAQPage Schema
How do I archive completed milestone phase directories in my repository?

To archive completed milestone phase directories, this Skill moves finished folders from the active `.planning/phases/` workspace into versioned `.planning/milestones/v{X.Y}-phases/` archive folders. It requires a dry-run inspection and confirmation before executing any directory movement.

What is the best way to clean up old planning phase folders without losing milestone history?

Cleaning up old planning phase folders without losing milestone history involves consolidating them into versioned milestone archives. This Skill identifies completed milestones and moves their phase directories out of the active workspace into archived folders, reducing clutter while preserving historical data.

Can I preview directory changes before archiving my project's planning phases?

Yes, you can preview directory changes before archiving your project's planning phases using the dry-run review feature. This produces a summary of the archive plan so you can safely confirm which completed milestone phase directories will be moved before any actual changes occur.

Does this milestone archiving process require manual confirmation before moving files?

Yes, this milestone archiving process requires manual confirmation before moving files. It uses a confirmation-gated execution model where the selected phase directories are archived only after you explicitly approve the dry-run summary, preventing accidental moves during repository maintenance.

How do I organize accumulated phase folders under .planning/phases/ for a cleaner workspace?

Organizing accumulated phase folders under `.planning/phases/` requires identifying completed milestones and consolidating their directories into `.planning/milestones/v{X.Y}-phases/` archives. This Skill automates the organization process, resulting in a cleaner active workspace for ongoing work.