gsd-cleanup

Archive completed milestone phase directories after dry-run review.

264|11|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/coco-research/coco --skill gsd-cleanup-coco-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/coco-research/coco/tree/main/systems/gsd/skills/gsd-cleanup
Command: npx skills add https://github.com/coco-research/coco --skill gsd-cleanup-coco-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes clutter from completed milestone work by organizing accumulated phase directories into archived milestone folders, making active planning areas easier to navigate and maintain.

Core Features & Use Cases

  • Milestone Cleanup: Identifies completed milestones whose phase directories can be safely archived.
  • Dry-Run Review: Presents a summary before any files are moved so you can confirm the cleanup plan.
  • Controlled Archiving: Moves finished phase directories into the appropriate milestone archive structure to preserve project history.
  • Use Case: After several iterations of a project, you can use this Skill to clear out old phase folders from .planning/phases/ without losing the record of what was completed.

Quick Start

Ask the Skill to scan your completed milestone phases, show a dry-run archive summary, and move the approved directories into the matching milestone archive folder.

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 phase directories from finished milestones in my planning workspace?

To archive completed phase directories, the Skill scans your .planning/phases/ directory for finished milestones and moves them into the appropriate milestone archive location. It requires a dry-run review and confirmation before moving any directories to preserve project history.

What is the best way to clean up old phase folders without losing the record of completed milestone work?

The best way to clean up old phase folders without losing records is controlled archiving. This process moves finished phase directories from .planning/phases/ into a matching milestone archive structure, ensuring the completed work is organized but preserved.

Can I preview which phase directories will be moved before running the milestone cleanup?

Yes, you can preview the milestone cleanup using the dry-run review feature. It presents a summary of the archive plan before any files are moved, allowing you to confirm that only completed phase directories are targeted.

Does the workspace cleanup process require confirmation before moving planning directories?

Yes, the workspace cleanup process requires confirmation gating. After the dry-run review presents the archive summary, you must explicitly approve the plan before the Skill safely moves any directories into the milestone archive.

When should I archive finished milestone phases in my project planning directory?

You should archive finished milestone phases when your .planning/phases/ directory has accumulated clutter from past iterations. Archiving organizes completed phase directories into milestone folders, making the active planning area easier to navigate and maintain.

What happens to project history when phase directories are moved into the milestone archive?

Project history is fully preserved when phase directories are moved. The controlled archiving process safely relocates finished directories into the appropriate milestone archive structure rather than deleting them, maintaining a clear record of what was completed.