shine-cleanup

Archive completed milestone phase directories into centralized planning archive paths.

1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/diShine-digital-agency/SHINE-Code-System --skill shine-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shine-cleanup
Source: https://github.com/diShine-digital-agency/SHINE-Code-System/tree/main/skills/shine-cleanup
Command: npx skills add https://github.com/diShine-digital-agency/SHINE-Code-System --skill shine-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive completed milestone phase directories from active planning folders into the centralized archive path (.planning/milestones/v{X.Y}-phases/), reducing clutter.

Core Features & Use Cases

  • Identify completed milestones in .planning/phases/ and prepare them for archival.
  • Dry-run preview to show what will be moved without making changes.
  • Archive confirmed directories into .planning/milestones/v{X.Y}-phases/ and update references.

Quick Start

Run the cleanup toarchive completed milestone phases into .planning/milestones/v{X.Y}-phases/.

Frequently Asked Questions about shine-cleanup

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

FAQPage Schema
How do I archive completed milestone phase directories to reduce planning clutter?

To archive completed milestone phases, run the cleanup workflow to identify completed directories in .planning/phases/ and move them into .planning/milestones/v{X.Y}-phases/. It performs a dry-run summary first and archives on confirmation.

Can I preview what milestone directories will be moved before making changes?

Yes, you can preview directory archival using the dry-run summary. It identifies completed milestones in your planning space and shows exactly what will be moved to the archive path without making any actual changes.

What is the best way to automate milestone cleanup in a project planning workflow?

Automate milestone cleanup by following the workflow at @~/.claude/shine/workflows/cleanup.md. It identifies completed phases, generates a dry-run preview, and archives confirmed directories into a centralized path to reduce clutter.

Does the milestone archive process update references after moving directories?

Yes, the milestone archive process updates references. After confirming the dry-run summary, it moves completed phase directories into .planning/milestones/v{X.Y}-phases/ and updates references accordingly.

Do I need any external dependencies to run the planning space cleanup workflow?

No external dependencies are required. The cleanup workflow uses built-in tools including Read, Write, Bash, and AskUserQuestion to identify, preview, and archive completed milestone phases automatically.