@undeemed/get-shit-done-codex 1.21.0 → 1.22.1

package/bin/install.js

@@ -42,39 +42,7 @@ const hasNoVersionCheck = args.includes('--no-version-check') || process.env.GSD
 const hasMigrate = args.includes('--migrate');
 const hasSkipMigrate = args.includes('--skip-migrate') || args.includes('--no-migrate');
 const isInteractiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);
-const CODEX_MODES = new Set(['prompts', 'skills']);
-const hasCodexModeArg = args.some((arg) =>
-  arg.startsWith('--codex-mode=') || arg === '--codex-mode' || arg === '-m'
-);
-
-function parseCodexModeArg(argv) {
-  const explicit = argv.find((arg) => arg.startsWith('--codex-mode='));
-  const flagIndex = argv.findIndex((arg) => arg === '--codex-mode' || arg === '-m');
-  let mode = 'skills';
-
-  if (explicit) {
-    mode = explicit.split('=')[1] || '';
-  }
-
-  if (flagIndex !== -1) {
-    const next = argv[flagIndex + 1];
-    if (!next || next.startsWith('-')) {
-      console.error(`  ${yellow}--codex-mode requires one of: prompts, skills${reset}`);
-      process.exit(1);
-    }
-    mode = next;
-  }
-
-  mode = String(mode).toLowerCase().trim();
-  if (!CODEX_MODES.has(mode)) {
-    console.error(`  ${yellow}Invalid --codex-mode '${mode}'. Expected prompts or skills.${reset}`);
-    process.exit(1);
-  }
-
-  return mode;
-}
-
-const codexMode = hasHelp ? 'skills' : parseCodexModeArg(args);
+const codexMode = 'skills';
 
 console.log(banner);
 
