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.