From 508e0c86cd747345315044375a8a2631835672e7 Mon Sep 17 00:00:00 2001 From: Lex Christopherson Date: Tue, 16 Dec 2025 08:12:02 -0600 Subject: [PATCH] fix: remove enterprise language from help and discuss-milestone MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update user-facing descriptions to reflect vision-focused workflow: - discuss-phase: captures vision, not constraints/risks - list-phase-assumptions: see Claude's plan, course-correct vision - discuss-milestone: features first, not scope/constraints 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- commands/gsd/discuss-milestone.md | 11 +++++------ commands/gsd/help.md | 20 ++++++++++---------- 2 files changed, 15 insertions(+), 16 deletions(-) diff --git a/commands/gsd/discuss-milestone.md b/commands/gsd/discuss-milestone.md index 960e4d295..8bb4046b6 100644 --- a/commands/gsd/discuss-milestone.md +++ b/commands/gsd/discuss-milestone.md @@ -3,9 +3,9 @@ description: Gather context for next milestone through adaptive questioning --- -Use adaptive questioning to gather comprehensive milestone context before creating a new milestone. +Help you figure out what to build in the next milestone through collaborative thinking. -Purpose: After completing a milestone, discuss the scope and focus of the next milestone before diving into phase creation. Builds understanding of goals, constraints, priorities, and lessons learned. +Purpose: After completing a milestone, explore what features you want to add, improve, or fix. Features first — scope and phases derive from what you want to build. Output: Context gathered, then routes to /gsd:new-milestone @@ -28,10 +28,9 @@ Output: Context gathered, then routes to /gsd:new-milestone 1. Verify previous milestone complete (or acknowledge active milestone) 2. Present context from previous milestone (accomplishments, phase count) 3. Follow discuss-milestone.md workflow: - - Ask about milestone theme/focus - - Ask about scope (estimated phases) - - Ask about constraints and priorities - - Ask about lessons from previous milestone + - Ask: "What do you want to add, improve, or fix?" + - Dig into features they mention + - Help them articulate what matters most - Present decision gate (ready / ask more / let me add context) 4. Hand off to /gsd:new-milestone with gathered context diff --git a/commands/gsd/help.md b/commands/gsd/help.md index d7dfc645f..de569e0e9 100644 --- a/commands/gsd/help.md +++ b/commands/gsd/help.md @@ -67,11 +67,11 @@ Usage: `/gsd:create-roadmap` ### Phase Planning **`/gsd:discuss-phase `** -Gather phase context through adaptive questioning before planning. +Help articulate your vision for a phase before planning. -- Builds understanding of objectives, constraints, risks -- Creates CONTEXT.md in phase directory -- Use before planning unfamiliar or complex phases +- Captures how you imagine this phase working +- Creates CONTEXT.md with your vision, essentials, and boundaries +- Use when you have ideas about how something should look/feel Usage: `/gsd:discuss-phase 2` @@ -86,10 +86,10 @@ Comprehensive ecosystem research for niche/complex domains. Usage: `/gsd:research-phase 3` **`/gsd:list-phase-assumptions `** -Surface Claude's assumptions about a phase before planning. +See what Claude is planning to do before it starts. -- Shows what Claude thinks about technical approach, scope, risks -- Enables early course correction before planning begins +- Shows Claude's intended approach for a phase +- Lets you course-correct if Claude misunderstood your vision - No files created - conversational output only Usage: `/gsd:list-phase-assumptions 3` @@ -141,10 +141,10 @@ Result: Creates Phase 7.1 ### Milestone Management **`/gsd:discuss-milestone`** -Gather context for next milestone through adaptive questioning. +Figure out what you want to build in the next milestone. -- Reviews previous milestone accomplishments -- Asks about scope, constraints, priorities for next milestone +- Reviews what shipped in previous milestone +- Helps you identify features to add, improve, or fix - Routes to /gsd:new-milestone when ready Usage: `/gsd:discuss-milestone`