Before completion, GSD checks for milestone audit:
1
Check for Audit
Looks for .planning/v{version}-MILESTONE-AUDIT.md
2
Audit Status
No Audit
Gaps Found
Passed
Copy
Ask AI
⚠ No milestone audit found.Run `/gsd:audit-milestone` first to verify:- Requirements coverage- Cross-phase integration- End-to-end flowsProceed anyway? (yes/no)
Copy
Ask AI
⚠ Milestone audit found gaps:- REQ-008: Email notifications not implemented- Integration: Dashboard doesn't load user dataOptions:1. /gsd:plan-milestone-gaps - Create phases to close gaps2. Proceed anyway - Accept as tech debtWhat would you like to do?
Copy
Ask AI
✓ Milestone audit passedAll requirements covered:- REQ-001 through REQ-010 ✓- Cross-phase integration verified ✓- E2E flows working ✓Proceeding with completion...
Reads all SUMMARY.md files and extracts key deliverables:
Copy
Ask AI
🎯 Key Accomplishments1. User authentication with email/password2. Activity dashboard with filtering and search3. Real-time updates via WebSocket4. Settings page with profile customization5. Dark mode support6. Comprehensive test coverage (94%)Approve these accomplishments? (yes/edit)
4
Archive Roadmap
Creates .planning/milestones/v1.0-ROADMAP.md with full phase details:
Copy
Ask AI
# Milestone v1.0: Initial Release**Status:** COMPLETE**Completed:** 2024-03-06## Scope4 phases, 12 plans, 47 tasks## Phases### Phase 1: Database Schema**Goal:** Set up data models and migrations**Requirements:** REQ-001, REQ-002**Status:** ✓ Complete[Full details for all phases...]
Creates .planning/milestones/v1.0-REQUIREMENTS.md with final status:
Copy
Ask AI
# v1.0 Requirements## v1 Requirements (Delivered)- [x] REQ-001: User registration and login- [x] REQ-002: Activity tracking and display- [x] REQ-003: User settings and preferences...## v2 Requirements (Deferred)- [ ] REQ-011: OAuth social login- [ ] REQ-012: Email notifications...## Outcomes- All v1 requirements delivered- 2 requirements adjusted during development- 3 v2 requirements moved to next milestone
Deletes .planning/REQUIREMENTS.md (will be recreated for next milestone)
6
Update PROJECT.md
Adds “Current State” section:
Copy
Ask AI
## Current State**Version:** 1.0 (Shipped 2024-03-06)Delivered:- User authentication system- Activity dashboard with real-time updates- User profile and settings- Dark mode support## Next Milestone Goalsv1.1 will focus on:- Email notifications- Team collaboration features- Advanced filtering and analytics
If v1.1+, archives previous content in <details> tags.
7
Commit and Tag
Copy
Ask AI
git add .planning/milestones/ .planning/PROJECT.md .planning/ROADMAP.md .planning/STATE.mdgit commit -m "chore: archive v1.0 milestone"git tag -a v1.0 -m "v1.0: Initial Release- User authentication- Activity dashboard- Settings and profile- Dark mode support"
Copy
Ask AI
✓ Milestone v1.0 complete✓ Tagged as v1.0Push tag to remote? (yes/no)
New milestone follows the same flow as new-project, but for existing codebases:
1
Questioning
Deep conversation about what you want to build next:
Copy
Ask AI
🎯 New Milestone: v1.1Your project currently has:- User authentication- Activity dashboard- Settings and profileWhat do you want to add in v1.1?> I want to add email notifications for important eventsWhat types of events should trigger notifications?> When someone mentions you, when your post gets liked, when you get a new followerHow should users control notification preferences?> In settings - they can enable/disable each type, plus set digest frequency[Conversation continues until complete understanding...]
2
Research (Optional)
Copy
Ask AI
Would you like domain research for this milestone?Research will investigate:- Email service providers (SendGrid, Mailgun, etc.)- Notification patterns and best practices- Queue systems for reliable delivery- Anti-spam and delivery optimizationRun research? (yes/no)> yesSpawning research agents...
Research is especially valuable when adding unfamiliar features to an existing project.
3
Requirements
Copy
Ask AI
📋 v1.1 Requirements## v1 Requirements (This Milestone)- [ ] REQ-011: Users can enable/disable notification types- [ ] REQ-012: Email sent when user is mentioned- [ ] REQ-013: Email sent when post is liked- [ ] REQ-014: Email sent for new followers- [ ] REQ-015: Digest mode (daily/weekly summaries)- [ ] REQ-016: One-click unsubscribe from emails## v2 Requirements (Future)- [ ] REQ-017: In-app notification center- [ ] REQ-018: Push notifications (mobile)- [ ] REQ-019: SMS notificationsApprove these requirements? (yes/edit)
4
Roadmap
Copy
Ask AI
🗺 v1.1 Roadmap### Phase 5: Notification System Core**Goal:** Database schema and notification service**Requirements:** REQ-011, REQ-015### Phase 6: Email Delivery**Goal:** Email sending with templates**Requirements:** REQ-012, REQ-013, REQ-014, REQ-016### Phase 7: Settings Integration**Goal:** User controls in settings page**Requirements:** REQ-011, REQ-015Note: Phase numbering continues from previous milestoneApprove roadmap? (yes/edit)
Phase numbers continue sequentially across milestones. v1.1 starts where v1.0 ended.
✓ Files created:- .planning/research/ (if research enabled)- .planning/REQUIREMENTS.md (v1.1 requirements)- .planning/ROADMAP.md (updated with v1.1 phases)- .planning/STATE.md (reset for new work)✓ Committed changesReady to start building:- /gsd:discuss-phase 5 - Capture implementation preferences- /gsd:plan-phase 5 - Research and plan first phase
