v1.20.3

Fixed

• Milestone audit now cross-references three independent sources (VERIFICATION.md + SUMMARY frontmatter + REQUIREMENTS.md traceability) instead of single-source phase status checks
• Orphaned requirements (in traceability table but absent from all phase VERIFICATIONs) detected and forced to unsatisfied
• Integration checker receives milestone requirement IDs and maps findings to affected requirements
• complete-milestone gates on requirements completion before archival — surfaces unchecked requirements with proceed/audit/abort options
• plan-milestone-gaps updates REQUIREMENTS.md traceability table (phase assignments, checkbox resets, coverage count) and includes it in commit
• Gemini CLI: escape ${VAR} shell variables in agent bodies to prevent template validation failures

v1.20.2

[1.20.2] - 2026-02-16

Fixed

• Requirements tracking chain now strips bracket syntax ([REQ-01, REQ-02] → REQ-01, REQ-02) across all agents
• Verifier cross-references requirement IDs from PLAN frontmatter instead of only grepping REQUIREMENTS.md by phase number
• Orphaned requirements (mapped to phase in REQUIREMENTS.md but unclaimed by any plan) are detected and flagged

Changed

• All requirements references across planner, templates, and workflows enforce MUST/REQUIRED/CRITICAL language — no more passive suggestions
• Plan checker now fails (blocking, not warning) when any roadmap requirement is absent from all plans
• Researcher receives phase-specific requirement IDs and must output a <phase_requirements> mapping table
• Phase requirement IDs extracted from ROADMAP and passed through full chain: researcher → planner → checker → executor → verifier
• Verification report requirements table expanded with Source Plan, Description, and Evidence columns

Install/upgrade: npx get-shit-done-cc@latest

v1.20.1

Fixed

• Auto-mode (--auto) now survives context compaction by persisting workflow.auto_advance to config.json on disk
• Checkpoints no longer block auto-mode: human-verify auto-approves, decision auto-selects first option (human-action still stops for auth gates)
• Plan-phase now passes --auto flag when spawning execute-phase
• Auto-advance clears on milestone complete to prevent runaway chains

v1.20.0

[1.20.0] - 2026-02-15

Added

• /gsd:health command — validates .planning/ directory integrity with --repair flag for auto-fixing config.json and STATE.md
• --full flag for /gsd:quick — enables plan-checking (max 2 iterations) and post-execution verification on quick tasks
• --auto flag wired from /gsd:new-project through the full phase chain (discuss → plan → execute)
• Auto-advance chains phase execution across full milestones when workflow.auto_advance is enabled

Fixed

