Prompt file imported from PauloHYBEX/Nexus-TCMS (.windsurf/workflows/cleanup.md). Copyright stays with the author.

Cleanup

Name: cleanup
Author: PauloHYBEX

Archive phase directories from completed milestones into .planning/milestones/[version]-phases/. Keeps .planning/phases/ focused on the current milestone only.

Usage: cleanup

Step 1: Find Completed Milestones

cat .planning/milestones/MILESTONES.md 2>/dev/null || ls .planning/milestones/ 2>/dev/null

Read .planning/MILESTONES.md (or list .planning/milestones/) to identify completed milestones and their versions.

Extract each milestone version (e.g., v1.0, v1.1, v2.0).

Check which milestone archive directories already exist:

ls -d .planning/milestones/v*-phases 2>/dev/null

Filter to milestones that do NOT already have a -phases archive directory. These are the ones needing cleanup.

If all milestones already have phase archives:

All completed milestones already have phase directories archived.
Nothing to clean up.

Stop.

Step 2: Determine Phase Membership

For each completed milestone without a -phases archive, find which phases belong to it.

Read the archived ROADMAP snapshot for that milestone:

cat ".planning/milestones/[version]-ROADMAP.md" 2>/dev/null

Extract phase numbers and names from the archived roadmap.

Check which of those phase directories still exist in .planning/phases/:

ls -d .planning/phases/*/ 2>/dev/null

Match phase directories to milestone membership. Only include directories that still exist.

Step 3: Show Dry-Run Summary

Cleanup Summary

v[X.Y] — [Milestone Name]
Phase directories to archive:
- 01-foundation/
- 02-auth/
- 03-core-features/
Destination: .planning/milestones/v[X.Y]-phases/

v[X.Z] — [Milestone Name]
Phase directories to archive:
- 04-security/
- 05-hardening/
Destination: .planning/milestones/v[X.Z]-phases/

---

Proceed with archiving? (yes/no)

Wait for confirmation. If "no": stop.

Step 4: Archive Phase Directories

For each milestone and its phase directories:

node -e "require('fs').mkdirSync('.planning/milestones/v[X.Y]-phases',{recursive:true})"
mv ".planning/phases/[phase-dir]/" ".planning/milestones/v[X.Y]-phases/"

Repeat for all milestones in the cleanup set.

Step 5: Commit

git add .planning/milestones/ .planning/phases/
git commit -m "chore: archive phase dirs from completed milestones"

Step 6: Report

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 learnship ► CLEANUP COMPLETE ✓
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Archived:
- v[X.Y]: [N] phase directories → .planning/milestones/v[X.Y]-phases/

.planning/phases/ now contains only current milestone phases.

# Cleanup Archive phase directories from completed milestones into `.planning/milestones/[version]-phases/`. Keeps `.planning/phases/` focused on the current milestone only. **Usage:** `cleanup` ## Step 1: Find Completed Milestones ```bash cat .planning/milestones/MILESTONES.md 2>/dev/null || ls .planning/milestones/ 2>/dev/null ``` Read `.planning/MILESTONES.md` (or list `.planning/milestones/`) to identify completed milestones and their versions. Extract each milestone version (e.g., `v1.0`, `v1.1`, `v2.0`). Check which milestone archive directories already exist: ```bash ls -d .planning/milestones/v*-phases 2>/dev/null ``` Filter to milestones that do NOT already have a `-phases` archive directory. These are the ones needing cleanup. If all milestones already have phase archives: ``` All completed milestones already have phase directories archived. Nothing to clean up. ``` Stop. ## Step 2: Determine Phase Membership For each completed milestone without a `-phases` archive, find which phases belong to it. Read the archived ROADMAP snapshot for that milestone: ```bash cat ".planning/milestones/[version]-ROADMAP.md" 2>/dev/null ``` Extract phase numbers and names from the archived roadmap. Check which of those phase directories still exist in `.planning/phases/`: ```bash ls -d .planning/phases/*/ 2>/dev/null ``` Match phase directories to milestone membership. Only include directories that still exist. ## Step 3: Show Dry-Run Summary ``` Cleanup Summary v[X.Y] — [Milestone Name] Phase directories to archive: - 01-foundation/ - 02-auth/ - 03-core-features/ Destination: .planning/milestones/v[X.Y]-phases/ v[X.Z] — [Milestone Name] Phase directories to archive: - 04-security/ - 05-hardening/ Destination: .planning/milestones/v[X.Z]-phases/ --- Proceed with archiving? (yes/no) ``` Wait for confirmation. If "no": stop. ## Step 4: Archive Phase Directories For each milestone and its phase directories: ```bash node -e "require('fs').mkdirSync('.planning/milestones/v[X.Y]-phases',{recursive:true})" mv ".planning/phases/[phase-dir]/" ".planning/milestones/v[X.Y]-phases/" ``` Repeat for all milestones in the cleanup set. ## Step 5: Commit ```bash git add .planning/milestones/ .planning/phases/ git commit -m "chore: archive phase dirs from completed milestones" ``` ## Step 6: Report ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ learnship ► CLEANUP COMPLETE ✓ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Archived: - v[X.Y]: [N] phase directories → .planning/milestones/v[X.Y]-phases/ .planning/phases/ now contains only current milestone phases. ```

