gsd-codex-cli 1.20.8 → 1.20.10

package/.codex/prompts/gsd-add-phase.md

@@ -3,6 +3,8 @@ description: Add phase to end of current milestone in roadmap
 argument-hint: <description>
 ---
 
+$ARGUMENTS
+
 ## Objective
 Add phase to end of current milestone in roadmap
 
@@ -15,7 +17,7 @@ Add phase to end of current milestone in roadmap
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Add phase to end of current milestone in roadmap
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse <description> from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-add-todo.md

@@ -3,6 +3,8 @@ description: Capture idea or task as todo from current conversation context
 argument-hint: [optional description]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Capture idea or task as todo from current conversation context
 
@@ -15,7 +17,7 @@ Capture idea or task as todo from current conversation context
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Capture idea or task as todo from current conversation context
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse [optional description] from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-audit-milestone.md

@@ -3,6 +3,8 @@ description: Audit milestone completion against original intent before archiving
 argument-hint: "[version]"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Audit milestone completion against original intent before archiving
 
@@ -15,7 +17,7 @@ Audit milestone completion against original intent before archiving
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Audit milestone completion against original intent before archiving
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse "[version]" from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-check-todos.md

@@ -3,6 +3,8 @@ description: List pending todos and select one to work on
 argument-hint: [area filter]
 ---
 
+$ARGUMENTS
+
 ## Objective
 List pending todos and select one to work on
 
@@ -15,7 +17,7 @@ List pending todos and select one to work on
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ List pending todos and select one to work on
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse [area filter] from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-complete-milestone.md

@@ -3,6 +3,8 @@ description: Archive completed milestone and prepare for next version
 argument-hint: <version>
 ---
 
+$ARGUMENTS
+
 ## Objective
 Archive completed milestone and prepare for next version
 
@@ -15,7 +17,7 @@ Archive completed milestone and prepare for next version
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Archive completed milestone and prepare for next version
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse <version> from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-debug.md

@@ -3,6 +3,8 @@ description: Systematic debugging with persistent state across context resets
 argument-hint: [issue description]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Systematic debugging with persistent state across context resets
 
@@ -15,7 +17,7 @@ Systematic debugging with persistent state across context resets
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Systematic debugging with persistent state across context resets
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse [issue description] from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-discuss-phase.md

@@ -3,6 +3,8 @@ description: Gather phase context through adaptive questioning before planning
 argument-hint: "<phase>"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Gather phase context through adaptive questioning before planning
 
@@ -15,7 +17,7 @@ Gather phase context through adaptive questioning before planning
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Gather phase context through adaptive questioning before planning
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse "<phase>" from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-doctor.md

@@ -1,8 +1,12 @@
----
-description: Diagnose Codex+Claude GSD installation (engine, prompts, versions)
-argument-hint: [none]
----## Objective
-Diagnose whether this project is set up to run GSD prompts in Codex while remaining compatible with Claude workflows on the same `.planning/` milestone/phases.
+---
+description: Diagnose Codex+Claude GSD installation (engine, prompts, versions)
+argument-hint: [none]
+---
+
+$ARGUMENTS
+
+## Objective
+Diagnose whether this project is set up to run GSD prompts in Codex while remaining compatible with Claude workflows on the same `.planning/` milestone/phases.
 
 ## Compatibility
 - Use .codex/skills/get-shit-done-codex semantics.
