get-shit-done-cc 1.5.28 → 1.5.30

package/agents/gsd-plan-checker.md

@@ -244,8 +244,9 @@ issue:
 Gather verification context from the phase directory and project state.
 
 ```bash
-# Phase directory (provided in prompt)
-PHASE_DIR=".planning/phases/${PHASE_ARG}"
+# Normalize phase and find directory
+PADDED_PHASE=$(printf "%02d" ${PHASE_ARG} 2>/dev/null || echo "${PHASE_ARG}")
+PHASE_DIR=$(ls -d .planning/phases/${PADDED_PHASE}-* .planning/phases/${PHASE_ARG}-* 2>/dev/null | head -1)
 
 # List all PLAN.md files
 ls "$PHASE_DIR"/*-PLAN.md 2>/dev/null

package/bin/install.js

@@ -55,8 +55,6 @@ function parseConfigDirArg() {
 const explicitConfigDir = parseConfigDirArg();
 const hasHelp = args.includes('--help') || args.includes('-h');
 const forceStatusline = args.includes('--force-statusline');
-const forceNotify = args.includes('--force-notify');
-const noNotify = args.includes('--no-notify');
 
 console.log(banner);
 
@@ -70,8 +68,6 @@ if (hasHelp) {
     ${cyan}-c, --config-dir <path>${reset}   Specify custom Claude config directory
     ${cyan}-h, --help${reset}                Show this help message
     ${cyan}--force-statusline${reset}        Replace existing statusline config
-    ${cyan}--force-notify${reset}            Replace existing notification hook
-    ${cyan}--no-notify${reset}               Skip notification hook installation
 
   ${yellow}Examples:${reset}
     ${dim}# Install to default ~/.claude directory${reset}
@@ -221,10 +217,6 @@ function install(isGlobal) {
       const srcFile = path.join(hooksSrc, entry);
       const destFile = path.join(hooksDest, entry);
       fs.copyFileSync(srcFile, destFile);
-      // Make shell scripts executable
-      if (entry.endsWith('.sh')) {
-        fs.chmodSync(destFile, 0o755);
-      }
     }
     console.log(`  ${green}✓${reset} Installed hooks`);
   }
@@ -233,14 +225,11 @@ function install(isGlobal) {
   const settingsPath = path.join(claudeDir, 'settings.json');
   const settings = readSettings(settingsPath);
   const statuslineCommand = isGlobal
-    ? '$HOME/.claude/hooks/statusline.sh'
-    : '.claude/hooks/statusline.sh';
+    ? 'node "$HOME/.claude/hooks/statusline.js"'
+    : 'node .claude/hooks/statusline.js';
   const updateCheckCommand = isGlobal
-    ? '$HOME/.claude/hooks/gsd-check-update.sh'
-    : '.claude/hooks/gsd-check-update.sh';
-  const notifyCommand = isGlobal
-    ? '$HOME/.claude/hooks/gsd-notify.sh'
-    : '.claude/hooks/gsd-notify.sh';
+    ? 'node "$HOME/.claude/hooks/gsd-check-update.js"'
+    : 'node .claude/hooks/gsd-check-update.js';
 
   // Configure SessionStart hook for update checking
   if (!settings.hooks) {
@@ -267,13 +256,13 @@ function install(isGlobal) {
     console.log(`  ${green}✓${reset} Configured update check hook`);
   }
 
-  return { settingsPath, settings, statuslineCommand, notifyCommand };
+  return { settingsPath, settings, statuslineCommand };
 }
 
 /**
- * Apply statusline and notification config, then print completion message
+ * Apply statusline config, then print completion message
  */
-function finishInstall(settingsPath, settings, statuslineCommand, notifyCommand, shouldInstallStatusline, shouldInstallNotify) {
+function finishInstall(settingsPath, settings, statuslineCommand, shouldInstallStatusline) {
   if (shouldInstallStatusline) {
     settings.statusLine = {
       type: 'command',
@@ -282,25 +271,6 @@ function finishInstall(settingsPath, settings, statuslineCommand, notifyCommand,
     console.log(`  ${green}✓${reset} Configured statusline`);
   }
 
-  if (shouldInstallNotify) {
-    if (!settings.hooks.Stop) {
-      settings.hooks.Stop = [];
-    }
-    // Remove any existing GSD notify hook first
-    settings.hooks.Stop = settings.hooks.Stop.filter(entry =>
-      !(entry.hooks && entry.hooks.some(h => h.command && h.command.includes('gsd-notify')))
-    );
-    settings.hooks.Stop.push({
-      hooks: [
-        {
-          type: 'command',
-          command: notifyCommand
-        }
-      ]
-    });
-    console.log(`  ${green}✓${reset} Configured completion notifications`);
-  }
-
   // Always write settings (hooks were already configured in install())
   writeSettings(settingsPath, settings);
 
@@ -365,66 +335,6 @@ function handleStatusline(settings, isInteractive, callback) {
   });
 }
 
-/**
- * Handle notification hook configuration with optional prompt
- */
-function handleNotifications(settings, isInteractive, callback) {
-  // Check if --no-notify flag was passed
-  if (noNotify) {
-    callback(false);
-    return;
-  }
-
-  // Check if GSD notify hook already exists
-  const hasExisting = settings.hooks?.Stop?.some(entry =>
-    entry.hooks && entry.hooks.some(h => h.command && h.command.includes('gsd-notify'))
-  );
-
-  // No existing - just install it
-  if (!hasExisting) {
-    callback(true);
-    return;
-  }
-
-  // Has existing and --force-notify flag
-  if (forceNotify) {
-    callback(true);
-    return;
-  }
-
-  // Has existing, non-interactive mode - skip
-  if (!isInteractive) {
-    console.log(`  ${yellow}⚠${reset} Skipping notifications (already configured)`);
-    console.log(`    Use ${cyan}--force-notify${reset} to replace\n`);
-    callback(false);
-    return;
-  }
-
-  // Has existing, interactive mode - prompt user
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  console.log(`
-  ${yellow}⚠${reset} Existing notification hook detected
-
-  GSD includes completion notifications that alert you when:
-    • A phase completes planning or execution
-    • Claude stops and needs your input
-    • Works on Mac, Linux, and Windows
-
-  ${cyan}1${reset}) Keep existing
-  ${cyan}2${reset}) Replace with GSD notifications
-`);
-
-  rl.question(`  Choice ${dim}[1]${reset}: `, (answer) => {
-    rl.close();
-    const choice = answer.trim() || '1';
-    callback(choice === '2');
-  });
-}
-
 /**
  * Prompt for install location
  */
@@ -448,12 +358,10 @@ function promptLocation() {
     rl.close();
     const choice = answer.trim() || '1';
     const isGlobal = choice !== '2';
-    const { settingsPath, settings, statuslineCommand, notifyCommand } = install(isGlobal);
+    const { settingsPath, settings, statuslineCommand } = install(isGlobal);
     // Interactive mode - prompt for optional features
     handleStatusline(settings, true, (shouldInstallStatusline) => {
-      handleNotifications(settings, true, (shouldInstallNotify) => {
-        finishInstall(settingsPath, settings, statuslineCommand, notifyCommand, shouldInstallStatusline, shouldInstallNotify);
-      });
+      finishInstall(settingsPath, settings, statuslineCommand, shouldInstallStatusline);
     });
   });
 }
@@ -466,20 +374,16 @@ if (hasGlobal && hasLocal) {
   console.error(`  ${yellow}Cannot use --config-dir with --local${reset}`);
   process.exit(1);
 } else if (hasGlobal) {
-  const { settingsPath, settings, statuslineCommand, notifyCommand } = install(true);
+  const { settingsPath, settings, statuslineCommand } = install(true);
   // Non-interactive - respect flags
   handleStatusline(settings, false, (shouldInstallStatusline) => {
-    handleNotifications(settings, false, (shouldInstallNotify) => {
-      finishInstall(settingsPath, settings, statuslineCommand, notifyCommand, shouldInstallStatusline, shouldInstallNotify);
-    });
+    finishInstall(settingsPath, settings, statuslineCommand, shouldInstallStatusline);
   });
 } else if (hasLocal) {
-  const { settingsPath, settings, statuslineCommand, notifyCommand } = install(false);
+  const { settingsPath, settings, statuslineCommand } = install(false);
   // Non-interactive - respect flags
   handleStatusline(settings, false, (shouldInstallStatusline) => {
-    handleNotifications(settings, false, (shouldInstallNotify) => {
-      finishInstall(settingsPath, settings, statuslineCommand, notifyCommand, shouldInstallStatusline, shouldInstallNotify);
-    });
+    finishInstall(settingsPath, settings, statuslineCommand, shouldInstallStatusline);
   });
 } else {
   promptLocation();

package/commands/gsd/audit-milestone.md

@@ -143,9 +143,12 @@ Route by status (see `<offer_next>`).
 </process>
 
 <offer_next>
+Output this markdown directly (not as a code block). Route based on status:
+
+---
+
 **If passed:**
 
-```markdown
 ## ✓ Milestone {version} — Audit Passed
 
 **Score:** {N}/{M} requirements satisfied
