Default flow: Research (if needed) → Plan → Verify → Done
Research-only mode (--research-phase <N>): Spawn gsd-phase-researcher for phase N, write RESEARCH.md, then exit before the planner runs. Useful for cross-phase research, doc review before committing to a planning approach, and correction-without-replanning loops where iterating on research alone is dramatically cheaper than re-spawning the planner. Replaces the deleted /gsd-research-phase command (#3042).
Research-only modifiers:
- No flag — when
RESEARCH.md already exists, prompt the user to choose update / view / skip.
--research — force-refresh: re-spawn the researcher unconditionally, no prompt. Skips the existing-RESEARCH.md menu.--view — view-only: print existing RESEARCH.md to stdout. Does not spawn the researcher. Cheapest mode for the correction-without-replanning loop. If no RESEARCH.md exists yet, errors with a hint to drop --view.
Orchestrator role: Parse arguments, validate phase, research domain (unless skipped), spawn gsd-planner, verify with gsd-plan-checker, iterate until pass or max iterations, present results.
Flags:
--research — Force re-research even if RESEARCH.md exists--skip-research — Skip research, go straight to planning--gaps — Gap closure mode (reads VERIFICATION.md, skips research)--skip-verify — Skip verification loop--prd <file> — Use a PRD/acceptance criteria file instead of discuss-phase. Parses requirements into CONTEXT.md automatically. Skips discuss-phase entirely.--ingest <path-or-glob> — Use one or more ADR files instead of discuss-phase. Parses locked decisions + scope fences into CONTEXT.md automatically. Skips discuss-phase entirely.--ingest-format <auto|nygard|madr|narrative> — Optional ADR parser format override (auto default).--reviews — Replan incorporating cross-AI review feedback from REVIEWS.md (produced by /gsd:review)--text — Use plain-text numbered lists instead of TUI menus (required for /rc remote sessions)--mvp — Vertical MVP mode. Planner organizes tasks as feature slices (UI→API→DB) instead of horizontal layers. On Phase 1 of a new project, also emits SKELETON.md (Walking Skeleton). Can be persisted on a phase via **Mode:** mvp in ROADMAP.md.
Normalize phase input in step 2 before any directory lookups.
1---2name: gsd-plan-phase3description: Create detailed phase plan (PLAN.md) with verification loop4---56<objective>7Create executable phase prompts (PLAN.md files) for a roadmap phase with integrated research and verification.89**Default flow:** Research (if needed) → Plan → Verify → Done1011**Research-only mode (`--research-phase <N>`):** Spawn `gsd-phase-researcher` for phase `N`, write `RESEARCH.md`, then exit before the planner runs. Useful for cross-phase research, doc review before committing to a planning approach, and correction-without-replanning loops where iterating on research alone is dramatically cheaper than re-spawning the planner. Replaces the deleted `/gsd-research-phase` command (#3042).1213**Research-only modifiers:**14- **No flag** — when `RESEARCH.md` already exists, prompt the user to choose `update / view / skip`.15- **`--research`** — force-refresh: re-spawn the researcher unconditionally, no prompt. Skips the existing-RESEARCH.md menu.16- **`--view`** — view-only: print existing `RESEARCH.md` to stdout. Does not spawn the researcher. Cheapest mode for the correction-without-replanning loop. If no `RESEARCH.md` exists yet, errors with a hint to drop `--view`.1718**Orchestrator role:** Parse arguments, validate phase, research domain (unless skipped), spawn gsd-planner, verify with gsd-plan-checker, iterate until pass or max iterations, present results.19</objective>2021<execution_context>22@$HOME/.claude/get-shit-done/workflows/plan-phase.md23@$HOME/.claude/get-shit-done/references/ui-brand.md24</execution_context>2526<runtime_note>27**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent — `vscode_askquestions` is the VS Code Copilot implementation of the same interactive question API. Do not skip questioning steps because `AskUserQuestion` appears unavailable; use `vscode_askquestions` instead.28</runtime_note>2930<context>31Phase number: $ARGUMENTS (optional — auto-detects next unplanned phase if omitted)3233**Flags:**34- `--research` — Force re-research even if RESEARCH.md exists35- `--skip-research` — Skip research, go straight to planning36- `--gaps` — Gap closure mode (reads VERIFICATION.md, skips research)37- `--skip-verify` — Skip verification loop38- `--prd <file>` — Use a PRD/acceptance criteria file instead of discuss-phase. Parses requirements into CONTEXT.md automatically. Skips discuss-phase entirely.39- `--ingest <path-or-glob>` — Use one or more ADR files instead of discuss-phase. Parses locked decisions + scope fences into CONTEXT.md automatically. Skips discuss-phase entirely.40- `--ingest-format <auto|nygard|madr|narrative>` — Optional ADR parser format override (`auto` default).41- `--reviews` — Replan incorporating cross-AI review feedback from REVIEWS.md (produced by `/gsd:review`)42- `--text` — Use plain-text numbered lists instead of TUI menus (required for `/rc` remote sessions)43- `--mvp` — Vertical MVP mode. Planner organizes tasks as feature slices (UI→API→DB) instead of horizontal layers. On Phase 1 of a new project, also emits `SKELETON.md` (Walking Skeleton). Can be persisted on a phase via `**Mode:** mvp` in ROADMAP.md.4445Normalize phase input in step 2 before any directory lookups.46</context>4748<process>49Execute end-to-end.50Preserve all workflow gates (validation, research, planning, verification loop, routing).51</process>
lgwanai