v2.41.0 - Upstream sync + MVP-phase workflow

Upstream minor sync to GSD 1.41.0 (released 2026-05-07). Plugin-only patches in bin/lib/core.cjs (CLAUDE_PLUGIN_ROOT path resolution helpers resolveGsdRoot / resolveGsdDataDir / resolveGsdAsset + agent-dir override getAgentsDir reading GSD_AGENTS_DIR) preserved via 3-way merge. bin/gsd-tools.cjs untouched upstream this cycle.

Headline

/gsd:mvp-phase — new MVP-mode phase command. Vertical-slice planning: prompts for an "As a / I want to / So that" user story, runs SPIDR splitting, writes the result to ROADMAP.md, then delegates to /gsd:plan-phase. Plan-phase auto-detects MVP via the new mode: roadmap field and routes to TDD execution + UAT verification.

Added

• /gsd:mvp-phase workflow — vertical-slice MVP planning + TDD execution + UAT verification.
• 8 new references powering MVP/SPIDR/user-story/worktree-path-safety guidance: mvp-concepts, planner-mvp-mode, execute-mvp-tdd, verify-mvp-mode, spidr-splitting, skeleton-template, user-story-template, worktree-path-safety.
• 3 new workflow bodies for existing skills: workflows/add-backlog.md, workflows/debug.md, workflows/thread.md.
• bin/lib/runtime-homes.cjs — runtime-aware globalSkillsBase resolution (replaces hardcoded path, upstream #3126).
• 7 agent-prompt updates: gsd-codebase-mapper, gsd-debug-session-manager, gsd-executor, gsd-plan-checker, gsd-planner, gsd-roadmapper, gsd-verifier.

Changed

• Version bump — plugin 2.40.2 → 2.41.0 per plugin_minor = upstream_minor versioning.
• workflows/extract_learnings.md renamed to workflows/extract-learnings.md (snake → kebab; git history preserved via git mv).
• 33 top-level workflows refreshed + 3 nested workflow files. Notable: quick.md (history-based resurrection guard), plan-phase.md (removed stale OpenCode agent: directive #3156), execute-phase.md + sub-step files (cwd-drift sentinel + absolute-path guard #3097/#3099).
• 12 bin/lib/ modules refreshed wholesale.
• templates/README.md updated.

Fixed

• Upstream bug fixes flowing through automatically: milestone version-resolution (#3109), STATE narrative-tail normalization (#3122), roadmap.cjs plan-count for nested layout (#3128), state.begin-phase idempotency (#3127), workflow contract validation (#3151), and statusline numeric-100 / next_phases parsing (#3154).

Plugin patches preserved

• bin/lib/core.cjs — resolveGsdRoot / resolveGsdDataDir / resolveGsdAsset + the patched getAgentsDir reading GSD_AGENTS_DIR (carried into 1.41.0 for the first time).
• bin/gsd-tools.cjs — migrate / write-phase-memory / checkpoint / hook cases (upstream untouched this cycle, plugin patches verified intact).

Carries forward from v2.40.2

• MCP stdio framing fix (#3) — claude mcp list reports gsd: ✓ Connected. Fix authored by @Sovereigntymind, confirmed by @jesse-smith.
• CI regression test for the MCP transport at tests/mcp-stdio-framing.test.cjs, wired into the Check drift GitHub Actions workflow.

Upgrade

Pull master or wait for /gsd:update to surface 2.41.0, then run /reload-plugins inside Claude Code.

---

Full upstream changelog: https://github.com/gsd-build/get-shit-done/releases/tag/v1.41.0
Plugin changelog: https://github.com/jnuyens/gsd-plugin/blob/master/CHANGELOG.md#2410---2026-05-07