gsd-codex-cli 1.20.5 → 1.20.7

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

@@ -3,8 +3,6 @@ description: Add phase to end of current milestone in roadmap
 argument-hint: <description>
 ---
 
-
-
 ## Objective
 Add phase to end of current milestone in roadmap
 
@@ -12,11 +10,12 @@ Add phase to end of current milestone in roadmap
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Use one of these engine paths (prefer local, fallback global):
-  node .claude/get-shit-done/bin/gsd-tools.js ...
-  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
-- If `.js` is unavailable, use the same path with `.cjs`.
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  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.
 
@@ -26,12 +25,13 @@ Add phase to end of current milestone in roadmap
 - Spawn only when the upstream workflow defines an agent role.
 - 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."
-
+
+## 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 the user input.
 2. Run init:
@@ -44,9 +44,9 @@ node <gsd-tools-path> init phase-op "0" --raw
 5. Preserve all gates and routing from upstream workflow.
 6. 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.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+7. 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: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -3,8 +3,6 @@ description: Capture idea or task as todo from current conversation context
 argument-hint: [optional description]
 ---
 
-
-
 ## Objective
 Capture idea or task as todo from current conversation context
 
@@ -12,11 +10,12 @@ Capture idea or task as todo from current conversation context
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Use one of these engine paths (prefer local, fallback global):
-  node .claude/get-shit-done/bin/gsd-tools.js ...
-  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
-- If `.js` is unavailable, use the same path with `.cjs`.
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  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.
 
@@ -26,12 +25,13 @@ Capture idea or task as todo from current conversation context
 - Spawn only when the upstream workflow defines an agent role.
 - 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."
-
+
+## 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 the user input.
 2. Run init:
@@ -44,9 +44,9 @@ node <gsd-tools-path> init todos [argument] --raw
 5. Preserve all gates and routing from upstream workflow.
 6. 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.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+7. 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: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -3,8 +3,6 @@ description: Audit milestone completion against original intent before archiving
 argument-hint: "[version]"
 ---
 
-
-
 ## Objective
 Audit milestone completion against original intent before archiving
 
@@ -12,11 +10,12 @@ Audit milestone completion against original intent before archiving
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Use one of these engine paths (prefer local, fallback global):
-  node .claude/get-shit-done/bin/gsd-tools.js ...
-  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
-- If `.js` is unavailable, use the same path with `.cjs`.
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  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.
 
@@ -26,12 +25,13 @@ Audit milestone completion against original intent before archiving
 - Spawn only when the upstream workflow defines an agent role.
 - 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."
-
+
+## 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 the user input.
 2. Run init:
@@ -44,9 +44,9 @@ node <gsd-tools-path> init milestone-op --raw
 5. Preserve all gates and routing from upstream workflow.
 6. 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.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+7. 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: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -3,8 +3,6 @@ description: List pending todos and select one to work on
 argument-hint: [area filter]
 ---
 
-
-
 ## Objective
 List pending todos and select one to work on
 
@@ -12,11 +10,12 @@ List pending todos and select one to work on
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Use one of these engine paths (prefer local, fallback global):
-  node .claude/get-shit-done/bin/gsd-tools.js ...
-  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
-- If `.js` is unavailable, use the same path with `.cjs`.
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  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.
 
@@ -26,12 +25,13 @@ List pending todos and select one to work on
 - Spawn only when the upstream workflow defines an agent role.
 - 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."
-
+
+## 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 the user input.
 2. Run init:
@@ -44,9 +44,9 @@ node <gsd-tools-path> init todos [argument] --raw
 5. Preserve all gates and routing from upstream workflow.
 6. 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.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+7. 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: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -3,8 +3,6 @@ description: Archive completed milestone and prepare for next version
 argument-hint: <version>
 ---
 
-
-
 ## Objective
 Archive completed milestone and prepare for next version
 
