Files
msd-core/commands/gsd/audit-milestone.md
Lex Christopherson 6630c3217d feat(milestone): add milestone audit system
- Add /gsd:audit-milestone command (spawns auditor)
- Add gsd-milestone-auditor agent (orchestrates verification)
- Add gsd-integration-checker agent (cross-phase wiring + E2E flows)
- Add /gsd:plan-milestone-gaps command (creates phases from audit gaps)
- Update complete-milestone to recommend audit first

Flow: audit-milestone → plan-milestone-gaps → execute phases → re-audit → complete-milestone

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:50:58 -06:00

3.1 KiB

name, description, argument-hint, allowed-tools
name description argument-hint allowed-tools
gsd:audit-milestone Audit milestone completion against original intent before archiving [version]
Read
Glob
Grep
Bash
Task
Verify milestone achieved its definition of done. Check requirements coverage, cross-phase integration, and end-to-end flows.

Spawns gsd-milestone-auditor to orchestrate parallel verification, then presents actionable results.

<execution_context> @~/.claude/get-shit-done/references/principles.md </execution_context>

Version: $ARGUMENTS (optional — defaults to current milestone)

Original Intent: @.planning/PROJECT.md @.planning/REQUIREMENTS.md

Planned Work: @.planning/ROADMAP.md @.planning/config.json (if exists)

Completed Work: Glob: .planning/phases//-SUMMARY.md Glob: .planning/phases//-VERIFICATION.md

1. **Determine milestone scope** - Parse version from arguments or detect current milestone from ROADMAP.md - Identify phases in this milestone - Extract milestone definition of done
  1. Spawn milestone auditor

    Task(
      prompt="Audit milestone {version} completion.
    
    Milestone scope: Phases {X}-{Y}
    Definition of done: {from ROADMAP.md}
    
    Check:
    1. Requirements coverage (all milestone REQs satisfied)
    2. Phase goal achievement (re-verify each phase)
    3. Cross-phase integration (wiring between phases)
    4. E2E flows (user can complete promised workflows)
    
    Create MILESTONE-AUDIT.md with structured gaps.",
      subagent_type="gsd-milestone-auditor"
    )
    
  2. Present results Route by status from MILESTONE-AUDIT.md:

    • passed → Ready for /gsd:complete-milestone
    • gaps_found → Present gaps, offer /gsd:plan-milestone-gaps

<offer_next> If passed:

## ✓ Milestone {version} — Audit Passed

**Score:** {N}/{M} requirements satisfied
**Report:** .planning/MILESTONE-AUDIT.md

All requirements covered. Cross-phase integration verified. E2E flows complete.

---

## ▶ Next Up

**Complete milestone** — archive and tag

`/gsd:complete-milestone {version}`

<sub>`/clear` first → fresh context window</sub>

If gaps_found:

## ⚠ Milestone {version} — Gaps Found

**Score:** {N}/{M} requirements satisfied
**Report:** .planning/MILESTONE-AUDIT.md

### Unsatisfied Requirements

{For each unsatisfied requirement:}
- **{REQ-ID}: {description}** (Phase {X})
  - {reason}

### Cross-Phase Issues

{For each integration gap:}
- **{from} → {to}:** {issue}

### Broken Flows

{For each flow gap:}
- **{flow name}:** breaks at {step}

---

## ▶ Next Up

**Plan gap closure** — create phases to complete milestone

`/gsd:plan-milestone-gaps`

<sub>`/clear` first → fresh context window</sub>

---

**Also available:**
- `cat .planning/MILESTONE-AUDIT.md` — see full report
- `/gsd:complete-milestone {version}` — proceed anyway (accept tech debt)

</offer_next>

<success_criteria>

  • Milestone scope identified
  • gsd-milestone-auditor spawned with full context
  • MILESTONE-AUDIT.md created
  • Results presented with actionable next steps </success_criteria>