@@ -153,22 +156,22 @@ Route by status (see `<offer_next>`).
 
 All requirements covered. Cross-phase integration verified. E2E flows complete.
 
----
+───────────────────────────────────────────────────────────────
 
 ## ▶ Next Up
 
 **Complete milestone** — archive and tag
 
-`/gsd:complete-milestone {version}`
+/gsd:complete-milestone {version}
 
-<sub>`/clear` first → fresh context window</sub>
-```
+<sub>/clear first → fresh context window</sub>
+
+───────────────────────────────────────────────────────────────
 
 ---
 
 **If gaps_found:**
 
-```markdown
 ## ⚠ Milestone {version} — Gaps Found
 
 **Score:** {N}/{M} requirements satisfied
@@ -190,28 +193,28 @@ All requirements covered. Cross-phase integration verified. E2E flows complete.
 {For each flow gap:}
 - **{flow name}:** breaks at {step}
 
----
+───────────────────────────────────────────────────────────────
 
 ## ▶ Next Up
 
 **Plan gap closure** — create phases to complete milestone
 
-`/gsd:plan-milestone-gaps`
+/gsd:plan-milestone-gaps
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>/clear first → fresh context window</sub>
 
----
+───────────────────────────────────────────────────────────────
 
 **Also available:**
-- `cat .planning/v{version}-MILESTONE-AUDIT.md` — see full report
-- `/gsd:complete-milestone {version}` — proceed anyway (accept tech debt)
-```
+- cat .planning/v{version}-MILESTONE-AUDIT.md — see full report
+- /gsd:complete-milestone {version} — proceed anyway (accept tech debt)
+
+───────────────────────────────────────────────────────────────
 
 ---
 
 **If tech_debt (no blockers but accumulated debt):**
 
-```markdown
 ## ⚡ Milestone {version} — Tech Debt Review
 
 **Score:** {N}/{M} requirements satisfied