@@ -12,11 +10,12 @@ Archive completed milestone and prepare for next version
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Use one of these engine paths (prefer local, fallback global):
-  node .claude/get-shit-done/bin/gsd-tools.js ...
-  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
-- If `.js` is unavailable, use the same path with `.cjs`.
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  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.
 
@@ -26,12 +25,13 @@ Archive completed milestone and prepare for next version
 - Spawn only when the upstream workflow defines an agent role.
 - 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."
-
+
+## 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 the user input.
 2. Run init:
@@ -44,9 +44,9 @@ node <gsd-tools-path> init execute-phase "1" --raw
 5. Preserve all gates and routing from upstream workflow.
 6. 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.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+7. 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: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -3,8 +3,6 @@ description: Systematic debugging with persistent state across context resets
 argument-hint: [issue description]
 ---
 
-
-
 ## Objective
 Systematic debugging with persistent state across context resets
 
@@ -12,11 +10,12 @@ Systematic debugging with persistent state across context resets
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Use one of these engine paths (prefer local, fallback global):
-  node .claude/get-shit-done/bin/gsd-tools.js ...
-  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
-- If `.js` is unavailable, use the same path with `.cjs`.
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  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.
 
@@ -26,12 +25,13 @@ Systematic debugging with persistent state across context resets
 - Spawn only when the upstream workflow defines an agent role.
 - 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."
-
+
+## 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 the user input.
 2. Run init:
@@ -47,9 +47,9 @@ node <gsd-tools-path> commit "message" --files ....
 7. Checkpoint handling:
    - If an active debug session exists and no new issue was provided, list open sessions and ask the user which to resume.
    - If a checkpoint is returned by the debugger, summarize the checkpoint and continue only after user confirmation.
-8. 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: use the next user-facing GSD command (Codex prompt name + Claude slash command).
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+8. 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: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -3,8 +3,6 @@ description: Gather phase context through adaptive questioning before planning
 argument-hint: "<phase>"
 ---
 
-
-
 ## Objective
 Gather phase context through adaptive questioning before planning
 
@@ -12,11 +10,12 @@ Gather phase context through adaptive questioning before planning
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Use one of these engine paths (prefer local, fallback global):
-  node .claude/get-shit-done/bin/gsd-tools.js ...
-  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
-- If `.js` is unavailable, use the same path with `.cjs`.
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  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.
 
@@ -26,12 +25,13 @@ Gather phase context through adaptive questioning before planning
 - Spawn only when the upstream workflow defines an agent role.
 - 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."
-
+
+## 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 the user input.
 2. Run init:
@@ -44,9 +44,9 @@ node <gsd-tools-path> init phase-op [argument] --raw
 5. Preserve all gates and routing from upstream workflow.
 6. 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.