{ "prompt": "# Cleanup\n\nArchive phase directories from completed milestones into `.planning/milestones/[version]-phases/`. Keeps `.planning/phases/` focused on the current milestone only.\n\n**Usage:** `cleanup`\n\n## Step 1: Find Completed Milestones\n\n```bash\ncat .planning/milestones/MILESTONES.md 2>/dev/null || ls .planning/milestones/ 2>/dev/null\n```\n\nRead `.planning/MILESTONES.md` (or list `.planning/milestones/`) to identify completed milestones and their versions.\n\nExtract each milestone version (e.g., `v1.0`, `v1.1`, `v2.0`).\n\nCheck which milestone archive directories already exist:\n```bash\nls -d .planning/milestones/v*-phases 2>/dev/null\n```\n\nFilter to milestones that do NOT already have a `-phases` archive directory. These are the ones needing cleanup.\n\nIf all milestones already have phase archives:\n```\nAll completed milestones already have phase directories archived.\nNothing to clean up.\n```\nStop.\n\n## Step 2: Determine Phase Membership\n\nFor each completed milestone without a `-phases` archive, find which phases belong to it.\n\nRead the archived ROADMAP snapshot for that milestone:\n```bash\ncat \".planning/milestones/[version]-ROADMAP.md\" 2>/dev/null\n```\n\nExtract phase numbers and names from the archived roadmap.\n\nCheck which of those phase directories still exist in `.planning/phases/`:\n```bash\nls -d .planning/phases/*/ 2>/dev/null\n```\n\nMatch phase directories to milestone membership. Only include directories that still exist.\n\n## Step 3: Show Dry-Run Summary\n\n```\nCleanup Summary\n\nv[X.Y] — [Milestone Name]\nPhase directories to archive:\n- 01-foundation/\n- 02-auth/\n- 03-core-features/\nDestination: .planning/milestones/v[X.Y]-phases/\n\nv[X.Z] — [Milestone Name]\nPhase directories to archive:\n- 04-security/\n- 05-hardening/\nDestination: .planning/milestones/v[X.Z]-phases/\n\n---\n\nProceed with archiving? (yes/no)\n```\n\nWait for confirmation. If \"no\": stop.\n\n## Step 4: Archive Phase Directories\n\nFor each milestone and its phase directories:\n\n```bash\nnode -e \"require('fs').mkdirSync('.planning/milestones/v[X.Y]-phases',{recursive:true})\"\nmv \".planning/phases/[phase-dir]/\" \".planning/milestones/v[X.Y]-phases/\"\n```\n\nRepeat for all milestones in the cleanup set.\n\n## Step 5: Commit\n\n```bash\ngit add .planning/milestones/ .planning/phases/\ngit commit -m \"chore: archive phase dirs from completed milestones\"\n```\n\n## Step 6: Report\n\n```\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n learnship ► CLEANUP COMPLETE ✓\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nArchived:\n- v[X.Y]: [N] phase directories → .planning/milestones/v[X.Y]-phases/\n\n.planning/phases/ now contains only current milestone phases.\n```", "variables": [], "notes": "Archive completed milestone phase directories to keep .planning/phases/ clean", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/PauloHYBEX/Nexus-TCMS", "path": ".windsurf/workflows/cleanup.md", "ref": "af66d4e66d7443d045e74bafc302cd998ceb5b99", "url": "https://github.com/PauloHYBEX/Nexus-TCMS/blob/af66d4e66d7443d045e74bafc302cd998ceb5b99/.windsurf/workflows/cleanup.md", "key": "PauloHYBEX/Nexus-TCMS/.windsurf/workflows/cleanup.md" } } }

cleanup

About

Cleanup

Step 1: Find Completed Milestones

Step 2: Determine Phase Membership

Step 3: Show Dry-Run Summary

Step 4: Archive Phase Directories

Step 5: Commit

Step 6: Report

Use it

Manifest

Reviews