@@ -228,20 +231,21 @@ All requirements met. No critical blockers. Accumulated tech debt needs review.
 
 ### Total: {N} items across {M} phases
 
----
+───────────────────────────────────────────────────────────────
 
 ## ▶ Options
 
 **A. Complete milestone** — accept debt, track in backlog
 
-`/gsd:complete-milestone {version}`
+/gsd:complete-milestone {version}
 
 **B. Plan cleanup phase** — address debt before completing
 
-`/gsd:plan-milestone-gaps`
+/gsd:plan-milestone-gaps
 
-<sub>`/clear` first → fresh context window</sub>
-```
+<sub>/clear first → fresh context window</sub>
+
+───────────────────────────────────────────────────────────────
 </offer_next>
 
 <success_criteria>

package/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
 
 ---

package/commands/gsd/discuss-phase.md

@@ -35,10 +35,10 @@ Phase number: $ARGUMENTS (required)
 <process>
 1. Validate phase number (error if missing or not in roadmap)
 2. Check if CONTEXT.md exists (offer update/view/skip if yes)
-3. **Analyze phase** — Identify domain boundary and gray areas by category
-4. **Present gray areas** — Multi-select AskUserQuestion: which to discuss?
-5. **Deep-dive each area** — Loop per area until user says "move on"
-6. **Write CONTEXT.md** — Structured by decisions made
+3. **Analyze phase** — Identify domain and generate phase-specific gray areas
+4. **Present gray areas** — Multi-select: which to discuss? (NO skip option)
+5. **Deep-dive each area** — 4 questions per area, then offer more/next
+6. **Write CONTEXT.md** — Sections match areas discussed
 7. Offer next steps (research or plan)
 
 **CRITICAL: Scope guardrail**
@@ -47,18 +47,27 @@ Phase number: $ARGUMENTS (required)
 - If user suggests new capabilities: "That's its own phase. I'll note it for later."
 - Capture deferred ideas — don't lose them, don't act on them
 
-**Gray area categories (use what's relevant):**
-- **UI** — Layout, visual presentation, information density
-- **UX** — Interactions, flows, feedback
-- **Behavior** — Runtime behavior, state changes
-- **Empty/Edge States** — What shows in unusual situations
-- **Content** — What information is shown/hidden
+**Domain-aware gray areas:**
+Gray areas depend on what's being built. Analyze the phase goal:
+- Something users SEE → layout, density, interactions, states
+- Something users CALL → responses, errors, auth, versioning
+- Something users RUN → output format, flags, modes, error handling
+- Something users READ → structure, tone, depth, flow
+- Something being ORGANIZED → criteria, grouping, naming, exceptions
 
-**Do NOT ask about (downstream agents handle these):**
-- Technical implementation (researcher investigates)
-- Architecture choices (planner decides)
-- Performance concerns (researcher/planner handle)
-- Scope expansion (roadmap defines scope)
+Generate 3-4 **phase-specific** gray areas, not generic categories.
+
+**Probing depth:**
+- Ask 4 questions per area before checking
+- "More questions about [area], or move to next?"
+- If more → ask 4 more, check again
+- After all areas → "Ready to create context?"
+
+**Do NOT ask about (Claude handles these):**
+- Technical implementation
+- Architecture choices
+- Performance concerns
+- Scope expansion
 </process>
 
 <success_criteria>

package/commands/gsd/execute-phase.md

@@ -105,9 +105,7 @@ Phase: $ARGUMENTS
 </process>
 
 <offer_next>
-**MANDATORY: Present copy/paste-ready next command.**
-
-After verification completes, route based on status:
+Output this markdown directly (not as a code block). Route based on status:
 
 | Status | Route |
 |--------|-------|
@@ -120,7 +118,6 @@ After verification completes, route based on status:
 
 **Route A: Phase verified, more phases remain**
 
-```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  GSD ► PHASE {Z} COMPLETE ✓
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -136,24 +133,22 @@ Goal verified ✓
 
 **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>
