qsd-cleanup

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

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/thecomputer07/qsd --skill qsd-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qsd-cleanup
Source: https://github.com/thecomputer07/qsd/tree/main/skills/qsd-cleanup
Command: npx skills add https://github.com/thecomputer07/qsd --skill qsd-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive phase directories from completed milestones into .planning/milestones/v{X.Y}-phases/ to keep the planning workspace organized.

Use when .planning/phases/ has accumulated directories from past milestones.

Core Features & Use Cases

  • Automated dry-run previews identify what would be archived without making changes.
  • Safe archival of milestone phases into a versioned destination to preserve history.
  • Use Case: After several milestones, run cleanup to consolidate phases into the milestones archive, reducing clutter while maintaining traceability.

Quick Start

Run the cleanup workflow to archive completed milestone phase directories.

Frequently Asked Questions about qsd-cleanup

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

FAQPage Schema
How do I archive completed milestone phase directories to keep my planning workspace organized?

To archive completed milestone phases, this Skill identifies directories in .planning/phases/ and consolidates them into .planning/milestones/v{X.Y}-phases/. It first generates a dry-run summary, then archives only after explicit confirmation to ensure safe operations and traceability.

What is a dry-run preview for milestone phase archival and why is it needed?

A dry-run preview for milestone phase archival shows exactly which directories will be moved before any changes occur. This safety mechanism prevents accidental data loss by requiring explicit confirmation to proceed with moving completed phases into the versioned milestones archive.

When should I clean up and archive milestone phases from my planning directory?

You should clean up and archive milestone phases when .planning/phases/ has accumulated directories from past milestones. Archiving consolidates these completed phases into a versioned destination, reducing clutter while preserving historical traceability.

Can I automatically move planning phase directories without manual confirmation?

No, this archival workflow requires explicit confirmation before moving any planning phase directories. It generates a dry-run summary of pending changes first, ensuring you can verify the targeted phases before the automated archival executes.

Does this milestone cleanup workflow preserve the history of archived phases?

Yes, the milestone cleanup workflow preserves history by archiving phase directories into a versioned destination at .planning/milestones/v{X.Y}-phases/. It also logs all archival actions for full traceability of the consolidated planning data.