@@ -84,7 +52,6 @@ if (hasHelp) {
   ${yellow}Options:${reset}
     ${cyan}-g, --global${reset}              Install globally (to ~/.codex/)
     ${cyan}-l, --local${reset}               Install locally (to current directory)
-    ${cyan}-m, --codex-mode <mode>${reset}   Command mode: skills or prompts
     ${cyan}--migrate${reset}                 Apply detected legacy surface cleanup without prompting
     ${cyan}--skip-migrate${reset}            Keep legacy surface files when migration is detected
     ${cyan}--verify${reset}                  Verify current install integrity
@@ -99,12 +66,6 @@ if (hasHelp) {
     ${dim}# Install to current project only${reset}
     npx ${NPM_PACKAGE} --local
 
-    ${dim}# Install native Codex skills only${reset}
-    npx ${NPM_PACKAGE} --global --codex-mode skills
-
-    ${dim}# Install prompt aliases only${reset}
-    npx ${NPM_PACKAGE} --global --codex-mode prompts
-
     ${dim}# Verify global installation${reset}
     npx ${NPM_PACKAGE} --verify --global
 
@@ -115,10 +76,10 @@ if (hasHelp) {
     npx ${NPM_PACKAGE} --global --migrate
 
   ${yellow}Notes:${reset}
-    - Installs AGENTS.md into the target directory
-    - If --codex-mode is omitted in interactive mode, installer prompts to choose
-    - Non-interactive runs default to skills mode
-    - If legacy surface files are detected, installer asks before removing them
+    - Installs AGENTS.md, skills/gsd-*/SKILL.md, agents/gsd-*.md, .codex/config.toml
+    - All commands use $gsd-* skill notation
+    - Legacy prompts/ installs are detected and cleaned up via --migrate
+    - --verify + --repair will reinstall missing artifacts
     - Installs get-shit-done/ workflow files
 `);
   process.exit(0);
@@ -159,9 +120,7 @@ function convertPromptRefsToSkillRefs(content) {
   return converted;
 }
 
-function convertSkillRefsToPromptRefs(content) {
-  return content.replace(/\$gsd-([a-z0-9-]+)/gi, (_, commandName) => `/prompts:gsd-${String(commandName).toLowerCase()}`);
-}
+
 
 function convertCommandRefsToSkillMentions(content) {
   return convertPromptRefsToSkillRefs(content).replace(/\$ARGUMENTS\b/g, '{{GSD_ARGS}}');
@@ -174,20 +133,10 @@ function rewriteAgentInvocationLine(content, replacement) {
     .replace('Invoke them with `$gsd-command-name`:', replacement);
 }
 
-function adaptAgentsForCodexMode(content, mode) {
-  if (mode === 'skills') {
-    let adapted = convertPromptRefsToSkillRefs(content);
-    adapted = rewriteAgentInvocationLine(adapted, 'Invoke them with `$gsd-command-name`:');
-    return adapted;
-  }
-
-  if (mode === 'prompts') {
-    let adapted = convertSkillRefsToPromptRefs(content);
-    adapted = rewriteAgentInvocationLine(adapted, 'Invoke them with `/prompts:gsd-command-name`:');
-    return adapted;
-  }
-
-  return content;
+function adaptAgentsForCodexMode(content) {
+  let adapted = convertPromptRefsToSkillRefs(content);
+  adapted = rewriteAgentInvocationLine(adapted, 'Invoke them with `$gsd-command-name`:');
+  return adapted;
 }
 
 function extractFrontmatterAndBody(content) {
@@ -244,15 +193,7 @@ ${getCodexSkillAdapterHeader(skillName)}
 ${body.trimStart()}`;
 }
 
-function installPrompts(commandsDir, promptsDir, markdownEntries, pathPrefix) {
-  fs.mkdirSync(promptsDir, { recursive: true });
-  for (const entry of markdownEntries) {
-    const srcPath = path.join(commandsDir, entry);
-    const destPath = path.join(promptsDir, `gsd-${entry}`);
-    const content = applyReplacements(fs.readFileSync(srcPath, 'utf8'), pathPrefix);
-    fs.writeFileSync(destPath, content, 'utf8');
-  }
-}
+
 
 function installCodexSkills(commandsDir, skillsDir, markdownEntries, pathPrefix) {
   fs.mkdirSync(skillsDir, { recursive: true });
@@ -320,7 +261,7 @@ function installConfig(src, codexDir, pathPrefix) {
   return true;
 }
 
-function installAgentDefs(src, codexDir, pathPrefix, mode) {
+function installAgentDefs(src, codexDir, pathPrefix) {
   const agentsSrc = path.join(src, 'agents');
   if (!fs.existsSync(agentsSrc)) return 0;
   const agentsDest = path.join(codexDir, 'agents');
@@ -329,11 +270,7 @@ function installAgentDefs(src, codexDir, pathPrefix, mode) {
   for (const entry of entries) {
     let content = fs.readFileSync(path.join(agentsSrc, entry), 'utf8');
     content = applyReplacements(content, pathPrefix);
-    if (mode === 'skills') {
-      content = convertPromptRefsToSkillRefs(content);
-    } else if (mode === 'prompts') {
-      content = convertSkillRefsToPromptRefs(content);
-    }
+    content = convertPromptRefsToSkillRefs(content);
     fs.writeFileSync(path.join(agentsDest, entry), content, 'utf8');
   }
   return entries.length;
@@ -351,52 +288,27 @@ function countInstalledAgentDefs(codexDir) {
   return fs.readdirSync(agentsDest).filter((e) => /^gsd-.*\.md$/i.test(e)).length;
 }
 
-function detectMigrationPlan(codexDir, mode) {
+function detectMigrationPlan(codexDir) {
   const promptsDir = path.join(codexDir, 'prompts');
-  const skillsDir = path.join(codexDir, 'skills');
   const promptFiles = listPromptCommandFiles(promptsDir);
-  const skillNames = listSkillNames(skillsDir);
-
-  const promptCountToRemove = mode === 'skills' ? promptFiles.length : 0;
-  const skillCountToRemove = mode === 'prompts' ? skillNames.length : 0;
 
   return {
-    mode,
     promptsDir,
-    skillsDir,
-    promptCountToRemove,
-    skillCountToRemove,
-    hasChanges: promptCountToRemove > 0 || skillCountToRemove > 0,
+    promptCountToRemove: promptFiles.length,
+    hasChanges: promptFiles.length > 0,
   };
 }
 
 function describeMigrationPlan(plan) {
-  const items = [];
-  if (plan.promptCountToRemove > 0) {
-    items.push(`${plan.promptCountToRemove} legacy prompt alias file(s) in prompts/`);
-  }
-  if (plan.skillCountToRemove > 0) {
-    items.push(`${plan.skillCountToRemove} legacy skill director${plan.skillCountToRemove === 1 ? 'y' : 'ies'} in skills/`);
-  }
-  return items.join(' and ');
+  return `${plan.promptCountToRemove} legacy prompt alias file(s) in prompts/`;
 }
 
 function applyMigrationPlan(plan) {
-  let removedPrompts = 0;
-  let removedSkills = 0;
-
   if (plan.promptCountToRemove > 0) {
-    removedPrompts = removePromptAliases(plan.promptsDir);
-  }
-  if (plan.skillCountToRemove > 0) {
-    removedSkills = removeSkillAliases(plan.skillsDir);
-  }
-
-  if (removedPrompts > 0 || removedSkills > 0) {
-    const changes = [];
-    if (removedPrompts > 0) changes.push(`${removedPrompts} prompt alias file(s)`);
-    if (removedSkills > 0) changes.push(`${removedSkills} skill director${removedSkills === 1 ? 'y' : 'ies'}`);
-    console.log(`  ${green}✓${reset} Migration applied: removed ${changes.join(', ')}`);
+    const removed = removePromptAliases(plan.promptsDir);
+    if (removed > 0) {
+      console.log(`  ${green}✓${reset} Migration applied: removed ${removed} legacy prompt alias file(s)`);
+    }
   }
 }
 
@@ -471,13 +383,12 @@ function listSkillNames(skillsDir) {
 }
 
 function detectInstalledMode(promptCount, skillCount) {
-  if (promptCount > 0 && skillCount > 0) return 'mixed';
-  if (promptCount > 0) return 'prompts';
+  if (promptCount > 0) return 'legacy-prompts';
   if (skillCount > 0) return 'skills';
   return 'none';
 }
 
-function verifyInstall(isGlobal, expectedMode, strictMode = false) {
+function verifyInstall(isGlobal) {
   const src = path.join(__dirname, '..');
   const { codexDir, locationLabel } = getInstallContext(isGlobal);
   const promptsDir = path.join(codexDir, 'prompts');
@@ -491,7 +402,6 @@ function verifyInstall(isGlobal, expectedMode, strictMode = false) {
   const promptFiles = listPromptCommandFiles(promptsDir);
   const skillNames = listSkillNames(skillsDir);
   const detectedMode = detectInstalledMode(promptFiles.length, skillNames.length);
-  const modeToCheck = strictMode ? expectedMode : (detectedMode === 'none' ? expectedMode : detectedMode);
 
   const checks = [];
   const addCheck = (ok, label, detail) => checks.push({ ok, label, detail });
@@ -515,24 +425,12 @@ function verifyInstall(isGlobal, expectedMode, strictMode = false) {
     addCheck(version === pkg.version, 'VERSION matches installer package', `${version || '(empty)'} vs ${pkg.version}`);
   }
 
-  if (modeToCheck === 'prompts') {
-    addCheck(promptFiles.length === expectedCount, 'Prompt aliases complete', `${promptFiles.length}/${expectedCount}`);
-  }
-  if (modeToCheck === 'skills') {
-    addCheck(skillNames.length === expectedCount, 'Native skills complete', `${skillNames.length}/${expectedCount}`);
-  }
-  if (modeToCheck === 'mixed') {
-    addCheck(
-      false,
-      'Single command surface required',
-      'Both skills and prompt aliases found. Choose one mode and run install with --migrate.'
-    );
-  }
-  if (modeToCheck === 'none') {
-    addCheck(false, 'At least one command surface installed', 'No skills/ or prompts/ entries found');
+  addCheck(skillNames.length === expectedCount, 'Native skills complete', `${skillNames.length}/${expectedCount}`);
+  if (promptFiles.length > 0) {
+    addCheck(false, 'Legacy prompts/ detected', 'Run with --migrate to clean up');
   }
 
-  console.log(`  Verifying ${cyan}${locationLabel}${reset} (detected mode: ${cyan}${detectedMode}${reset}, check mode: ${cyan}${modeToCheck}${reset})`);
+  console.log(`  Verifying ${cyan}${locationLabel}${reset} (detected mode: ${cyan}${detectedMode}${reset})`);
   for (const check of checks) {
     const icon = check.ok ? `${green}✓${reset}` : `${yellow}✗${reset}`;
     const detail = check.detail ? ` ${dim}(${check.detail})${reset}` : '';
@@ -546,14 +444,12 @@ function verifyInstall(isGlobal, expectedMode, strictMode = false) {
     console.log(`\n  ${yellow}Integrity check failed.${reset}`);
   }
 
-  return { ok, detectedMode, checkedMode: modeToCheck };
+  return { ok, detectedMode };
 }
 
-function installCore(isGlobal, mode, migrationPlan, applyMigration, done = () => {}) {
+function installCore(isGlobal, migrationPlan, applyMigration, done = () => {}) {
   const src = path.join(__dirname, '..');
   const { codexDir, locationLabel, pathPrefix } = getInstallContext(isGlobal);
-  const installPromptsEnabled = mode === 'prompts';
-  const installSkillsEnabled = mode === 'skills';
 
   console.log(`  Installing to ${cyan}${locationLabel}${reset}\n`);
   fs.mkdirSync(codexDir, { recursive: true });
@@ -567,7 +463,7 @@ function installCore(isGlobal, mode, migrationPlan, applyMigration, done = () =>
 
   const writeAgents = () => {
     let agentsContent = applyReplacements(fs.readFileSync(agentsSrc, 'utf8'), pathPrefix);
-    agentsContent = adaptAgentsForCodexMode(agentsContent, mode);
+    agentsContent = adaptAgentsForCodexMode(agentsContent);
     fs.writeFileSync(agentsDest, agentsContent, 'utf8');
   };
 
@@ -579,7 +475,7 @@ function installCore(isGlobal, mode, migrationPlan, applyMigration, done = () =>
       console.log(`  ${dim}-${reset} Skipped .codex/config.toml (already exists or source missing)`);
     }
 
-    const agentCount = installAgentDefs(src, codexDir, pathPrefix, mode);
+    const agentCount = installAgentDefs(src, codexDir, pathPrefix);
     if (agentCount > 0) {
       console.log(`  ${green}✓${reset} Installed agents/gsd-*.md (${agentCount} agent definitions)`);
     }
@@ -588,17 +484,9 @@ function installCore(isGlobal, mode, migrationPlan, applyMigration, done = () =>
     const entries = fs.readdirSync(gsdSrc);
     const markdownEntries = entries.filter((entry) => entry.endsWith('.md'));
 
-    if (installPromptsEnabled) {
-      const promptsDir = path.join(codexDir, 'prompts');
-      installPrompts(gsdSrc, promptsDir, markdownEntries, pathPrefix);
-      console.log(`  ${green}✓${reset} Installed prompts/gsd-*.md (${markdownEntries.length} commands)`);
-    }
-
-    if (installSkillsEnabled) {
-      const skillsDir = path.join(codexDir, 'skills');
-      installCodexSkills(gsdSrc, skillsDir, markdownEntries, pathPrefix);
-      console.log(`  ${green}✓${reset} Installed skills/gsd-*/SKILL.md (${markdownEntries.length} skills)`);
-    }
+    const skillsDir = path.join(codexDir, 'skills');
+    installCodexSkills(gsdSrc, skillsDir, markdownEntries, pathPrefix);
+    console.log(`  ${green}✓${reset} Installed skills/gsd-*/SKILL.md (${markdownEntries.length} skills)`);
 
     const skillSrc = path.join(src, 'get-shit-done');
     const skillDest = path.join(codexDir, 'get-shit-done');
@@ -612,18 +500,17 @@ function installCore(isGlobal, mode, migrationPlan, applyMigration, done = () =>
 
   ${yellow}For Codex (CLI + Desktop):${reset}
   - AGENTS.md: ${cyan}${codexDir}/AGENTS.md${reset}
-  ${installPromptsEnabled ? `- Prompt commands: ${cyan}${codexDir}/prompts/${reset}` : ''}
-  ${installSkillsEnabled ? `- Native skills: ${cyan}${codexDir}/skills/gsd-*/SKILL.md${reset}` : ''}
+  - Native skills: ${cyan}${codexDir}/skills/gsd-*/SKILL.md${reset}
   - Config: ${cyan}${codexDir}/.codex/config.toml${reset}
   - Agent defs: ${cyan}${codexDir}/agents/gsd-*.md${reset}
 
   ${yellow}Getting Started:${reset}
   1. Run ${cyan}codex${reset} (CLI) or ${cyan}codex app${reset} (Desktop)
-  2. Use ${cyan}${installSkillsEnabled ? '$gsd-help' : '/prompts:gsd-help'}${reset} to list commands
-  3. Start with ${cyan}${installSkillsEnabled ? '$gsd-new-project' : '/prompts:gsd-new-project'}${reset}
+  2. Use ${cyan}$gsd-help${reset} to list commands
+  3. Start with ${cyan}$gsd-new-project${reset}
 
   ${yellow}Staying Updated:${reset}
-  - In Codex: ${cyan}${installSkillsEnabled ? '$gsd-update' : '/prompts:gsd-update'}${reset}
+  - In Codex: ${cyan}$gsd-update${reset}
   - In terminal: ${cyan}npx ${NPM_PACKAGE_LATEST}${reset}
 
   ${dim}Note: Codex will prompt you to trust this project on first run
@@ -659,12 +546,12 @@ function installCore(isGlobal, mode, migrationPlan, applyMigration, done = () =>
   }
 }
 
-function install(isGlobal, mode = codexMode, done = () => {}) {
+function install(isGlobal, done = () => {}) {
   const { codexDir } = getInstallContext(isGlobal);
-  const migrationPlan = detectMigrationPlan(codexDir, mode);
+  const migrationPlan = detectMigrationPlan(codexDir);
 
   if (!migrationPlan.hasChanges) {
-    installCore(isGlobal, mode, migrationPlan, false, done);
+    installCore(isGlobal, migrationPlan, false, done);
     return;
   }
 
@@ -673,20 +560,20 @@ function install(isGlobal, mode = codexMode, done = () => {}) {
 
   if (hasMigrate) {
     console.log(`  ${green}✓${reset} Migration approved by --migrate`);
-    installCore(isGlobal, mode, migrationPlan, true, done);
+    installCore(isGlobal, migrationPlan, true, done);
     return;
   }
 
   if (hasSkipMigrate) {
     console.log(`  ${yellow}Skipping migration due to --skip-migrate.${reset}`);
-    installCore(isGlobal, mode, migrationPlan, false, done);
+    installCore(isGlobal, migrationPlan, false, done);
     return;
   }
 
   if (!isInteractiveTerminal) {
     console.log(`  ${yellow}Skipping migration in non-interactive mode.${reset}`);
     console.log(`  ${dim}Re-run with --migrate to apply cleanup or --skip-migrate to keep legacy files explicitly.${reset}`);
-    installCore(isGlobal, mode, migrationPlan, false, done);
+    installCore(isGlobal, migrationPlan, false, done);
     return;
   }
 
@@ -702,36 +589,11 @@ function install(isGlobal, mode = codexMode, done = () => {}) {
     if (!applyMigration) {
       console.log(`  ${yellow}Keeping legacy files.${reset}`);
     }
-    installCore(isGlobal, mode, migrationPlan, applyMigration, done);
+    installCore(isGlobal, migrationPlan, applyMigration, done);
   });
 }
 
-function promptCodexMode(done) {
-  if (hasCodexModeArg || !isInteractiveTerminal) {
-    done(codexMode);
-    return;
-  }
-
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  console.log(`  ${yellow}Which command surface do you want?${reset}
 
-  ${cyan}1${reset}) Skills  ${dim}($gsd-*, recommended)${reset}
-  ${cyan}2${reset}) Prompts ${dim}(/prompts:gsd-*)${reset}
-`);
-
-  rl.question(`  Choice ${dim}[1]${reset}: `, (answer) => {
-    rl.close();
-    const normalized = answer.trim().toLowerCase();
-    const mode = normalized === '2' || normalized === 'prompt' || normalized === 'prompts'
-      ? 'prompts'
-      : 'skills';
-    done(mode);
-  });
-}
 
 function promptLocation(done) {
   const rl = readline.createInterface({
@@ -773,32 +635,26 @@ if (!hasNoVersionCheck && !hasVerify) {
 
 if (hasVerify) {
   const isGlobal = hasLocal ? false : true;
-  const strictMode = hasCodexModeArg;
-  let result = verifyInstall(isGlobal, codexMode, strictMode);
+  let result = verifyInstall(isGlobal);
 
   if (!result.ok && hasRepair) {
-    const repairMode = codexMode;
-    console.log(`\n  ${yellow}Repairing install using mode '${repairMode}'...${reset}\n`);
-    install(isGlobal, repairMode, () => {
+    console.log(`\n  ${yellow}Repairing install...${reset}\n`);
+    install(isGlobal, () => {
       console.log('');
-      const repaired = verifyInstall(isGlobal, repairMode, true);
+      const repaired = verifyInstall(isGlobal);
       process.exit(repaired.ok ? 0 : 1);
     });
   } else {
     process.exit(result.ok ? 0 : 1);
   }
 } else {
-  const installWithSelectedMode = (isGlobal) => {
-    promptCodexMode((selectedMode) => {
-      install(isGlobal, selectedMode);
-    });
-  };
-
   if (hasGlobal) {
-    installWithSelectedMode(true);
+    install(true);
   } else if (hasLocal) {
-    installWithSelectedMode(false);
+    install(false);
   } else {
-    promptLocation(installWithSelectedMode);
+    promptLocation((isGlobal) => {
+      install(isGlobal);
+    });
   }
 }

package/commands/gsd/add-tests.md

@@ -13,9 +13,10 @@ allowed-tools:
   - AskUserQuestion
 argument-instructions: |
   Parse the argument as a phase number (integer, decimal, or letter-suffix), plus optional free-text instructions.
-  Example: /gsd:add-tests 12
-  Example: /gsd:add-tests 12 focus on edge cases in the pricing module
+  Example: $gsd-add-tests 12
+  Example: $gsd-add-tests 12 focus on edge cases in the pricing module
 ---
+
 <objective>
 Generate unit and E2E tests for a completed phase, using its SUMMARY.md, CONTEXT.md, and VERIFICATION.md as specifications.
 
@@ -25,7 +26,7 @@ Output: Test files committed with message `test(phase-{N}): add unit and E2E tes
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/add-tests.md
+@~/.codex/get-shit-done/workflows/add-tests.md
 </execution_context>
 
 <context>
@@ -36,6 +37,6 @@ Phase: $ARGUMENTS
 </context>
 
 <process>
-Execute the add-tests workflow from @~/.claude/get-shit-done/workflows/add-tests.md end-to-end.
+Execute the add-tests workflow from @~/.codex/get-shit-done/workflows/add-tests.md end-to-end.
 Preserve all workflow gates (classification approval, test plan approval, RED-GREEN verification, gap reporting).
 </process>

package/commands/gsd/complete-milestone.md

@@ -42,19 +42,19 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
 0. **Check for audit:**
 
    - Look for `.planning/v{{version}}-MILESTONE-AUDIT.md`
-   - If missing or stale: recommend `/gsd:audit-milestone` first
-   - If audit status is `gaps_found`: recommend `/gsd:plan-milestone-gaps` first
+   - If missing or stale: recommend `$gsd-audit-milestone` first
+   - If audit status is `gaps_found`: recommend `$gsd-plan-milestone-gaps` first
    - If audit status is `passed`: proceed to step 1
 
    ```markdown
    ## Pre-flight Check
 
    {If no v{{version}}-MILESTONE-AUDIT.md:}
-   ⚠ No milestone audit found. Run `/gsd:audit-milestone` first to verify
+   ⚠ No milestone audit found. Run `$gsd-audit-milestone` first to verify
    requirements coverage, cross-phase integration, and E2E flows.
 
    {If audit has gaps:}
-   ⚠ Milestone audit found gaps. Run `/gsd:plan-milestone-gaps` to create
+   ⚠ Milestone audit found gaps. Run `$gsd-plan-milestone-gaps` to create
    phases that close the gaps, or proceed anyway to accept as tech debt.
 
    {If audit passed:}
@@ -108,7 +108,7 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
    - Ask about pushing tag
 
 8. **Offer next steps:**
-   - `/gsd:new-milestone` — start next milestone (questioning → research → requirements → roadmap)
+   - `$gsd-new-milestone` — start next milestone (questioning → research → requirements → roadmap)
 
 </process>
 
@@ -132,5 +132,5 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
 - **Archive before deleting:** Always create archive files before updating/deleting originals
 - **One-line summary:** Collapsed milestone in ROADMAP.md should be single line with link
 - **Context efficiency:** Archive keeps ROADMAP.md and REQUIREMENTS.md constant size per milestone
-- **Fresh requirements:** Next milestone starts with `/gsd:new-milestone` which includes requirements definition
+- **Fresh requirements:** Next milestone starts with `$gsd-new-milestone` which includes requirements definition
   </critical_rules>

package/commands/gsd/debug.md

@@ -104,7 +104,7 @@ Task(
 - Display root cause and evidence summary
 - Offer options:
   - "Fix now" - spawn fix subagent
-  - "Plan fix" - suggest /gsd:plan-phase --gaps
+  - "Plan fix" - suggest $gsd-plan-phase --gaps
   - "Manual fix" - done
 
 **If `## CHECKPOINT REACHED`:**

package/commands/gsd/map-codebase.md

@@ -30,8 +30,8 @@ Focus area: $ARGUMENTS (optional - if provided, tells agents to focus on specifi
 Check for .planning/STATE.md - loads context if project already initialized
 
 **This command can run:**
-- Before /gsd:new-project (brownfield codebases) - creates codebase map first
-- After /gsd:new-project (greenfield codebases) - updates codebase map as code evolves
+- Before $gsd-new-project (brownfield codebases) - creates codebase map first
+- After $gsd-new-project (greenfield codebases) - updates codebase map as code evolves
 - Anytime to refresh codebase understanding
 </context>
 
@@ -59,7 +59,7 @@ Check for .planning/STATE.md - loads context if project already initialized
 4. Wait for agents to complete, collect confirmations (NOT document contents)
 5. Verify all 7 documents exist with line counts
 6. Commit codebase map
-7. Offer next steps (typically: /gsd:new-project or /gsd:plan-phase)
+7. Offer next steps (typically: $gsd-new-project or $gsd-plan-phase)
 </process>
 
 <success_criteria>

package/commands/gsd/new-milestone.md

@@ -21,7 +21,7 @@ Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Ga
 - `.planning/ROADMAP.md` — phase structure (continues numbering)
 - `.planning/STATE.md` — reset for new milestone
 
-**After:** `/gsd:plan-phase [N]` to start execution.
+**After:** `$gsd-plan-phase [N]` to start execution.
 </objective>
 
 <execution_context>

package/commands/gsd/new-project.md

@@ -25,7 +25,7 @@ Initialize a new project through unified flow: questioning → research (optiona
 - `.planning/ROADMAP.md` — phase structure
 - `.planning/STATE.md` — project memory
 
-**After this command:** Run `/gsd:plan-phase 1` to start execution.
+**After this command:** Run `$gsd-plan-phase 1` to start execution.
 </objective>
 
 <execution_context>

package/commands/gsd/plan-milestone-gaps.md

@@ -10,11 +10,11 @@ allowed-tools:
   - AskUserQuestion
 ---
 <objective>
-Create all phases necessary to close gaps identified by `/gsd:audit-milestone`.
+Create all phases necessary to close gaps identified by `$gsd-audit-milestone`.
 
 Reads MILESTONE-AUDIT.md, groups gaps into logical phases, creates phase entries in ROADMAP.md, and offers to plan each phase.
 
-One command creates all fix phases — no manual `/gsd:add-phase` per gap.
+One command creates all fix phases — no manual `$gsd-add-phase` per gap.
 </objective>
 
 <execution_context>

package/commands/gsd/reapply-patches.md

@@ -28,7 +28,7 @@ Read `backup-meta.json` from the patches directory.
 ```
 No local patches found. Nothing to reapply.
 
-Local patches are automatically saved when you run /gsd:update
+Local patches are automatically saved when you run $gsd-update
 after modifying any GSD workflow, command, or agent files.
 ```
 Exit.
@@ -76,7 +76,7 @@ For each file in `backup-meta.json`:
 After reapplying, regenerate the file manifest so future updates correctly detect these as user modifications:
 
 ```bash
-# The manifest will be regenerated on next /gsd:update
+# The manifest will be regenerated on next $gsd-update
 # For now, just note which files were modified
 ```
 

package/commands/gsd/research-phase.md

@@ -1,6 +1,6 @@
 ---
 name: gsd:research-phase
-description: Research how to implement a phase (standalone - usually use /gsd:plan-phase instead)
+description: Research how to implement a phase (standalone - usually use $gsd-plan-phase instead)
 argument-hint: "[phase]"
 allowed-tools:
   - Read
@@ -11,7 +11,7 @@ allowed-tools:
 <objective>
 Research how to implement a phase. Spawns gsd-phase-researcher agent with phase context.
 
-**Note:** This is a standalone research command. For most workflows, use `/gsd:plan-phase` which integrates research automatically.
+**Note:** This is a standalone research command. For most workflows, use `$gsd-plan-phase` which integrates research automatically.
 
 **Use this command when:**
 - You want to research without planning yet
@@ -109,7 +109,7 @@ Mode: ecosystem
 </additional_context>
 
 <downstream_consumer>
-Your RESEARCH.md will be loaded by `/gsd:plan-phase` which uses specific sections:
+Your RESEARCH.md will be loaded by `$gsd-plan-phase` which uses specific sections:
 - `## Standard Stack` → Plans use these libraries
 - `## Architecture Patterns` → Task structure follows these
 - `## Don't Hand-Roll` → Tasks NEVER build custom solutions for listed problems

package/commands/gsd/verify-work.md

@@ -16,7 +16,7 @@ Validate built features through conversational testing with persistent state.
 
 Purpose: Confirm what Codex 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_num}-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>

package/get-shit-done/bin/lib/commands.cjs

@@ -497,7 +497,7 @@ function cmdScaffold(cwd, type, options, raw) {
   switch (type) {
     case 'context': {
       filePath = path.join(phaseDir, `${padded}-CONTEXT.md`);
-      content = `---\nphase: "${padded}"\nname: "${name || phaseInfo?.phase_name || 'Unnamed'}"\ncreated: ${today}\n---\n\n# Phase ${phase}: ${name || phaseInfo?.phase_name || 'Unnamed'} — Context\n\n## Decisions\n\n_Decisions will be captured during /gsd:discuss-phase ${phase}_\n\n## Discretion Areas\n\n_Areas where the executor can use judgment_\n\n## Deferred Ideas\n\n_Ideas to consider later_\n`;
+      content = `---\nphase: "${padded}"\nname: "${name || phaseInfo?.phase_name || 'Unnamed'}"\ncreated: ${today}\n---\n\n# Phase ${phase}: ${name || phaseInfo?.phase_name || 'Unnamed'} — Context\n\n## Decisions\n\n_Decisions will be captured during $gsd-discuss-phase ${phase}_\n\n## Discretion Areas\n\n_Areas where the executor can use judgment_\n\n## Deferred Ideas\n\n_Ideas to consider later_\n`;
       break;
     }
     case 'uat': {