+<sub>/clear first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 
 **Also available:**
-- `/gsd:verify-work {Z}` — manual acceptance testing before continuing
-- `/gsd:discuss-phase {Z+1}` — gather context first
+- /gsd:plan-phase {Z+1} — skip discussion, plan directly
+- /gsd:verify-work {Z} — manual acceptance testing before continuing
 
 ───────────────────────────────────────────────────────────────
-```
 
 ---
 
 **Route B: Phase verified, milestone complete**
 
-```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  GSD ► MILESTONE COMPLETE 🎉
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -169,24 +164,22 @@ All phase goals verified ✓
 
 **Audit milestone** — verify requirements, cross-phase integration, E2E flows
 
-`/gsd:audit-milestone`
+/gsd:audit-milestone
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>/clear first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 
 **Also available:**
-- `/gsd:verify-work` — manual acceptance testing
-- `/gsd:complete-milestone` — skip audit, archive directly
+- /gsd:verify-work — manual acceptance testing
+- /gsd:complete-milestone — skip audit, archive directly
 
 ───────────────────────────────────────────────────────────────
-```
 
 ---
 
 **Route C: Gaps found — need additional planning**
 
-```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  GSD ► PHASE {Z} GAPS FOUND ⚠
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -194,7 +187,7 @@ All phase goals verified ✓
 **Phase {Z}: {Name}**
 
 Score: {N}/{M} must-haves verified
-Report: `.planning/phases/{phase_dir}/{phase}-VERIFICATION.md`
+Report: .planning/phases/{phase_dir}/{phase}-VERIFICATION.md
 
 ### What's Missing
 
@@ -206,23 +199,24 @@ Report: `.planning/phases/{phase_dir}/{phase}-VERIFICATION.md`
 
 **Plan gap closure** — create additional plans to complete the phase
 
-`/gsd:plan-phase {Z} --gaps`
+/gsd:plan-phase {Z} --gaps
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>/clear first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 
 **Also available:**
-- `cat .planning/phases/{phase_dir}/{phase}-VERIFICATION.md` — see full report
-- `/gsd:verify-work {Z}` — manual testing before planning
+- cat .planning/phases/{phase_dir}/{phase}-VERIFICATION.md — see full report
+- /gsd:verify-work {Z} — manual testing before planning
 
 ───────────────────────────────────────────────────────────────
