gsd-cleanup

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

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/onelee85/my-skills --skill gsd-cleanup-onelee85
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/onelee85/my-skills/tree/main/gsd-cleanup
Command: npx skills add https://github.com/onelee85/my-skills --skill gsd-cleanup-onelee85

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive the accumulated phase directories from completed milestones to organize planning history and reclaim space.

Core Features & Use Cases

  • Automated identification of completed milestone phases.
  • Dry-run preview before archiving to prevent data loss.
  • Safe archival move to .planning/milestones/v{X.Y}-phases/ with optional manual confirmation.

Quick Start

Run the cleanup workflow to archive completed milestone phases into the target planning directory.

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 to organize planning history?

Archiving completed milestone phase directories involves identifying finished milestones and moving their data into .planning/milestones/v{X.Y}-phases/. A dry-run summary is shown first, ensuring data is archived safely only after user confirmation without any data loss.

What is the best way to automate moving completed milestone phases without losing data?

Automating milestone phase archival requires a dry-run preview to verify completed milestones before moving data. This approach prevents data loss by prompting for manual confirmation and safely transferring directories to the .planning/milestones/v{X.Y}-phases/ target.

Can I preview milestone archive operations before moving files?

Yes, you can preview milestone archive operations using a dry-run summary. The workflow identifies completed milestone phases and displays a dry-run preview, allowing you to verify the data before confirming the actual archival move to the target directory.

How does the milestone phase archival process verify completed milestones?

The milestone archival process verifies completed milestones by scanning for finished phase directories and aggregating them into a dry-run summary. It validates the milestones, prompts for user confirmation, and then moves the verified data into the archive.

Do I need to manually confirm before the workflow archives my milestone phase directories?

Yes, manual confirmation is required before the workflow archives your milestone phase directories. The process presents a dry-run summary of completed milestones and waits for your explicit confirmation to ensure safe archival without unexpected data loss.