gsd-cleanup

Archive completed milestone directories from .planning/milestones/ using Bash commands.

Updated May 28, 2026
One-click install
npx skills add https://github.com/SensLiao/Claude-code-setting --skill gsd-cleanup-sensliao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/SensLiao/Claude-code-setting/tree/main/skills/gsd-cleanup
Command: npx skills add https://github.com/SensLiao/Claude-code-setting --skill gsd-cleanup-sensliao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of archiving completed milestone directories, ensuring a clean and organized .planning/milestones/ directory structure.

Core Features & Use Cases

  • Automated Directory Archiving: Archive phase directories from completed milestones into a designated folder.
  • Dry-Run Summary: Present a summary of the directories to be archived before final confirmation.
  • End-to-End Execution: Execute the entire process from identification to archiving, providing a complete solution for milestone cleanup.

Quick Start

Use the gsd-cleanup skill to archive all completed milestone directories.

Frequently Asked Questions about gsd-cleanup

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

FAQPage Schema
How do I automate milestone directory archiving in my project workflow?

Milestone directory archiving is automated by identifying completed phase directories in `.planning/milestones/` and moving them into a designated archived folder. This streamlines workflow management and maintains a clean project structure.

Can I preview directories before archiving completed milestones?

Yes, you can preview directories using the dry-run summary feature. It presents a summary of the completed milestone phase directories scheduled for archiving, requiring your final confirmation before executing any directory operations.

What's the best way to organize completed milestone directories without losing track of them?

The best way to organize completed milestones is end-to-end directory archiving. This process handles everything from identification to archiving, moving phase directories into a designated folder to keep your project workspace clean.

Do I need Bash command access to archive milestone directories?

Yes, you need Bash command access to execute directory operations. Archiving milestone directories requires the ability to run Bash commands for moving completed phase directories within the project structure.

When should I clean up my project milestone directories?

You should clean up project milestone directories when milestones are completed. Archiving these finished phase directories clears the `.planning/milestones/` workspace, ensuring efficient organization for active and upcoming tasks.