gsd-cleanup

Archive completed phase directories into versioned milestone folders within .planning.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/nnexai/git-stacks --skill gsd-cleanup-nnexai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-cleanup
Source: https://github.com/nnexai/git-stacks/tree/main/.codex/skills/gsd-cleanup
Command: npx skills add https://github.com/nnexai/git-stacks --skill gsd-cleanup-nnexai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves the clutter caused by accumulated phase directories in the .planning/phases/ directory after project milestones are completed.

Core Features & Use Cases

  • Automated Archiving: Safely moves completed phase directories into a structured milestone-specific archive path.
  • Dry-Run Safety: Provides a summary of actions before performing any file system modifications.
  • Use Case: After finishing a major project phase, use this skill to clean up your workspace and move old phase logs and artifacts into the designated .planning/milestones/vX.Y-phases/ directory.

Quick Start

Invoke the gsd-cleanup skill to archive all phase directories from completed milestones in the current project.

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 after finishing a project milestone?

To archive completed phase directories, this skill moves accumulated folders from the .planning/phases/ directory into a versioned milestone path. It maintains workspace hygiene by safely relocating old phase logs and artifacts into .planning/milestones/vX.Y-phases/.

What is the best way to clean up .planning directory clutter from completed milestones?

The best way to clean up .planning directory clutter is automated archiving, which safely moves completed phase directories into a structured, milestone-specific archive path. This preserves historical record integrity while removing workspace debris.

Can I preview file system modifications before archiving phase directories?

Yes, you can preview file system modifications using the dry-run safety feature. It provides a summary of actions before performing any file system move operations, ensuring you verify the archiving plan before execution.

Does the milestone archiving process require specific execution context access?

Yes, the milestone archiving process requires execution context access to the project root and the ability to perform file system move operations. This ensures the skill can accurately locate and relocate the .planning directory structure.

When should I archive phase directories into milestone folders?

You should archive phase directories into milestone folders after finishing a major project phase. This prevents clutter from accumulated phase logs and artifacts in the .planning/phases/ directory once a milestone is completed.

How does versioning work for archived milestone phase directories?

Versioning for archived milestone phase directories works by moving completed folders into a designated .planning/milestones/vX.Y-phases/ directory. This structured path maintains historical record integrity and separates completed work by version.