• Plans created without user context — /gsd:plan-phase warns when no CONTEXT.md exists, /gsd:discuss-phase warns when plans already exist (#253)
• OpenCode installer converts general-purpose subagent type to OpenCode's general
• /gsd:complete-milestone respects commit_docs setting when merging branches
• Phase directories tracked in git via .gitkeep files

---

Install/upgrade: npx get-shit-done-cc@latest

v1.19.2

Added

• User-level default settings via ~/.gsd/defaults.json — set GSD defaults across all projects
• Per-agent model overrides — customize which Claude model each agent uses

Changed

• Completed milestone phase directories are now archived for cleaner project structure
• Wave execution diagram added to README for clearer parallelization visualization

Fixed

• OpenCode local installs now write config to ./.opencode/ instead of overwriting global ~/.config/opencode/
• Large JSON payloads write to temp files to prevent truncation in tool calls
• Phase heading matching now supports #### depth
• Phase padding normalized in insert command
• ESM conflicts prevented by renaming gsd-tools.js to .cjs
• Config directory paths quoted in hook templates for local installs
• Settings file corruption prevented by using Write tool for file creation
• Plan-phase autocomplete fixed by removing "execution" from description
• Executor now has scope boundary and attempt limit to prevent runaway loops

v1.19.1

[1.19.1] - 2026-02-15

Added

• Auto-advance pipeline: --auto flag on discuss-phase and plan-phase chains discuss → plan → execute without stopping. Also available as workflow.auto_advance config setting

Fixed

• Phase transition routing now routes to discuss-phase (not plan-phase) when no CONTEXT.md exists — consistent across all workflows (#530)
• ROADMAP progress table plan counts are now computed from disk instead of LLM-edited — deterministic "X/Y Complete" values (#537)
• Verifier uses ROADMAP Success Criteria directly instead of deriving verification truths from the Goal field (#538)
• REQUIREMENTS.md traceability updates when a phase completes
• STATE.md updates after discuss-phase completes (#556)
• AskUserQuestion headers enforced to 12-char max to prevent UI truncation (#559)
• Agent model resolution returns inherit instead of hardcoded opus (#558)

Install/upgrade: npx get-shit-done-cc@latest

v1.19.0

Added

• Brave Search integration for researchers (requires BRAVE_API_KEY environment variable)
• GitHub issue templates for bug reports and feature requests
• Security policy for responsible disclosure
• Auto-labeling workflow for new issues

Fixed

• UAT gaps and debug sessions now auto-resolve after gap-closure phase execution (#580)
• Fall back to ROADMAP.md when phase directory missing (#521)
• Template hook paths for OpenCode/Gemini runtimes (#585)
• Accept both ## and ### phase headers, detect malformed ROADMAPs (#598, #599)
• Use {phase_num} instead of ambiguous {phase} for filenames (#601)
• Add package.json to prevent ESM inheritance issues (#602)

---

Install/upgrade: npx get-shit-done-cc@latest

v1.18.0

Added

• --auto flag for /gsd:new-project — runs research → requirements → roadmap automatically after config questions. Expects idea document via @ reference (e.g., /gsd:new-project --auto @prd.md)

Fixed

• Windows: SessionStart hook now spawns detached process correctly
• Windows: Replaced HEREDOC with literal newlines for git commit compatibility
• Research decision from /gsd:new-milestone now persists to config.json

Install/upgrade: npx get-shit-done-cc@latest

v1.17.0

Added

• gsd-tools verification suite: verify plan-structure, verify phase-completeness, verify references, verify commits, verify artifacts, verify key-links — deterministic structural checks
• gsd-tools frontmatter CRUD: frontmatter get/set/merge/validate — safe YAML frontmatter operations with schema validation
• gsd-tools template fill: template fill summary/plan/verification — pre-filled document skeletons
• gsd-tools state progression: state advance-plan, state update-progress, state record-metric, state add-decision, state add-blocker, state resolve-blocker, state record-session — automates STATE.md updates
• Local patch preservation: Installer now detects locally modified GSD files, backs them up to gsd-local-patches/, and creates a manifest for restoration
• /gsd:reapply-patches command to merge local modifications back after GSD updates

Changed

• Agents (executor, planner, plan-checker, verifier) now use gsd-tools for state updates and verification instead of manual markdown parsing
• /gsd:update workflow now notifies about backed-up local patches and suggests /gsd:reapply-patches

Fixed

• Added workaround for Claude Code classifyHandoffIfNeeded bug that causes false agent failures — execute-phase and quick workflows now spot-check actual output before reporting failure

v1.16.0

Added

• 10 new gsd-tools CLI commands that replace manual AI orchestration of mechanical operations:
  • phase add <desc> — append phase to roadmap + create directory
  • phase insert <after> <desc> — insert decimal phase
  • phase remove <N> [--force] — remove phase with full renumbering
  • phase complete <N> — mark done, update state + roadmap, detect milestone end
  • roadmap analyze — unified roadmap parser with disk status
  • milestone complete <ver> [--name] — archive roadmap/requirements/audit
  • validate consistency — check phase numbering and disk/roadmap sync
  • progress [json|table|bar] — render progress in various formats
  • todo complete <file> — move todo from pending to completed
  • scaffold [context|uat|verification|phase-dir] — template generation

Changed

• Workflows now delegate deterministic operations to gsd-tools CLI, reducing token usage and errors:
  • remove-phase.md: 13 manual steps → 1 CLI call + confirm + commit
  • add-phase.md: 6 manual steps → 1 CLI call + state update
  • insert-phase.md: 7 manual steps → 1 CLI call + state update
  • complete-milestone.md: archival delegated to milestone complete
  • progress.md: roadmap parsing delegated to roadmap analyze

Fixed

• Execute-phase now correctly spawns gsd-executor subagents instead of generic task agents
• commit_docs=false setting now respected in all .planning/ commit paths (execute-plan, debugger, reference docs all route through gsd-tools CLI)
• Execute-phase orchestrator no longer bloats context by embedding file content — passes paths instead, letting subagents read in their fresh context
• Windows: Normalized backslash paths in gsd-tools invocations (contributed by @rmindel)

---

Install/upgrade: npx get-shit-done-cc@latest