gsd-codex-cli 1.20.6 → 1.20.8

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Add phase to end of current milestone in roadmap
 - 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 the user input.
+1. Parse <description> from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init phase-op "0" --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Capture idea or task as todo from current conversation context
 - 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 the user input.
+1. Parse [optional description] from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init todos [argument] --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Audit milestone completion against original intent before archiving
 - 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 the user input.
+1. Parse "[version]" from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init milestone-op --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ List pending todos and select one to work on
 - 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 the user input.
+1. Parse [area filter] from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init todos [argument] --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Archive completed milestone and prepare for next 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 the user input.
+1. Parse <version> from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init execute-phase "1" --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Systematic debugging with persistent state across context resets
 - 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 the user input.
+1. Parse [issue description] from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> state load --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Gather phase context through adaptive questioning before planning
 - 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 the user input.
+1. Parse "<phase>" from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init phase-op [argument] --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -25,27 +28,34 @@ Execute all plans in a phase with wave-based parallelization
 - 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."
+## Input contract
+- The command argument is authoritative.
+- If user runs `gsd-execute-phase 28`, execute phase `28`. Do not auto-discover a different phase.
+- 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.
+- 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.
 
 ## Execution
-1. Parse "<phase-number> [--gaps-only]" from the user input.
-2. Run init:
-node <gsd-tools-path> init execute-phase [phase] --raw
-
-3. Load .claude/get-shit-done/workflows/execute-phase.md and execute it step-by-step.
-4. Translate each Task(...) in workflow into:
+1. Parse "<phase-number> [--gaps-only] [--auto]" from command argument text, or extract from the latest user message.
+2. Treat parsed phase as the execution target and keep it unchanged for all downstream steps.
+3. Run init with the parsed phase:
+node <gsd-tools-path> init execute-phase <phase> --raw
+4. If `--gaps-only` is present, apply gap-closure filtering exactly as defined in the upstream workflow.
+5. If `--auto` is present, preserve auto-advance behavior from the upstream workflow.
+6. Load .claude/get-shit-done/workflows/execute-phase.md and execute it step-by-step.
+7. Translate each Task(...) in workflow into:
    - spawn_agent with the matching role file context from .claude/agents/.
    - wait for each spawned agent and apply returned output before moving forward.
-5. Preserve all gates and routing from upstream workflow.
-6. Preserve commit behavior using 
+8. Preserve all gates and routing from upstream workflow.
+9. Preserve commit behavior using
 node <gsd-tools-path> commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+10. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
 
 ## Completion output
 - Summarize key artifacts created/updated.
-- Next recommended command: `gsd-verify-work [phase]` (Codex) / `/gsd:verify-work [phase]` (Claude)
+- Next recommended command: `gsd-verify-work <phase>` (Codex) / `/gsd:verify-work <phase>` (Claude)
 - Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Show available GSD commands and usage guide
 - 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 [none] from the user input.
+1. No positional argument is required. Read flags from command text if present.
 2. Run init:
 # No explicit init.
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Insert urgent work as decimal phase (for example 72.1) between existing phases
 - 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 the user input.
+1. Parse <after> <description> from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init phase-op [after-phase] --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Surface Claude's assumptions about a phase approach before planning
 - 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 the user input.
+1. Parse "[phase]" from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init phase-op [argument] --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Analyze codebase with parallel mapper agents to produce .planning/codebase/ docu
 - 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 the user input.
+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:
 node <gsd-tools-path> init map-codebase --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Start a new milestone cycle — update PROJECT.md and route to requirements
 - 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 the user input.
+1. Parse "[milestone name, for example v1.1 Notifications]" from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init new-milestone --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Initialize a new project with deep context gathering and PROJECT.md
 - 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 the user input.
+1. Parse "[--auto]" from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init new-project --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Create context handoff when pausing work mid-phase
 - 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 [none] from the user input.
+1. No positional argument is required. Read flags from command text if present.
 2. Run init:
 node <gsd-tools-path> state load --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Create phases to close all gaps identified by milestone audit
 - 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 [none] from the user input.
+1. No positional argument is required. Read flags from command text if present.
 2. Run init:
 node <gsd-tools-path> init milestone-op --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Create detailed execution plan for a phase (PLAN.md) with verification loop
 - 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 the user input.
+1. Parse "[phase] [--research] [--skip-research] [--gaps] [--skip-verify]" from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init plan-phase [phase] --include state,roadmap,requirements,context,research,verification,uat --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Check project progress, show context, and route to next action
 - 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 [none] from the user input.