-
-## Completion output
-- Summarize key artifacts created/updated.
-- Next recommended command: `gsd-plan-phase [phase]` (Codex) / `/gsd:plan-phase [phase]` (Claude)
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+7. 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-plan-phase [phase]` (Codex) / `/gsd:plan-phase [phase]` (Claude)
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -1,51 +1,46 @@
----
-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.
-
-## Compatibility
-- Use .codex/skills/get-shit-done-codex semantics.
-- Do not modify files (read-only diagnostics).
-- Prefer PowerShell commands; no jq.
-
-## Checks to run
-Run these checks and then present a compact table: `check | status | details | fix`.
-
-### Versions
-- Codex fork installed version (first match wins):
-  - `.codex/gsd/VERSION`
-  - `~/.codex/gsd/VERSION`
-- Claude engine installed version (first match wins):
-  - `.claude/get-shit-done/VERSION`
-  - `~/.claude/get-shit-done/VERSION`
-
-### Engine presence (required for Codex prompts)
-- `.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:
-  - `Update available: {installed} -> {latest}`
-  - Next: `gsd-update` (Codex) / `/gsd:update` (Claude) or re-run `npx gsd-codex-cli@latest`.
-
-## Recommended fixes (use the minimum)
-- If engine missing: `npx gsd-codex-cli@latest --path .` (or `--global`)
-- If only Claude engine exists and Codex prompts are desired in-project: `npx gsd-codex-cli@latest --path .`
-- If `.planning/` missing: run `gsd-new-project` (Codex) / `/gsd:new-project` (Claude)
-
-## Completion output
-- Print the table and a single “Next recommended command”:
-  - If engine missing: `npx gsd-codex-cli@latest --path .`
-  - Else if `.planning/` missing: `gsd-new-project` / `/gsd:new-project`
-  - Else: `gsd-progress` / `/gsd:progress`
-
+---
+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.
+
+## Compatibility
+- Use .codex/skills/get-shit-done-codex semantics.
+- Do not modify files (read-only diagnostics).
+- Prefer PowerShell commands; no jq.
+
+## Checks to run
+Run these checks and then present a compact table: `check | status | details | fix`.
+
+### Versions
+- Codex fork installed version (first match wins):
+  - `.codex/gsd/VERSION`
+  - `~/.codex/gsd/VERSION`
+- Claude engine installed version (first match wins):
+  - `.claude/get-shit-done/VERSION`
+  - `~/.claude/get-shit-done/VERSION`
+
+### Engine presence (required for Codex prompts)
+- `.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:
+  - `Update available: {installed} -> {latest}`
+  - Next: `gsd-update` (Codex) / `/gsd:update` (Claude) or re-run `npx gsd-codex-cli@latest`.
+
+## Recommended fixes (use the minimum)
+- If engine missing: `npx gsd-codex-cli@latest --path .` (or `--global`)
+- If only Claude engine exists and Codex prompts are desired in-project: `npx gsd-codex-cli@latest --path .`
+- If `.planning/` missing: run `gsd-new-project` (Codex) / `/gsd:new-project` (Claude)
+
+## Completion output
+- Print the table and a single “Next recommended command”:
+  - If engine missing: `npx gsd-codex-cli@latest --path .`
+  - Else if `.planning/` missing: `gsd-new-project` / `/gsd:new-project`
+  - Else: `gsd-progress` / `/gsd:progress`

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

@@ -3,8 +3,6 @@ description: Execute all plans in a phase with wave-based parallelization
 argument-hint: "<phase-number> [--gaps-only]"
 ---
 
-
-
 ## Objective
 Execute all plans in a phase with wave-based parallelization
 
@@ -12,41 +10,45 @@ Execute all plans in a phase with wave-based parallelization
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Use one of these engine paths (prefer local, fallback global):
-  node .claude/get-shit-done/bin/gsd-tools.js ...
-  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
+- Use one of these engine paths (prefer local, fallback global):
+  node .claude/get-shit-done/bin/gsd-tools.js ...
+  node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
-- Run engine commands through PowerShell.
-- Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
-- No jq / bash-only constructs.
-
-## Subagent lifecycle (required)
+- 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.
 
-- Translate each upstream `Task(...)` into `spawn_agent` -> `wait` -> `close_agent`.
-- Spawn only when the upstream workflow defines an agent role.
-- 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."
+## Subagent lifecycle (required)
 
-## 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:
-   - 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 
-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.
+- Translate each upstream `Task(...)` into `spawn_agent` -> `wait` -> `close_agent`.
+- Spawn only when the upstream workflow defines an agent role.
+- Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
+- Do not advance workflow steps until wait and close complete.
+
+## 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 flags only from the same argument string (`--gaps-only`, `--auto`).
+- If phase argument is missing or invalid, stop and ask for a valid phase number.
+
+## Execution
+1. Parse "<phase-number> [--gaps-only] [--auto]" from the command argument string.
+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.
+8. Preserve all gates and routing from upstream workflow.
+9. Preserve commit behavior using
+node <gsd-tools-path> commit "message" --files ....
+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.