gsd-cleanup

Archive completed milestone phase directories into .planning/milestones/v{X.Y}-phases/ after dry-run confirmation.

8|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/D0NMEGA/donnyclaude --skill gsd-cleanup-d0nmega
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/D0NMEGA/donnyclaude/tree/main/packages/skills/gsd-cleanup
Command: npx skills add https://github.com/D0NMEGA/donnyclaude --skill gsd-cleanup-d0nmega

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive completed milestone phase directories from past milestones into .planning/milestones/v{X.Y}-phases/ to keep project planning tidy and preserve historical context, preventing clutter from completed work.

Core Features & Use Cases

  • Detects completed milestones in .planning/phases/ and generates a dry-run summary.
  • Archives milestone phase directories into .planning/milestones/v{X.Y}-phases/ upon confirmation.
  • Supports repeatable cleanup workflows in automated environments.

Quick Start

Run the cleanup workflow to identify completed milestones, preview the changes, and perform the archival when confirmed.

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 completed milestone phase directories in my planning workflow?

To clean up completed milestone phase directories, this Skill archives them from .planning/phases/ into .planning/milestones/v{X.Y}-phases/ to preserve historical context. It first performs a safe dry-run and requires explicit confirmation before moving any directories.

What is the best way to archive old milestone phases without losing planning history?

Archiving old milestone phases safely involves moving completed directories into a structured milestones path. This Skill preserves planning history by relocating phase directories into .planning/milestones/ after a dry-run summary and confirmation step.

Can I preview milestone cleanup changes before moving files?

Yes, you can preview milestone cleanup changes using the dry-run feature. The Skill detects completed milestones in .planning/phases/ and generates a dry-run summary, allowing you to review pending archival actions before confirming any directory moves.

How do I automate project planning cleanup for accumulated milestones?

You can automate project planning cleanup by running this repeatable workflow in automated environments. It enforces a confirmation step and archives accumulated milestone phase directories from .planning/phases/ to keep your workspace tidy.

When should I archive completed milestone phases from my planning directory?

You should archive completed milestone phases when milestones accumulate and clutter your .planning/phases/ directory. Archiving them into .planning/milestones/v{X.Y}-phases/ keeps project planning tidy while preserving historical context.

Does the milestone archival process require manual confirmation?

Yes, the milestone archival process enforces a confirmation step before moving any directories. After generating a dry-run summary of completed phases in .planning/phases/, the Skill waits for your explicit approval to execute the archival workflow.