+1. No positional argument is required. Read flags from command text if present.
 2. Run init:
 node <gsd-tools-path> init progress --include state,roadmap,project,config --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Execute a quick task with GSD guarantees (atomic commits, state tracking) but sk
 - 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 [none] from the user input.
+1. No positional argument is required. Read flags from command text if present.
 2. Run init:
 node <gsd-tools-path> init quick "[argument]" --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Remove a future phase from roadmap and renumber subsequent phases
 - 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 the user input.
+1. Parse <phase-number> from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init phase-op [argument] --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Research how to implement a phase (standalone - usually use plan-phase instead)
 - 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 the user input.
+1. Parse "[phase]" from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init phase-op [argument] --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Resume work from previous session with full context restoration
 - 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 [none] from the user input.
+1. No positional argument is required. Read flags from command text if present.
 2. Run init:
 node <gsd-tools-path> init resume --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Switch model profile for GSD agents (quality/balanced/budget)
 - 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 the user input.
+1. Parse <profile> from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> state load --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Configure GSD workflow toggles and model profile
 - 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 [none] from the user input.
+1. No positional argument is required. Read flags from command text if present.
 2. Run init:
 node <gsd-tools-path> config-ensure-section --raw
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Update GSD to latest version with changelog display
 - 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 [none] from the user input.
+1. No positional argument is required. Read flags from command text if present.
 2. Run init:
 # No explicit init.
 

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

@@ -15,8 +15,11 @@ 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> ...`.
 - 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.
+- If a required argument is still missing after extraction, ask one concise clarification question.
 
 ## Subagent lifecycle (required)
 
@@ -32,7 +35,7 @@ Validate built features through conversational UAT
 - 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 the user input.
+1. Parse "[phase number, for example 4]" from command argument text or the latest user message (natural language allowed).
 2. Run init:
 node <gsd-tools-path> init verify-work [phase] --raw
 

package/.codex/skills/get-shit-done-codex/references/compat.md

@@ -9,10 +9,12 @@
 - `C:/Users/Ahmed/.claude/get-shit-done/...` → `.claude/get-shit-done/...`
 - `C:/Users/Ahmed/.claude/agents/...` → `.claude/agents/...`
 
-## CLI mapping
-- Use `node .claude/get-shit-done/bin/gsd-tools.js ...`.
-- Keep `--raw` when upstream workflow uses it.
-- Parse JSON by `ConvertFrom-Json`.
+## CLI mapping
+- Use `node .claude/get-shit-done/bin/gsd-tools.js ...`.
+- Keep `--raw` when upstream workflow uses it.
+- Parse JSON by `ConvertFrom-Json`.
+- Do not assign `node <path> <args>` into a single PowerShell string and invoke `& $cmd`.
+- Use direct invocation: `node <path> ...` or `& node <path> ...`.
 
 ## Subagent mapping
 - `subagent_type=gsd-*` maps to equivalent role contract in `.claude/agents/gsd-*.md`.

package/.codex/skills/get-shit-done-codex/references/windows.md

@@ -7,17 +7,31 @@ $raw = & node .claude/get-shit-done/bin/gsd-tools.js state load --raw
 $data = $raw | ConvertFrom-Json
 ```
 
-## Key/value parse
-
-```powershell
-$raw = & node .claude/get-shit-done/bin/gsd-tools.js state load --raw
-$out = @{}
+## Key/value parse
+
+```powershell
+$raw = & node .claude/get-shit-done/bin/gsd-tools.js state load --raw
+$out = @{}
 $raw -split "`n" | ForEach-Object {
   if ($_ -match '^(.*?)=(.*)$') { $out[$Matches[1]] = $Matches[2] }
-}
-```
-
-## Syntax notes
-- Replace jq with `ConvertFrom-Json`.
-- Avoid bash-only heredocs and command substitution.
-- Use quoted paths for PowerShell compatibility.
+}
+```
+
+## Command invocation (important)
+
+```powershell
+# Good: path is separate from the command
+$gsd = ".claude/get-shit-done/bin/gsd-tools.js"
+$raw = & node $gsd init execute-phase 28 --raw
+```
+
+```powershell
+# Bad: this fails because PowerShell treats it as one command token
+$cmd = "node .claude/get-shit-done/bin/gsd-tools.js"
+$raw = & $cmd init execute-phase 28 --raw
+```
+
+## Syntax notes
+- Replace jq with `ConvertFrom-Json`.
+- Avoid bash-only heredocs and command substitution.
+- Use quoted paths for PowerShell compatibility.

package/package.json

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