gsd-cleanup

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

Updated Apr 22, 2026

Search Tags:#automation #workflow #planning #cleanup #milestones #archive #ops

Ready to run

npx skills add https://github.com/hadpadrahul/school-erp --skill gsd-cleanup-hadpadrahul

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/hadpadrahul/school-erp/tree/main/.codex/skills/gsd-cleanup
Command: npx skills add https://github.com/hadpadrahul/school-erp --skill gsd-cleanup-hadpadrahul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive accumulated phase directories from completed milestones to keep planning directories organized and reduce clutter.

Core Features & Use Cases

Automated detection of completed milestones and their phase directories.
Safe, reversible dry-run summaries prior to archiving.
Final archival into .planning/milestones/v{X.Y}-phases/ with a confirmation step.

Quick Start

Archive completed milestone phases by invoking the cleanup with the dry-run option and confirm when ready to move files.

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 workflow?▼

To archive completed milestone phase directories, invoke the cleanup automation with the dry-run option to generate a summary, then confirm to move files into .planning/milestones/v{X.Y}-phases/.

Can I preview phase directory changes before archiving past milestones?▼

Yes, you can preview phase directory archiving by running the cleanup in dry-run mode, which generates a safe summary of completed milestones and their phase directories before moving any files.

What is the best way to organize cluttered .planning/phases/ directories?▼

The best way to organize cluttered .planning/phases/ directories is using automated milestone cleanup to detect completed phases and archive them into .planning/milestones/v{X.Y}-phases/ with user confirmation.

Does the milestone archive cleanup require manual file moving?▼

No, the milestone archive cleanup does not require manual file moving; it automatically identifies completed milestones and moves their phase directories after you review the dry-run summary and confirm.

When should I run milestone phase archiving in my ops workflow?▼

You should run milestone phase archiving when your .planning/phases/ directory has accumulated directories from past milestones, requiring a dry-run summary and user confirmation before archiving to reduce clutter.

Is the milestone phase archive process reversible?▼

Yes, the milestone phase archive process is reversible because it requires a dry-run summary and user confirmation before moving directories into .planning/milestones/v{X.Y}-phases/, ensuring safe archival.