gsd-cleanup

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

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/hadpadrahul/school-erp --skill gsd-cleanup-hadpadrahul
Or copy as Structured Prompt for Agent
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.