-```
 
-After user runs `/gsd:plan-phase {Z} --gaps`:
+---
+
+After user runs /gsd:plan-phase {Z} --gaps:
 1. Planner reads VERIFICATION.md gaps
 2. Creates plans 04, 05, etc. to close gaps
-3. User runs `/gsd:execute-phase {Z}` again
+3. User runs /gsd:execute-phase {Z} again
 4. Execute-phase runs incomplete plans (04, 05...)
 5. Verifier runs again → loop until passed
 </offer_next>

package/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.
 

package/commands/gsd/plan-phase.md

@@ -37,13 +37,7 @@ Phase number: $ARGUMENTS (optional - auto-detects next unplanned phase if not pr
 - `--gaps` — Gap closure mode (reads VERIFICATION.md, skips research)
 - `--skip-verify` — Skip planner → checker verification loop
 
-Check for existing research and plans:
-
-```bash
-ls .planning/phases/${PHASE}-*/*-RESEARCH.md 2>/dev/null
-ls .planning/phases/${PHASE}-*/*-PLAN.md 2>/dev/null
-```
-
+Normalize phase input in step 2 before any directory lookups.
 </context>
 
 <process>
@@ -56,7 +50,7 @@ ls .planning/ 2>/dev/null
 
 **If not found:** Error - user should run `/gsd:new-project` first.
 
-## 2. Parse Arguments
+## 2. Parse and Normalize Arguments
 
 Extract from $ARGUMENTS:
 
@@ -68,6 +62,24 @@ Extract from $ARGUMENTS:
 
 **If no phase number:** Detect next unplanned phase from roadmap.
 
+**Normalize phase to zero-padded format:**
+
+```bash
+# Normalize phase number (8 → 08, but preserve decimals like 2.1 → 02.1)
+if [[ "$PHASE" =~ ^[0-9]+$ ]]; then
+  PHASE=$(printf "%02d" "$PHASE")
+elif [[ "$PHASE" =~ ^([0-9]+)\.([0-9]+)$ ]]; then
+  PHASE=$(printf "%02d.%s" "${BASH_REMATCH[1]}" "${BASH_REMATCH[2]}")
+fi
+```
+
+**Check for existing research and plans:**
+
+```bash
+ls .planning/phases/${PHASE}-*/*-RESEARCH.md 2>/dev/null
+ls .planning/phases/${PHASE}-*/*-PLAN.md 2>/dev/null
+```
+
 ## 3. Validate Phase
 
 ```bash
@@ -79,14 +91,13 @@ grep -A5 "Phase ${PHASE}:" .planning/ROADMAP.md 2>/dev/null
 ## 4. Ensure Phase Directory Exists
 
 ```bash
-# Match both zero-padded (05-*) and unpadded (5-*) folders
-PADDED_PHASE=$(printf "%02d" ${PHASE})
-PHASE_DIR=$(ls -d .planning/phases/${PADDED_PHASE}-* .planning/phases/${PHASE}-* 2>/dev/null | head -1)
+# PHASE is already normalized (08, 02.1, etc.) from step 2
+PHASE_DIR=$(ls -d .planning/phases/${PHASE}-* 2>/dev/null | head -1)
 if [ -z "$PHASE_DIR" ]; then
-  # Create phase directory from roadmap name with zero-padded phase number
+  # Create phase directory from roadmap name
   PHASE_NAME=$(grep "Phase ${PHASE}:" .planning/ROADMAP.md | sed 's/.*Phase [0-9]*: //' | tr '[:upper:]' '[:lower:]' | tr ' ' '-')
-  mkdir -p ".planning/phases/${PADDED_PHASE}-${PHASE_NAME}"
-  PHASE_DIR=".planning/phases/${PADDED_PHASE}-${PHASE_NAME}"
+  mkdir -p ".planning/phases/${PHASE}-${PHASE_NAME}"
+  PHASE_DIR=".planning/phases/${PHASE}-${PHASE_NAME}"
 fi
 ```
 
@@ -408,7 +419,13 @@ Wait for user response.
 
 ## 13. Present Final Status
 
-```
+Route to `<offer_next>`.
+
+</process>
+
+<offer_next>
+Output this markdown directly (not as a code block):
+
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  GSD ► PHASE {X} PLANNED ✓
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -429,20 +446,18 @@ Verification: {Passed | Passed with override | Skipped}
 
 **Execute Phase {X}** — run all {N} plans
 
-`/gsd:execute-phase {X}`
+/gsd:execute-phase {X}
 
-<sub>`/clear` first → fresh context window</sub>
+<sub>/clear first → fresh context window</sub>
 
 ───────────────────────────────────────────────────────────────
 
 **Also available:**
-- `cat .planning/phases/{phase-dir}/*-PLAN.md` — review plans
-- `/gsd:plan-phase {X} --research` — re-research first
+- cat .planning/phases/{phase-dir}/*-PLAN.md — review plans
+- /gsd:plan-phase {X} --research — re-research first
 
 ───────────────────────────────────────────────────────────────
-```
-
-</process>
+</offer_next>
 
 <success_criteria>
 - [ ] .planning/ directory validated