diff --git a/commands/gsd/audit-milestone.md b/commands/gsd/audit-milestone.md index 66aea1a55..227023182 100644 --- a/commands/gsd/audit-milestone.md +++ b/commands/gsd/audit-milestone.md @@ -100,9 +100,9 @@ For each requirement in REQUIREMENTS.md mapped to this milestone: - Check phase verification status - Determine: satisfied | partial | unsatisfied -## 6. Aggregate into MILESTONE-AUDIT.md +## 6. Aggregate into v{version}-MILESTONE-AUDIT.md -Create `.planning/MILESTONE-AUDIT.md` with: +Create `.planning/v{version}-v{version}-MILESTONE-AUDIT.md` with: ```yaml --- @@ -149,7 +149,7 @@ Route by status (see ``). ## ✓ Milestone {version} — Audit Passed **Score:** {N}/{M} requirements satisfied -**Report:** .planning/MILESTONE-AUDIT.md +**Report:** .planning/v{version}-MILESTONE-AUDIT.md All requirements covered. Cross-phase integration verified. E2E flows complete. @@ -172,7 +172,7 @@ All requirements covered. Cross-phase integration verified. E2E flows complete. ## ⚠ Milestone {version} — Gaps Found **Score:** {N}/{M} requirements satisfied -**Report:** .planning/MILESTONE-AUDIT.md +**Report:** .planning/v{version}-MILESTONE-AUDIT.md ### Unsatisfied Requirements @@ -203,7 +203,7 @@ All requirements covered. Cross-phase integration verified. E2E flows complete. --- **Also available:** -- `cat .planning/MILESTONE-AUDIT.md` — see full report +- `cat .planning/v{version}-MILESTONE-AUDIT.md` — see full report - `/gsd:complete-milestone {version}` — proceed anyway (accept tech debt) ``` @@ -215,7 +215,7 @@ All requirements covered. Cross-phase integration verified. E2E flows complete. ## ⚡ Milestone {version} — Tech Debt Review **Score:** {N}/{M} requirements satisfied -**Report:** .planning/MILESTONE-AUDIT.md +**Report:** .planning/v{version}-MILESTONE-AUDIT.md All requirements met. No critical blockers. Accumulated tech debt needs review. @@ -249,6 +249,6 @@ All requirements met. No critical blockers. Accumulated tech debt needs review. - [ ] All phase VERIFICATION.md files read - [ ] Tech debt and deferred gaps aggregated - [ ] Integration checker spawned for cross-phase wiring -- [ ] MILESTONE-AUDIT.md created +- [ ] v{version}-MILESTONE-AUDIT.md created - [ ] Results presented with actionable next steps diff --git a/commands/gsd/complete-milestone.md b/commands/gsd/complete-milestone.md index 0a6c81d24..ae8618b22 100644 --- a/commands/gsd/complete-milestone.md +++ b/commands/gsd/complete-milestone.md @@ -41,7 +41,7 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag 0. **Check for audit:** - - Look for `.planning/MILESTONE-AUDIT.md` + - Look for `.planning/v{{version}}-MILESTONE-AUDIT.md` - If missing or stale: recommend `/gsd:audit-milestone` first - If audit status is `gaps_found`: recommend `/gsd:plan-milestone-gaps` first - If audit status is `passed`: proceed to step 1 @@ -49,7 +49,7 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag ```markdown ## Pre-flight Check - {If no MILESTONE-AUDIT.md:} + {If no v{{version}}-MILESTONE-AUDIT.md:} ⚠ No milestone audit found. Run `/gsd:audit-milestone` first to verify requirements coverage, cross-phase integration, and E2E flows. diff --git a/commands/gsd/plan-milestone-gaps.md b/commands/gsd/plan-milestone-gaps.md index a04804b2a..5f93830c8 100644 --- a/commands/gsd/plan-milestone-gaps.md +++ b/commands/gsd/plan-milestone-gaps.md @@ -25,7 +25,7 @@ One command creates all fix phases — no manual `/gsd:add-phase` per gap. **Audit results:** -@.planning/MILESTONE-AUDIT.md +Glob: .planning/v*-MILESTONE-AUDIT.md (use most recent) **Original intent (for prioritization):** @.planning/PROJECT.md @@ -41,7 +41,8 @@ One command creates all fix phases — no manual `/gsd:add-phase` per gap. ## 1. Load Audit Results ```bash -cat .planning/MILESTONE-AUDIT.md +# Find the most recent audit file +ls -t .planning/v*-MILESTONE-AUDIT.md 2>/dev/null | head -1 ``` Parse YAML frontmatter to extract structured gaps: @@ -49,7 +50,7 @@ Parse YAML frontmatter to extract structured gaps: - `gaps.integration` — missing cross-phase connections - `gaps.flows` — broken E2E flows -If MILESTONE-AUDIT.md doesn't exist or has no gaps, error: +If no audit file exists or has no gaps, error: ``` No audit gaps found. Run `/gsd:audit-milestone` first. ``` diff --git a/get-shit-done/workflows/complete-milestone.md b/get-shit-done/workflows/complete-milestone.md index 629376246..680870c48 100644 --- a/get-shit-done/workflows/complete-milestone.md +++ b/get-shit-done/workflows/complete-milestone.md @@ -532,6 +532,24 @@ Archive requirements and prepare for fresh requirements in next milestone. + + +Move the milestone audit file to the archive (if it exists): + +```bash +# Move audit to milestones folder (if exists) +[ -f .planning/v[X.Y]-MILESTONE-AUDIT.md ] && mv .planning/v[X.Y]-MILESTONE-AUDIT.md .planning/milestones/ +``` + +Confirm: +``` +✅ Audit archived to milestones/v[X.Y]-MILESTONE-AUDIT.md +``` + +(Skip silently if no audit file exists — audit is optional) + + + Update STATE.md to reflect milestone completion. @@ -606,6 +624,7 @@ Commit milestone completion including archive files and deletions. # Stage archive files (new) git add .planning/milestones/v[X.Y]-ROADMAP.md git add .planning/milestones/v[X.Y]-REQUIREMENTS.md +git add .planning/milestones/v[X.Y]-MILESTONE-AUDIT.md 2>/dev/null || true # Stage updated files git add .planning/MILESTONES.md @@ -622,6 +641,7 @@ chore: complete v[X.Y] milestone Archived: - milestones/v[X.Y]-ROADMAP.md - milestones/v[X.Y]-REQUIREMENTS.md +- milestones/v[X.Y]-MILESTONE-AUDIT.md (if audit was run) Deleted (fresh for next milestone): - ROADMAP.md