Tom Boucher 297adf8425 fix: add Windows troubleshooting for plan-phase freezes (#732) ...

Windows users experience plan-phase freezes due to Claude Code stdio
deadlocks with MCP servers. When a subagent hangs, the orchestrator
blocks indefinitely with no timeout or error.

Adds:
- Windows troubleshooting section to plan-phase.md with:
  - Orphaned process cleanup (PowerShell commands)
  - Stale task directory cleanup (~/.claude/tasks/)
  - MCP server reduction advice
  - --skip-research fallback to reduce agent chain
- Stale task directory detection to health.md (I002 diagnostic)
  - Reports count of stale dirs on --repair
  - Safe cleanup guidance

Closes #732

2026-03-18 17:13:55 -04:00

..

add-phase.md

fix: resolve @file: protocol in all INIT consumers for Windows compatibility (#841)

2026-03-03 12:19:12 -06:00

add-tests.md

fix: resolve @file: protocol in all INIT consumers for Windows compatibility (#841)

2026-03-03 12:19:12 -06:00

add-todo.md

fix: resolve @file: protocol in all INIT consumers for Windows compatibility (#841)

2026-03-03 12:19:12 -06:00

audit-milestone.md

fix: resolve @file: protocol in all INIT consumers for Windows compatibility (#841)

2026-03-03 12:19:12 -06:00

autonomous.md

feat: add Copilot CLI runtime support and gsd-autonomous skill (#911)

2026-03-14 17:41:19 -06:00

check-todos.md

fix: resolve @file: protocol in all INIT consumers for Windows compatibility (#841)

2026-03-03 12:19:12 -06:00

cleanup.md

fix: use $HOME instead of ~ for gsd-tools.cjs paths to prevent subagent MODULE_NOT_FOUND (#786)

2026-02-27 13:11:19 -06:00

complete-milestone.md

feat: add /gsd:ui-phase + /gsd:ui-review design contract and visual audit layer (closes #986)

2026-03-14 21:57:59 -06:00

diagnose-issues.md

fix(workflows): standardize agent spawn types across all workflows

2026-03-03 08:01:54 -06:00

discovery-phase.md

fix(workflow): enforce 12-char AskUserQuestion header limit (#559)

2026-02-15 09:22:07 -06:00

discuss-phase.md

feat(discuss): show remaining areas when asking to continue or move on (#1072)

2026-03-16 08:50:44 -06:00

do.md

feat(do): add freeform text router command (#1067)

2026-03-15 19:30:46 -06:00

execute-phase.md

feat: cross-phase regression gate in execute-phase pipeline (#945) (#1120)

2026-03-18 10:02:34 -06:00

execute-plan.md

fix: prevent agent from suggesting non-existent /gsd:transition command (#1081) (#1129)

2026-03-18 10:00:35 -06:00

health.md

fix: add Windows troubleshooting for plan-phase freezes (#732)

2026-03-18 17:13:55 -04:00

help.md

feat: /gsd:ship command for PR creation from verified phase work (#829) (#1123)

2026-03-18 10:01:08 -06:00

insert-phase.md

fix: resolve @file: protocol in all INIT consumers for Windows compatibility (#841)

2026-03-03 12:19:12 -06:00

list-phase-assumptions.md

refactor: condense verbose explanations in templates and workflows

2026-01-22 11:11:16 -06:00

map-codebase.md

fix: add sequential fallback for map-codebase on runtimes without Task tool (#1174) (#1184)

2026-03-18 09:55:40 -06:00

new-milestone.md

fix(config): prevent workflow.research reset during milestone transitions

2026-03-15 10:08:59 -06:00

new-project.md

feat: add inherit model profile for OpenCode /model (#951)

2026-03-15 11:40:08 -06:00

next.md

feat: add /gsd:next command for automatic workflow advancement (#927) (#1167)

2026-03-18 09:56:35 -06:00

node-repair.md

feat: add node repair operator for autonomous task failure recovery (#1016)

2026-03-12 11:35:45 -06:00

note.md

feat(note): add zero-friction note capture command (#1080)

2026-03-16 08:50:19 -06:00

pause-work.md

feat: structured session handoff artifact for cross-session continuity (#940) (#1122)

2026-03-18 10:01:25 -06:00

plan-milestone-gaps.md

fix: replace echo with printf in shell snippets to prevent jq parse errors

2026-03-02 12:07:45 -06:00

plan-phase.md

fix: add Windows troubleshooting for plan-phase freezes (#732)

2026-03-18 17:13:55 -04:00

profile-user.md

feat: add developer profiling pipeline (#1084)

2026-03-16 09:46:00 -06:00

progress.md

feat: add inherit model profile for OpenCode /model (#951)

2026-03-15 11:40:08 -06:00

quick.md

feat(quick): add --research flag for focused pre-planning research (#317) (#1063)

2026-03-15 11:45:25 -06:00

remove-phase.md

fix: resolve @file: protocol in all INIT consumers for Windows compatibility (#841)

2026-03-03 12:19:12 -06:00

research-phase.md

fix: resolve @file: protocol in all INIT consumers for Windows compatibility (#841)

2026-03-03 12:19:12 -06:00

resume-project.md

feat: structured session handoff artifact for cross-session continuity (#940) (#1122)

2026-03-18 10:01:25 -06:00

session-report.md

fix: hook version tracking, stale hook detection, stdin timeout, and session-report command (#1153, #1157, #1161, #1162) (#1163)

2026-03-18 09:57:20 -06:00

settings.md

docs: document inherit profile for non-Anthropic providers (#1036) (#1185)

2026-03-18 09:55:07 -06:00

ship.md

feat: /gsd:ship command for PR creation from verified phase work (#829) (#1123)

2026-03-18 10:01:08 -06:00

stats.md

fix(stats): correct git and roadmap reporting (#1066)

2026-03-15 19:31:28 -06:00

transition.md

fix: prevent agent from suggesting non-existent /gsd:transition command (#1081) (#1129)

2026-03-18 10:00:35 -06:00

ui-phase.md

feat: add /gsd:ui-phase + /gsd:ui-review design contract and visual audit layer (closes #986)

2026-03-14 21:57:59 -06:00

ui-review.md

feat: add /gsd:ui-phase + /gsd:ui-review design contract and visual audit layer (closes #986)

2026-03-14 21:57:59 -06:00

update.md

fix: use arrays for RUNTIME_DIRS to fix zsh word-splitting (#1173) (#1183)

2026-03-18 09:55:21 -06:00

validate-phase.md

fix: replace invalid commit-docs with commit command in workflows (closes #968) (#1044)

2026-03-14 21:15:26 -06:00

verify-phase.md

feat: add execution hardening (pre-wave check, cross-plan contracts, export spot-check) (#1082)

2026-03-16 11:39:34 -06:00

verify-work.md

feat: add /gsd:ui-phase + /gsd:ui-review design contract and visual audit layer (closes #986)

2026-03-14 21:57:59 -06:00