@ahmed118glitch/get-shit-done-codex 1.18.3 → 1.19.0

package/CHANGELOG.md

@@ -6,6 +6,22 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.19.0] - 2026-02-15
+
+### Added
+- Brave Search integration for researchers (requires BRAVE_API_KEY environment variable)
+- GitHub issue templates for bug reports and feature requests
+- Security policy for responsible disclosure
+- Auto-labeling workflow for new issues
+
+### Fixed
+- UAT gaps and debug sessions now auto-resolve after gap-closure phase execution (#580)
+- Fall back to ROADMAP.md when phase directory missing (#521)
+- Template hook paths for OpenCode/Gemini runtimes (#585)
+- Accept both `##` and `###` phase headers, detect malformed ROADMAPs (#598, #599)
+- Use `{phase_num}` instead of ambiguous `{phase}` for filenames (#601)
+- Add package.json to prevent ESM inheritance issues (#602)
+
 ## [1.18.0] - 2026-02-08
 
 ### Added
@@ -1206,7 +1222,8 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - YOLO mode for autonomous execution
 - Interactive mode with checkpoints
 
-[Unreleased]: https://github.com/glittercowboy/get-shit-done/compare/v1.18.0...HEAD
+[Unreleased]: https://github.com/glittercowboy/get-shit-done/compare/v1.19.0...HEAD
+[1.19.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.19.0
 [1.18.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.18.0
 [1.17.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.17.0
 [1.16.0]: https://github.com/glittercowboy/get-shit-done/releases/tag/v1.16.0

package/README.md

@@ -1,86 +1,102 @@
-# Get Shit Done (GSD)
-
-Get Shit Done is a planning-first workflow system for AI coding agents. This repository packages the core GSD engine, workflow templates, runtime command surfaces, and a Codex prompt layer.
-
-## What Is In This Repository
-
-- `commands/gsd/`: command source files used by runtime installers
-- `get-shit-done/bin/gsd-tools.js`: core CLI utilities and state/workflow helpers
-- `get-shit-done/workflows/`: end-to-end command workflows
-- `get-shit-done/templates/`: planning and state templates
-- `get-shit-done/references/`: supporting reference docs
-- `agents/`: role-specific agent instruction files
-- `hooks/` and `scripts/build-hooks.js`: hook sources and build pipeline
-- `.codex/prompts/` and `.codex/skills/`: Codex-native prompt and skill layer
-
-## Install
-
-Prerequisite: Node.js `>=16.7.0`.
-
-```bash
-npx @ahmed118glitch/get-shit-done-codex@latest --path .
-```
-
-Common examples:
-
-```bash
-# Install Codex files into the current project directory
-npx @ahmed118glitch/get-shit-done-codex@latest --path .
-
-# Install into an explicit target folder:
-npx @ahmed118glitch/get-shit-done-codex@latest --path /path/to/project
-
-# Install shared copy under your home directory as well:
-npx @ahmed118glitch/get-shit-done-codex@latest --global
-
-# Run the runtime installer (Claude/OpenCode/Gemini) from this scoped package:
-npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --help
-```
-
-## Runtime Command Surface
-
-- Claude Code and Gemini CLI use `/gsd:<command>` (example: `/gsd:help`)
-- OpenCode uses `/gsd-<command>` (example: `/gsd-help`)
-- Codex prompt files are in `.codex/prompts/gsd-*.md`
-
-## Quick Workflow
-
-1. Start a project with `new-project`
-2. Plan a phase with `plan-phase`
-3. Execute the phase with `execute-phase`
-4. Verify with `verify-work`
-5. Repeat per phase or milestone
-
-Installed commands create and update planning artifacts under `.planning/` (for example: `PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`).
-
-## Source Paths vs Installed Paths
-
-Repository source paths:
-
-- `commands/gsd/*`
-- `get-shit-done/workflows/*`
-- `get-shit-done/templates/*`
-
-Installed runtime targets:
-
-- Claude global: `~/.claude`
-- OpenCode global: `~/.config/opencode` (or platform XDG equivalent)
-- Gemini global: `~/.gemini`
-- Local mode: runtime folders in the current project
-
-## Development
-
-```bash
-npm test
-npm run build:hooks
-```
-
-Keep command and workflow behavior aligned across `commands/gsd/` and `get-shit-done/workflows/` when making changes.
-
-## Security
-
-Report vulnerabilities privately via `SECURITY.md`.
-
-## License
-
+# Get Shit Done (GSD)
+
+Get Shit Done is a planning-first workflow system for AI coding agents. This repository packages the core GSD engine, workflow templates, runtime command surfaces, and a Codex prompt layer.
+
+## What Is In This Repository
+
+- `commands/gsd/`: command source files used by runtime installers
+- `get-shit-done/bin/gsd-tools.js`: core CLI utilities and state/workflow helpers
+- `get-shit-done/workflows/`: end-to-end command workflows
+- `get-shit-done/templates/`: planning and state templates
+- `get-shit-done/references/`: supporting reference docs
+- `agents/`: role-specific agent instruction files
+- `hooks/` and `scripts/build-hooks.js`: hook sources and build pipeline
+- `.codex/prompts/` and `.codex/skills/`: Codex-native prompt and skill layer
+
+## Install
+
+Prerequisite: Node.js `>=16.7.0`.
+
+```bash
+npx @ahmed118glitch/get-shit-done-codex@latest --path .
+```
+
+Common examples:
+
+```bash
+# Install Codex files into the current project directory
+npx @ahmed118glitch/get-shit-done-codex@latest --path .
+
+# Install into an explicit target folder:
+npx @ahmed118glitch/get-shit-done-codex@latest --path /path/to/project
+
+# Install shared copy under your home directory as well:
+npx @ahmed118glitch/get-shit-done-codex@latest --global
+
+# Run the runtime installer from this scoped package (examples):
+npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --all --global
+npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --claude --local
+```
+
+Global install writes prompts to `~/.codex/prompts` (not nested).
+
+## Verify Install
+
+```bash
+# Project prompts
+ls ./.codex/prompts/gsd-*.md
+
+# Global prompts (if you used --global)
+ls ~/.codex/prompts/gsd-*.md
+```
+
+## Runtime Command Surface
+
+- Claude Code and Gemini CLI use `/gsd:<command>` (example: `/gsd:help`)
+- OpenCode uses `/gsd-<command>` (example: `/gsd-help`)
+- Codex prompt files are in `.codex/prompts/gsd-*.md`
+
+## Quick Workflow
+
+Use the command surface above (`/gsd:<command>`, `/gsd-<command>`, or Codex `gsd-*` prompts).
+
+1. Start a project with `new-project`
+2. Plan a phase with `plan-phase`
+3. Execute the phase with `execute-phase`
+4. Verify with `verify-work`
+5. Repeat per phase or milestone
+
+Installed commands create and update planning artifacts under `.planning/` (for example: `PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`).
+
+## Source Paths vs Installed Paths
+
+Repository source paths:
+
+- `commands/gsd/*`
+- `get-shit-done/workflows/*`
+- `get-shit-done/templates/*`
+
+Installed runtime targets:
+
+- Claude global: `~/.claude`
+- OpenCode global: `~/.config/opencode` (or platform XDG equivalent)
+- Gemini global: `~/.gemini`
+- Codex global prompts/skills: `~/.codex/prompts`, `~/.codex/skills`
+- Local mode: runtime folders in the current project
+
+## Development
+
+```bash
+npm test
+npm run build:hooks
+```
+
+Keep command and workflow behavior aligned across `commands/gsd/` and `get-shit-done/workflows/` when making changes.
+
+## Security
+
+Report vulnerabilities privately via `SECURITY.md`.
+
+## License
+
 MIT (`LICENSE`).

package/agents/gsd-phase-researcher.md

@@ -177,7 +177,7 @@ Priority: Context7 > Official Docs > Official GitHub > Verified WebSearch > Unve
 
 ## RESEARCH.md Structure
 
-**Location:** `.planning/phases/XX-name/{phase}-RESEARCH.md`
+**Location:** `.planning/phases/XX-name/{phase_num}-RESEARCH.md`
 
 ```markdown
 # Phase [X]: [Name] - Research

package/agents/gsd-roadmapper.md

@@ -286,12 +286,46 @@ After roadmap creation, REQUIREMENTS.md gets updated with phase mappings:
 
 ## ROADMAP.md Structure
 
-Use template from `~/.claude/get-shit-done/templates/roadmap.md`.
+**CRITICAL: ROADMAP.md requires TWO phase representations. Both are mandatory.**
 
-Key sections:
-- Overview (2-3 sentences)
-- Phases with Goal, Dependencies, Requirements, Success Criteria
-- Progress table
+### 1. Summary Checklist (under `## Phases`)
+
+```markdown
+- [ ] **Phase 1: Name** - One-line description
+- [ ] **Phase 2: Name** - One-line description
+- [ ] **Phase 3: Name** - One-line description
+```
+
+### 2. Detail Sections (under `## Phase Details`)
+
+```markdown
+### Phase 1: Name
+**Goal**: What this phase delivers
+**Depends on**: Nothing (first phase)
+**Requirements**: REQ-01, REQ-02
+**Success Criteria** (what must be TRUE):
+  1. Observable behavior from user perspective
+  2. Observable behavior from user perspective
+**Plans**: TBD
+
+### Phase 2: Name
+**Goal**: What this phase delivers
+**Depends on**: Phase 1
+...
+```
+
+**The `### Phase X:` headers are parsed by downstream tools.** If you only write the summary checklist, phase lookups will fail.
+
+### 3. Progress Table
+
+```markdown
+| Phase | Plans Complete | Status | Completed |
+|-------|----------------|--------|-----------|
+| 1. Name | 0/3 | Not started | - |
+| 2. Name | 0/2 | Not started | - |
+```
+
+Reference full template: `~/.claude/get-shit-done/templates/roadmap.md`
 
 ## STATE.md Structure
 

package/agents/gsd-verifier.md

@@ -317,7 +317,7 @@ gaps:
 
 ## Create VERIFICATION.md
 
-Create `.planning/phases/{phase_dir}/{phase}-VERIFICATION.md`:
+Create `.planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md`:
 
 ```markdown
 ---
@@ -411,7 +411,7 @@ Return with:
 
 **Status:** {passed | gaps_found | human_needed}
 **Score:** {N}/{M} must-haves verified
-**Report:** .planning/phases/{phase_dir}/{phase}-VERIFICATION.md
+**Report:** .planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md
 
 {If passed:}
 All must-haves verified. Phase goal achieved. Ready to proceed.

package/bin/install-codex.js

@@ -1,100 +1,100 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const args = process.argv.slice(2);
-const pkg = require('../package.json');
-const repoRoot = path.resolve(__dirname, '..');
-
-const helpText = `
-${pkg.name} v${pkg.version}
-
-Usage:
-  get-shit-done-codex [--path <target-dir>] [--help]
-
-Options:
-  --path <target-dir>   Install into this directory (defaults to current directory)
-  --global              Also install .claude to your home directory (for manual sharing)
-  --help, -h            Show this help message
-
-Examples:
-  npx @ahmed118glitch/get-shit-done-codex@latest --path .
-  npx @ahmed118glitch/get-shit-done-codex@latest --path ./my-project
-`;
-
-if (args.includes('--help') || args.includes('-h')) {
-  console.log(helpText);
-  process.exit(0);
-}
-
-const pathArgIndex = args.findIndex((arg, index) => {
-  if (arg === '--path') return true;
-  return false;
-});
-let targetDir = process.cwd();
-if (pathArgIndex !== -1) {
-  const userPath = args[pathArgIndex + 1];
-  if (!userPath || userPath.startsWith('-')) {
-    console.error('Error: --path requires a directory argument.');
-    process.exit(1);
-  }
-  targetDir = path.resolve(process.cwd(), userPath);
-}
-
-const installGlobal = args.includes('--global');
-
-function copyRecursive(source, destination) {
-  if (!fs.existsSync(source)) return;
-  fs.cpSync(source, destination, { recursive: true, force: true });
-}
-
-function ensureDir(dirPath) {
-  fs.mkdirSync(dirPath, { recursive: true });
-}
-
-function resolveSourceDir(repoRelative, fallbackRelative) {
-  const primary = path.join(repoRoot, repoRelative);
-  const fallback = fallbackRelative ? path.join(repoRoot, fallbackRelative) : null;
-
-  if (fs.existsSync(primary)) return primary;
-  if (fallback && fs.existsSync(fallback)) return fallback;
-
-  const fallbackMessage = fallbackRelative ? ` or ${fallbackRelative}` : '';
-  throw new Error(`Missing source directory "${repoRelative}"${fallbackMessage} in repository root ${repoRoot}`);
-}
-
-function copyCodexToDirectory(baseDir) {
-  const targetCodex = path.join(baseDir, '.codex');
-  const targetClaude = path.join(baseDir, '.claude');
-  const sourceCodex = path.join(repoRoot, '.codex');
-  const sourceGetShitDone = resolveSourceDir('get-shit-done', '.claude/get-shit-done');
-  const sourceAgents = resolveSourceDir('agents', '.claude/agents');
-
-  ensureDir(baseDir);
-  ensureDir(targetCodex);
-  ensureDir(targetClaude);
-
-  copyRecursive(sourceCodex, targetCodex);
-  copyRecursive(sourceGetShitDone, path.join(targetClaude, 'get-shit-done'));
-  copyRecursive(sourceAgents, path.join(targetClaude, 'agents'));
-}
-
-copyCodexToDirectory(targetDir);
-
-if (installGlobal) {
-  // Global installs should place prompts at ~/.codex/prompts (not ~/.codex/.codex/prompts).
-  const globalBase = os.homedir();
-  copyCodexToDirectory(globalBase);
-}
-
-console.log(`\n${pkg.name} installed to:`);
-console.log(`  local: ${targetDir}`);
-if (installGlobal) {
-  console.log('  global: ~/.codex');
-}
-console.log('\nNext steps:');
-console.log('  1) Open your project in Codex');
-console.log('  2) Run prompt gsd-new-project, then gsd-plan-phase, gsd-execute-phase');
-console.log('  3) Use .codex/prompts/* for all GSD commands in this fork');
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const args = process.argv.slice(2);
+const pkg = require('../package.json');
+const repoRoot = path.resolve(__dirname, '..');
+
+const helpText = `
+${pkg.name} v${pkg.version}
+
+Usage:
+  get-shit-done-codex [--path <target-dir>] [--help]
+
+Options:
+  --path <target-dir>   Install into this directory (defaults to current directory)
+  --global              Also install .claude to your home directory (for manual sharing)
+  --help, -h            Show this help message
+
+Examples:
+  npx @ahmed118glitch/get-shit-done-codex@latest --path .
+  npx @ahmed118glitch/get-shit-done-codex@latest --path ./my-project
+`;
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(helpText);
+  process.exit(0);
+}
+
+const pathArgIndex = args.findIndex((arg, index) => {
+  if (arg === '--path') return true;
+  return false;
+});
+let targetDir = process.cwd();
+if (pathArgIndex !== -1) {
+  const userPath = args[pathArgIndex + 1];
+  if (!userPath || userPath.startsWith('-')) {
+    console.error('Error: --path requires a directory argument.');
+    process.exit(1);
+  }
+  targetDir = path.resolve(process.cwd(), userPath);
+}
+
+const installGlobal = args.includes('--global');
+
+function copyRecursive(source, destination) {
+  if (!fs.existsSync(source)) return;
+  fs.cpSync(source, destination, { recursive: true, force: true });
+}
+
+function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function resolveSourceDir(repoRelative, fallbackRelative) {
+  const primary = path.join(repoRoot, repoRelative);
+  const fallback = fallbackRelative ? path.join(repoRoot, fallbackRelative) : null;
+
+  if (fs.existsSync(primary)) return primary;
+  if (fallback && fs.existsSync(fallback)) return fallback;
+
+  const fallbackMessage = fallbackRelative ? ` or ${fallbackRelative}` : '';
+  throw new Error(`Missing source directory "${repoRelative}"${fallbackMessage} in repository root ${repoRoot}`);
+}
+
+function copyCodexToDirectory(baseDir) {
+  const targetCodex = path.join(baseDir, '.codex');
+  const targetClaude = path.join(baseDir, '.claude');
+  const sourceCodex = path.join(repoRoot, '.codex');
+  const sourceGetShitDone = resolveSourceDir('get-shit-done', '.claude/get-shit-done');
+  const sourceAgents = resolveSourceDir('agents', '.claude/agents');
+
+  ensureDir(baseDir);
+  ensureDir(targetCodex);
+  ensureDir(targetClaude);
+
+  copyRecursive(sourceCodex, targetCodex);
+  copyRecursive(sourceGetShitDone, path.join(targetClaude, 'get-shit-done'));
+  copyRecursive(sourceAgents, path.join(targetClaude, 'agents'));
+}
+
+copyCodexToDirectory(targetDir);
+
+if (installGlobal) {
+  // Global installs should place prompts at ~/.codex/prompts (not ~/.codex/.codex/prompts).
+  const globalBase = os.homedir();
+  copyCodexToDirectory(globalBase);
+}
+
+console.log(`\n${pkg.name} installed to:`);
+console.log(`  local: ${targetDir}`);
+if (installGlobal) {
+  console.log('  global: ~/.codex');
+}
+console.log('\nNext steps:');
+console.log('  1) Open your project in Codex');
+console.log('  2) Run prompt gsd-new-project, then gsd-plan-phase, gsd-execute-phase');
+console.log('  3) Use .codex/prompts/* for all GSD commands in this fork');

package/bin/install.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const fs = require('fs');
 const path = require('path');
@@ -46,6 +46,27 @@ function getDirName(runtime) {
   return '.claude';
 }
 
+/**
+ * Get the config directory path relative to home directory for a runtime
+ * Used for templating hooks that use path.join(homeDir, '<configDir>', ...)
+ * @param {string} runtime - 'claude', 'opencode', or 'gemini'
+ * @param {boolean} isGlobal - Whether this is a global install
+ */
+function getConfigDirFromHome(runtime, isGlobal) {
+  if (!isGlobal) {
+    // Local installs use the same dir name pattern
+    return getDirName(runtime);
+  }
+  // Global installs - OpenCode uses XDG path structure
+  if (runtime === 'opencode') {
+    // OpenCode: ~/.config/opencode -> '.config', 'opencode'
+    // Return as comma-separated for path.join() replacement
+    return "'.config', 'opencode'";
+  }
+  if (runtime === 'gemini') return "'.gemini'";
+  return "'.claude'";
+}
+
 /**
  * Get the global config directory for OpenCode
  * OpenCode follows XDG Base Directory spec and uses ~/.config/opencode/
@@ -626,9 +647,11 @@ function copyFlattenedCommands(srcDir, destDir, prefix, pathPrefix, runtime) {
       const destPath = path.join(destDir, destName);
 
       let content = fs.readFileSync(srcPath, 'utf8');
-      const claudeDirRegex = /~\/\.claude\//g;
+      const globalClaudeRegex = /~\/\.claude\//g;
+      const localClaudeRegex = /\.\/\.claude\//g;
       const opencodeDirRegex = /~\/\.opencode\//g;
-      content = content.replace(claudeDirRegex, pathPrefix);
+      content = content.replace(globalClaudeRegex, pathPrefix);
+      content = content.replace(localClaudeRegex, `./${getDirName(runtime)}/`);
       content = content.replace(opencodeDirRegex, pathPrefix);
       content = processAttribution(content, getCommitAttribution(runtime));
       content = convertClaudeToOpencodeFrontmatter(content);
@@ -665,10 +688,12 @@ function copyWithPathReplacement(srcDir, destDir, pathPrefix, runtime) {
     if (entry.isDirectory()) {
       copyWithPathReplacement(srcPath, destPath, pathPrefix, runtime);
     } else if (entry.name.endsWith('.md')) {
-      // Always replace ~/.claude/ as it is the source of truth in the repo
+      // Replace ~/.claude/ and ./.claude/ with runtime-appropriate paths
       let content = fs.readFileSync(srcPath, 'utf8');
-      const claudeDirRegex = /~\/\.claude\//g;
-      content = content.replace(claudeDirRegex, pathPrefix);
+      const globalClaudeRegex = /~\/\.claude\//g;
+      const localClaudeRegex = /\.\/\.claude\//g;
+      content = content.replace(globalClaudeRegex, pathPrefix);
+      content = content.replace(localClaudeRegex, `./${dirName}/`);
       content = processAttribution(content, getCommitAttribution(runtime));
 
       // Convert frontmatter for opencode compatibility
@@ -867,7 +892,23 @@ function uninstall(isGlobal, runtime = 'claude') {
     }
   }
 
-  // 5. Clean up settings.json (remove GSD hooks and statusline)
+  // 5. Remove GSD package.json (CommonJS mode marker)
+  const pkgJsonPath = path.join(targetDir, 'package.json');
+  if (fs.existsSync(pkgJsonPath)) {
+    try {
+      const content = fs.readFileSync(pkgJsonPath, 'utf8').trim();
+      // Only remove if it's our minimal CommonJS marker
+      if (content === '{"type":"commonjs"}') {
+        fs.unlinkSync(pkgJsonPath);
+        removedCount++;
+        console.log(`  ${green}✓${reset} Removed GSD package.json`);
+      }
+    } catch (e) {
+      // Ignore read errors
+    }
+  }
+
+  // 6. Clean up settings.json (remove GSD hooks and statusline)
   const settingsPath = path.join(targetDir, 'settings.json');
   if (fs.existsSync(settingsPath)) {
     let settings = readSettings(settingsPath);
@@ -1405,17 +1446,33 @@ function install(isGlobal, runtime = 'claude') {
     failures.push('VERSION');
   }
 
+  // Write package.json to force CommonJS mode for GSD scripts
+  // Prevents "require is not defined" errors when project has "type": "module"
+  // Node.js walks up looking for package.json - this stops inheritance from project
+  const pkgJsonDest = path.join(targetDir, 'package.json');
+  fs.writeFileSync(pkgJsonDest, '{"type":"commonjs"}\n');
+  console.log(`  ${green}✓${reset} Wrote package.json (CommonJS mode)`);
+
   // Copy hooks from dist/ (bundled with dependencies)
+  // Template paths for the target runtime (replaces '.claude' with correct config dir)
   const hooksSrc = path.join(src, 'hooks', 'dist');
   if (fs.existsSync(hooksSrc)) {
     const hooksDest = path.join(targetDir, 'hooks');
     fs.mkdirSync(hooksDest, { recursive: true });
     const hookEntries = fs.readdirSync(hooksSrc);
+    const configDirReplacement = getConfigDirFromHome(runtime, isGlobal);
     for (const entry of hookEntries) {
       const srcFile = path.join(hooksSrc, entry);
       if (fs.statSync(srcFile).isFile()) {
         const destFile = path.join(hooksDest, entry);
-        fs.copyFileSync(srcFile, destFile);
+        // Template .js files to replace '.claude' with runtime-specific config dir
+        if (entry.endsWith('.js')) {
+          let content = fs.readFileSync(srcFile, 'utf8');
+          content = content.replace(/'\.claude'/g, configDirReplacement);
+          fs.writeFileSync(destFile, content);
+        } else {
+          fs.copyFileSync(srcFile, destFile);
+        }
       }
     }
     if (verifyInstalled(hooksDest, 'hooks')) {

package/commands/gsd/discuss-phase.md

@@ -20,7 +20,7 @@ Extract implementation decisions that downstream agents need — researcher and
 3. Deep-dive each selected area until satisfied
 4. Create CONTEXT.md with decisions that guide research and planning
 
-**Output:** `{phase}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again
+**Output:** `{phase_num}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again
 </objective>
 
 <execution_context>

package/commands/gsd/reapply-patches.md

@@ -14,11 +14,11 @@ After a GSD update wipes and reinstalls files, this command merges user's previo
 Check for local patches directory:
 
 ```bash
-# Global install
-PATCHES_DIR="${HOME}/.claude/gsd-local-patches"
+# Global install (path templated at install time)
+PATCHES_DIR=~/.claude/gsd-local-patches
 # Local install fallback
 if [ ! -d "$PATCHES_DIR" ]; then
-  PATCHES_DIR="./.claude/gsd-local-patches"
+  PATCHES_DIR=./.claude/gsd-local-patches
 fi
 ```
 

package/commands/gsd/verify-work.md

@@ -16,7 +16,7 @@ Validate built features through conversational testing with persistent state.
 
 Purpose: Confirm what Claude built actually works from user's perspective. One test at a time, plain text responses, no interrogation. When issues are found, automatically diagnose, plan fixes, and prepare for execution.
 
-Output: {phase}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd:execute-phase
+Output: {phase_num}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd:execute-phase
 </objective>
 
 <execution_context>