@@ -24,13 +28,15 @@ Run these checks and then present a compact table: `check | status | details | f
 - `.claude/get-shit-done/bin/gsd-tools.cjs` OR `.claude/get-shit-done/bin/gsd-tools.js`
 - If only `gsd-tools.test.js` exists, treat engine as missing/incomplete.
 
-### Project state
-- `.planning/` exists (if missing, user hasn’t initialized a project).
-
-### Update availability (best-effort)
-- Latest Codex fork version (do not fail if offline):
-  - `npm view gsd-codex-cli version`
-- If installed Codex fork version is known and differs from latest, surface:
+### Project state
+- `.planning/` exists (if missing, user hasn’t initialized a project).
+
+## Update check
+- Best-effort only; do not fail if offline.
+### Update availability (best-effort)
+- Latest Codex fork version (do not fail if offline):
+  - `npm view gsd-codex-cli version`
+- If installed Codex fork version is known and differs from latest, surface:
   - `Update available: {installed} -> {latest}`
   - Next: `gsd-update` (Codex) / `/gsd:update` (Claude) or re-run `npx gsd-codex-cli@latest`.
 

package/.codex/prompts/gsd-execute-phase.md

@@ -3,6 +3,8 @@ description: Execute all plans in a phase with wave-based parallelization
 argument-hint: "<phase-number> [--gaps-only]"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Execute all plans in a phase with wave-based parallelization
 
@@ -15,7 +17,7 @@ Execute all plans in a phase with wave-based parallelization
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -34,7 +36,7 @@ Execute all plans in a phase with wave-based parallelization
 - Parse phase from either:
   - the explicit command argument tail, or
   - the latest user message (for example: "execute phase 28").
-- Accept first token matching `^\d+(\.\d+)?$` as the phase number.
+- Accept the first numeric token as phase number (integer or decimal, e.g., 30 or 30.1).
 - Parse flags `--gaps-only` and `--auto` from the same input text when present.
 - Do not claim "phase missing" when the latest user input already contains a valid phase token.
 - Only ask for input if no valid phase token is found anywhere in the latest user request.

package/.codex/prompts/gsd-help.md

@@ -3,6 +3,8 @@ description: Show available GSD commands and usage guide
 argument-hint: [none]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Show available GSD commands and usage guide
 
@@ -15,7 +17,7 @@ Show available GSD commands and usage guide
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Show available GSD commands and usage guide
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. No positional argument is required. Read flags from command text if present.
 2. Run init:

package/.codex/prompts/gsd-insert-phase.md

@@ -3,6 +3,8 @@ description: Insert urgent work as decimal phase (for example 72.1) between exis
 argument-hint: <after> <description>
 ---
 
+$ARGUMENTS
+
 ## Objective
 Insert urgent work as decimal phase (for example 72.1) between existing phases
 
@@ -15,7 +17,7 @@ Insert urgent work as decimal phase (for example 72.1) between existing phases
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Insert urgent work as decimal phase (for example 72.1) between existing phases
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse <after> <description> from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-list-phase-assumptions.md

@@ -3,6 +3,8 @@ description: Surface Claude's assumptions about a phase approach before planning
 argument-hint: "[phase]"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Surface Claude's assumptions about a phase approach before planning
 
@@ -15,7 +17,7 @@ Surface Claude's assumptions about a phase approach before planning
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Surface Claude's assumptions about a phase approach before planning
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse "[phase]" from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-map-codebase.md

@@ -3,6 +3,8 @@ description: Analyze codebase with parallel mapper agents to produce .planning/c
 argument-hint: "[optional: specific area to map, for example api or auth]"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
 
@@ -15,7 +17,7 @@ Analyze codebase with parallel mapper agents to produce .planning/codebase/ docu
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Analyze codebase with parallel mapper agents to produce .planning/codebase/ docu
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse "[optional: specific area to map, for example api or auth]" from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-new-milestone.md

@@ -3,6 +3,8 @@ description: Start a new milestone cycle — update PROJECT.md and route to requ
 argument-hint: "[milestone name, for example v1.1 Notifications]"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Start a new milestone cycle — update PROJECT.md and route to requirements
 
@@ -15,7 +17,7 @@ Start a new milestone cycle — update PROJECT.md and route to requirements
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Start a new milestone cycle — update PROJECT.md and route to requirements
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse "[milestone name, for example v1.1 Notifications]" from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-new-project.md

@@ -3,6 +3,8 @@ description: Initialize a new project with deep context gathering and PROJECT.md
 argument-hint: "[--auto]"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Initialize a new project with deep context gathering and PROJECT.md
 
@@ -15,7 +17,7 @@ Initialize a new project with deep context gathering and PROJECT.md
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Initialize a new project with deep context gathering and PROJECT.md
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse "[--auto]" from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-pause-work.md

@@ -3,6 +3,8 @@ description: Create context handoff when pausing work mid-phase
 argument-hint: [none]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Create context handoff when pausing work mid-phase
 
@@ -15,7 +17,7 @@ Create context handoff when pausing work mid-phase
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Create context handoff when pausing work mid-phase
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. No positional argument is required. Read flags from command text if present.
 2. Run init:

package/.codex/prompts/gsd-plan-milestone-gaps.md

@@ -3,6 +3,8 @@ description: Create phases to close all gaps identified by milestone audit
 argument-hint: [none]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Create phases to close all gaps identified by milestone audit
 
@@ -15,7 +17,7 @@ Create phases to close all gaps identified by milestone audit
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Create phases to close all gaps identified by milestone audit
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. No positional argument is required. Read flags from command text if present.
 2. Run init:

package/.codex/prompts/gsd-plan-phase.md

@@ -3,6 +3,8 @@ description: Create detailed execution plan for a phase (PLAN.md) with verificat
 argument-hint: "[phase] [--research] [--skip-research] [--gaps] [--skip-verify]"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Create detailed execution plan for a phase (PLAN.md) with verification loop
 
@@ -15,7 +17,7 @@ Create detailed execution plan for a phase (PLAN.md) with verification loop
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Create detailed execution plan for a phase (PLAN.md) with verification loop
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse "[phase] [--research] [--skip-research] [--gaps] [--skip-verify]" from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-progress.md

@@ -3,6 +3,8 @@ description: Check project progress, show context, and route to next action
 argument-hint: [none]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Check project progress, show context, and route to next action
 
@@ -15,7 +17,7 @@ Check project progress, show context, and route to next action
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Check project progress, show context, and route to next action
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. No positional argument is required. Read flags from command text if present.
 2. Run init:

package/.codex/prompts/gsd-quick.md

@@ -3,6 +3,8 @@ description: Execute a quick task with GSD guarantees (atomic commits, state tra
 argument-hint: [none]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
 
@@ -15,7 +17,7 @@ Execute a quick task with GSD guarantees (atomic commits, state tracking) but sk
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Execute a quick task with GSD guarantees (atomic commits, state tracking) but sk
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. No positional argument is required. Read flags from command text if present.
 2. Run init:

package/.codex/prompts/gsd-remove-phase.md

@@ -3,6 +3,8 @@ description: Remove a future phase from roadmap and renumber subsequent phases
 argument-hint: <phase-number>
 ---
 
+$ARGUMENTS
+
 ## Objective
 Remove a future phase from roadmap and renumber subsequent phases
 
@@ -15,7 +17,7 @@ Remove a future phase from roadmap and renumber subsequent phases
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Remove a future phase from roadmap and renumber subsequent phases
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse <phase-number> from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-research-phase.md

@@ -3,6 +3,8 @@ description: Research how to implement a phase (standalone - usually use plan-ph
 argument-hint: "[phase]"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Research how to implement a phase (standalone - usually use plan-phase instead)
 
@@ -15,7 +17,7 @@ Research how to implement a phase (standalone - usually use plan-phase instead)
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Research how to implement a phase (standalone - usually use plan-phase instead)
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse "[phase]" from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-resume-work.md

@@ -3,6 +3,8 @@ description: Resume work from previous session with full context restoration
 argument-hint: [none]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Resume work from previous session with full context restoration
 
@@ -15,7 +17,7 @@ Resume work from previous session with full context restoration
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Resume work from previous session with full context restoration
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. No positional argument is required. Read flags from command text if present.
 2. Run init:

package/.codex/prompts/gsd-set-profile.md

@@ -3,6 +3,8 @@ description: Switch model profile for GSD agents (quality/balanced/budget)
 argument-hint: <profile>
 ---
 
+$ARGUMENTS
+
 ## Objective
 Switch model profile for GSD agents (quality/balanced/budget)
 
@@ -15,7 +17,7 @@ Switch model profile for GSD agents (quality/balanced/budget)
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Switch model profile for GSD agents (quality/balanced/budget)
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse <profile> from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/.codex/prompts/gsd-settings.md

@@ -3,6 +3,8 @@ description: Configure GSD workflow toggles and model profile
 argument-hint: [none]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Configure GSD workflow toggles and model profile
 
@@ -15,7 +17,7 @@ Configure GSD workflow toggles and model profile
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Configure GSD workflow toggles and model profile
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. No positional argument is required. Read flags from command text if present.
 2. Run init:

package/.codex/prompts/gsd-update.md

@@ -3,6 +3,8 @@ description: Update GSD to latest version with changelog display
 argument-hint: [none]
 ---
 
+$ARGUMENTS
+
 ## Objective
 Update GSD to latest version with changelog display
 
@@ -15,7 +17,7 @@ Update GSD to latest version with changelog display
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.

package/.codex/prompts/gsd-verify-work.md

@@ -3,6 +3,8 @@ description: Validate built features through conversational UAT
 argument-hint: "[phase number, for example 4]"
 ---
 
+$ARGUMENTS
+
 ## Objective
 Validate built features through conversational UAT
 
@@ -15,7 +17,7 @@ Validate built features through conversational UAT
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
-- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Do not set `node <path> ...` as one string variable and invoke `& <cmd_var>`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 - Accept natural-language command input; do not require an exact literal argument template.
@@ -28,12 +30,6 @@ Validate built features through conversational UAT
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
 
-## Update check
-- Best-effort only; do not fail if offline.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, surface: "Update available: <installed> -> <latest>. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
-
 ## Execution
 1. Parse "[phase number, for example 4]" from command argument text or the latest user message (natural language allowed).
 2. Run init:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-codex-cli",
-  "version": "1.20.8",
+  "version": "1.20.10",
   "description": "Codex-native package for the get-shit-done workflow with native subagent orchestration.",
   "bin": {
     "gsd-codex-cli": "bin/install-codex.js",