gsd-cleanup

Archive completed milestone phase directories into versioned paths after dry-run confirmation.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/novatech2210-cmd/ImidusApp --skill gsd-cleanup-novatech2210-cmd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/novatech2210-cmd/ImidusApp/tree/main/.codex/skills/gsd-cleanup
Command: npx skills add https://github.com/novatech2210-cmd/ImidusApp --skill gsd-cleanup-novatech2210-cmd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive accumulated phase directories from completed milestones to keep planning repos tidy and reduce manual cleanup time.

Core Features & Use Cases

  • Dry-run capability to preview archives without making changes.
  • Archive completed milestone phases into a versioned path under .planning/milestones/v{X.Y}-phases/.
  • Require explicit user confirmation before performing archival to prevent accidental data loss.

Quick Start

Trigger the cleanup by mentioning gsd-cleanup and review the dry-run summary before confirming archival.

Frequently Asked Questions about gsd-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically archive completed project milestone phases?

To automatically archive completed project milestone phases, use a cleanup automation that moves phase directories into a versioned path like .planning/milestones/v{X.Y}-phases/. This process requires a dry-run preview and explicit user confirmation before moving any files.

What is a dry-run cleanup for milestone archiving?

A dry-run cleanup for milestone archiving is a preview mode that summarizes which completed phase directories will be moved without making actual changes. It ensures safe operation by requiring explicit user approval before performing the archival.

How do I keep planning directories tidy after finishing a milestone?

You can keep planning directories tidy by archiving accumulated phase directories from completed milestones. This moves them from .planning/phases into a versioned milestones folder, reducing manual cleanup time and maintaining a clean repository structure.

Can I preview milestone archiving before making permanent changes?

Yes, you can preview milestone archiving before making permanent changes by running a dry-run summary. This allows you to review exactly which completed phases will be archived, ensuring no data is lost before you provide explicit confirmation.

Does milestone archiving require manual confirmation before moving phase directories?

Yes, milestone archiving requires explicit user confirmation before moving phase directories. This safeguard prevents accidental data loss by ensuring the archival only happens after you review and approve the dry-run summary of the completed phases.