gsd-cleanup

Archive completed milestone phase directories into versioned .planning paths.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/ev3rlit/magam-canonical-archive --skill gsd-cleanup-ev3rlit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/ev3rlit/magam-canonical-archive/tree/main/.codex/skills/gsd-cleanup
Command: npx skills add https://github.com/ev3rlit/magam-canonical-archive --skill gsd-cleanup-ev3rlit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archiving completed milestones into a dedicated history location helps keep active planning spaces lean and reduces clutter in live repositories.

Core Features & Use Cases

  • Automated archival workflow: identifies completed milestones and moves their phase directories to the designated path.
  • Dry-run preview: provides a summary of what would be archived before any changes.
  • Undo-ready and versioned storage: stores archived directories under .planning/milestones/v{X.Y}-phases/ for traceability.

Quick Start

Run the cleanup with $gsd-cleanup to perform a dry-run; after confirmation, the tool will archive matching milestone phase directories.

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 planning repository?▼

To archive completed milestone phase directories, you can run an automated cleanup workflow that moves them into a versioned .planning/milestones/v{X.Y}-phases/ location. This keeps active planning spaces lean and reduces clutter in live repositories.

Can I preview what will be archived before moving milestone folders?▼

Yes, you can preview what will be archived by running a dry-run summary before actual archiving. This safe confirmation workflow generates a summary of matching milestone phase directories so you can verify what would be moved.

What is the best way to organize versioned milestone archives?▼

The best way to organize versioned milestone archives is to move completed phase directories into a dedicated .planning/milestones/v{X.Y}-phases/ location. This provides traceability and ensures active planning spaces remain uncluttered.

How does automated milestone archival handle versioning for completed phases?▼

Automated milestone archival handles versioning by generating a versioned path and moving completed phase directories into .planning/milestones/v{X.Y}-phases/. This ensures archived milestones are stored with traceability and are undo-ready.

Do I need manual confirmation before the cleanup tool moves my milestone folders?▼

Yes, you need manual confirmation before the cleanup tool moves your milestone folders. After running the initial command, it provides a dry-run summary and requires a safe confirmation workflow to proceed with actual archiving.

Why should I archive completed milestones instead of leaving them in active directories?▼

You should archive completed milestones to keep active planning spaces lean and reduce clutter in live repositories. Moving phase directories to a dedicated history location ensures traceability without interfering with ongoing work.