From cfe237d4394c088c1467fee1701f972e6c297f15 Mon Sep 17 00:00:00 2001
From: Lex Christopherson <lex@glittercowboy.com>
Date: Fri, 16 Jan 2026 23:18:32 -0600
Subject: [PATCH] fix(routing): recommend discuss-phase before plan-phase in
 all next-step suggestions

Updated routing in:
- new-project.md
- create-roadmap.md (command and workflow)
- progress.md (routes B and C)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 commands/gsd/create-roadmap.md            | 4 ++--
 commands/gsd/new-project.md               | 9 +++++++--
 commands/gsd/progress.md                  | 8 ++++----
 get-shit-done/workflows/create-roadmap.md | 4 ++--
 4 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/commands/gsd/create-roadmap.md b/commands/gsd/create-roadmap.md
index 096da814a..b4f4399f0 100644
--- a/commands/gsd/create-roadmap.md
+++ b/commands/gsd/create-roadmap.md
@@ -109,14 +109,14 @@ Roadmap created:
 
 **Phase 1: [Name]** — [Goal from ROADMAP.md]
 
-`/gsd:plan-phase 1`
+`/gsd:discuss-phase 1` — gather context and clarify approach
 
 <sub>`/clear` first → fresh context window</sub>
 
 ---
 
 **Also available:**
-- `/gsd:discuss-phase 1` — gather context first
+- `/gsd:plan-phase 1` — skip discussion, plan directly
 - Review roadmap
 
 ---
diff --git a/commands/gsd/new-project.md b/commands/gsd/new-project.md
index 0518b14ec..17b2a2040 100644
--- a/commands/gsd/new-project.md
+++ b/commands/gsd/new-project.md
@@ -842,10 +842,15 @@ Present completion with next steps:
 
 **Phase 1: [Phase Name]** — [Goal from ROADMAP.md]
 
-`/gsd:plan-phase 1`
+`/gsd:discuss-phase 1` — gather context and clarify approach
 
 <sub>`/clear` first → fresh context window</sub>
 
+---
+
+**Also available:**
+- `/gsd:plan-phase 1` — skip discussion, plan directly
+
 ───────────────────────────────────────────────────────────────
 ```
 
@@ -887,7 +892,7 @@ Present completion with next steps:
 - [ ] STATE.md initialized
 - [ ] REQUIREMENTS.md traceability updated
 - [ ] Phase directories created → **committed**
-- [ ] User knows next step is `/gsd:plan-phase 1`
+- [ ] User knows next step is `/gsd:discuss-phase 1`
 
 **Atomic commits:** Each phase commits its artifacts immediately. If context is lost, artifacts persist.
 
diff --git a/commands/gsd/progress.md b/commands/gsd/progress.md
index 09a81c3cd..a86918d5b 100644
--- a/commands/gsd/progress.md
+++ b/commands/gsd/progress.md
@@ -193,14 +193,14 @@ Check if `{phase}-CONTEXT.md` exists in phase directory.
 
 **Phase {N}: {Name}** — {Goal from ROADMAP.md}
 
-`/gsd:plan-phase {phase}`
+`/gsd:discuss-phase {phase}` — gather context and clarify approach
 
 <sub>`/clear` first → fresh context window</sub>
 
 ---
 
 **Also available:**
-- `/gsd:discuss-phase {phase}` — gather context first
+- `/gsd:plan-phase {phase}` — skip discussion, plan directly
 - `/gsd:list-phase-assumptions {phase}` — see Claude's assumptions
 
 ---
@@ -266,15 +266,15 @@ Read ROADMAP.md to get the next phase's name and goal.
 
 **Phase {Z+1}: {Name}** — {Goal from ROADMAP.md}
 
-`/gsd:plan-phase {Z+1}`
+`/gsd:discuss-phase {Z+1}` — gather context and clarify approach
 
 <sub>`/clear` first → fresh context window</sub>
 
 ---
 
 **Also available:**
+- `/gsd:plan-phase {Z+1}` — skip discussion, plan directly
 - `/gsd:verify-work {Z}` — user acceptance test before continuing
-- `/gsd:discuss-phase {Z+1}` — gather context first
 
 ---
 ```
diff --git a/get-shit-done/workflows/create-roadmap.md b/get-shit-done/workflows/create-roadmap.md
index a552d3385..58ad4840a 100644
--- a/get-shit-done/workflows/create-roadmap.md
+++ b/get-shit-done/workflows/create-roadmap.md
@@ -577,14 +577,14 @@ Project initialized:
 
 **Phase 1: [Name]** — [Goal from ROADMAP.md]
 
-`/gsd:plan-phase 1`
+`/gsd:discuss-phase 1` — gather context and clarify approach
 
 <sub>`/clear` first → fresh context window</sub>
 
 ---
 
 **Also available:**
-- `/gsd:discuss-phase 1` — gather context first
+- `/gsd:plan-phase 1` — skip discussion, plan directly
 - Review roadmap
 
 ---