refactor: unify milestone flow, remove deprecated commands

Consolidate /gsd:new-milestone to mirror /gsd:new-project:
- questioning → research (optional) → requirements → roadmap

BREAKING CHANGES:
- Remove /gsd:discuss-milestone (consolidated into new-milestone)
- Remove /gsd:create-roadmap (integrated into project/milestone flows)
- Remove /gsd:define-requirements (integrated into project/milestone flows)
- Remove /gsd:research-project (integrated into project/milestone flows)

Deleted files:
- commands/gsd/{discuss-milestone,create-roadmap,define-requirements,research-project}.md
- get-shit-done/workflows/{discuss-milestone,create-roadmap,define-requirements}.md
- get-shit-done/templates/milestone-context.md

Updated references in:
- progress.md, complete-milestone.md, help.md
- complete-milestone workflow, continuation-format.md
- questioning.md, requirements.md template, SUMMARY.md template
- gsd-project-researcher.md, gsd-roadmapper.md
- README.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
2026-01-17 00:28:41 -06:00
parent 54f2d5600b
commit c54071ccb8
21 changed files with 736 additions and 2199 deletions

View File

@@ -1,6 +1,6 @@
---
name: gsd-project-researcher
description: Researches domain ecosystem before roadmap creation. Produces multiple files in .planning/research/ consumed by /gsd:create-roadmap. Spawned by /gsd:research-project orchestrator.
description: Researches domain ecosystem before roadmap creation. Produces files in .planning/research/ consumed during roadmap creation. Spawned by /gsd:new-project or /gsd:new-milestone orchestrators.
tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*
color: cyan
---
@@ -10,9 +10,10 @@ You are a GSD project researcher. You research the domain ecosystem before roadm
You are spawned by:
- `/gsd:research-project` orchestrator (project-wide research before roadmap)
- `/gsd:new-project` orchestrator (Phase 6: Research)
- `/gsd:new-milestone` orchestrator (Phase 6: Research)
Your job: Answer "What does this domain ecosystem look like?" Produce multiple research files that inform roadmap creation.
Your job: Answer "What does this domain ecosystem look like?" Produce research files that inform roadmap creation.
**Core responsibilities:**
- Survey the domain ecosystem broadly
@@ -25,7 +26,7 @@ Your job: Answer "What does this domain ecosystem look like?" Produce multiple r
</role>
<downstream_consumer>
Your research files are consumed by `/gsd:create-roadmap` which uses them to:
Your research files are consumed during roadmap creation:
| File | How Roadmap Uses It |
|------|---------------------|
@@ -807,7 +808,7 @@ When research finishes successfully:
### Ready for Roadmap
Research complete. Run `/gsd:create-roadmap` to create phase structure.
Research complete. Proceeding to roadmap creation.
```
## Research Blocked

View File

@@ -286,114 +286,23 @@ After roadmap creation, REQUIREMENTS.md gets updated with phase mappings:
## ROADMAP.md Structure
```markdown
# Roadmap
Use template from `~/.claude/get-shit-done/templates/roadmap.md`.
**Project:** [name]
**Created:** [date]
**Phases:** [N]
## Overview
[2-3 sentences describing the roadmap approach]
## Phases
### Phase 1: [Name]
**Goal:** [What this phase delivers - outcome, not task]
**Depends on:** Nothing (first phase)
**Requirements:** [REQ-IDs]
**Success Criteria:**
1. [Observable user behavior]
2. [Observable user behavior]
3. [Observable user behavior]
**Plans:** (created by /gsd:plan-phase)
---
### Phase 2: [Name]
**Goal:** [Outcome]
**Depends on:** Phase 1
**Requirements:** [REQ-IDs]
**Success Criteria:**
1. [Observable user behavior]
2. [Observable user behavior]
---
[... more phases ...]
## Progress
| Phase | Status | Completed |
|-------|--------|-----------|
| 1 - [Name] | Not started | — |
| 2 - [Name] | Not started | — |
| 3 - [Name] | Not started | — |
---
*Roadmap for milestone: v1.0*
```
Key sections:
- Overview (2-3 sentences)
- Phases with Goal, Dependencies, Requirements, Success Criteria
- Progress table
## STATE.md Structure
```markdown
# Project State
Use template from `~/.claude/get-shit-done/templates/state.md`.
## Project Reference
See: .planning/PROJECT.md
**Core value:** [from PROJECT.md]
**Current focus:** Phase 1 — [name]
## Current Position
Phase: 1 of [N] ([name])
Plan: Not started
Status: Ready to plan
Last activity: [date] — Project initialized
Progress: ░░░░░░░░░░ 0%
## Performance Metrics
**Velocity:**
- Total plans completed: 0
- Average duration: —
**By Phase:**
| Phase | Plans | Total | Avg/Plan |
|-------|-------|-------|----------|
| — | — | — | — |
## Accumulated Context
### Decisions
(None yet)
### Pending Todos
(None yet)
### Blockers/Concerns
(None yet)
## Session Continuity
Last session: [date]
Stopped at: Project initialization
Resume file: None
```
Key sections:
- Project Reference (core value, current focus)
- Current Position (phase, plan, status, progress bar)
- Performance Metrics
- Accumulated Context (decisions, todos, blockers)
- Session Continuity
## Draft Presentation Format