[1.22.0] - 2026-02-27

Added

• Codex multi-agent support: request_user_input mapping, multi-agent config, and agent role generation for Codex runtime
• Analysis paralysis guard in agents to prevent over-deliberation during planning
• Exhaustive cross-check and task-level TDD patterns in agent workflows
• Code-aware discuss phase with codebase scouting — /gsd:discuss-phase now analyzes relevant source files before asking questions

Fixed

• Update checker clears both cache paths to prevent stale version notifications
• Statusline migration regex no longer clobbers third-party statuslines
• Subagent paths use $HOME instead of ~ to prevent MODULE_NOT_FOUND errors
• Skill discovery supports both .claude/skills/ and .agents/skills/ paths
• resolve-model variable names aligned with template placeholders
• Regex metacharacters properly escaped in stateExtractField
• model_overrides and nyquist_validation correctly loaded from config
• phase-plan-index no longer returns null/empty for files_modified, objective, and task_count

[1.21.1] - 2026-02-27

Added

• Comprehensive test suite: 428 tests across 13 test files covering core, commands, config, dispatcher, frontmatter, init, milestone, phase, roadmap, state, and verify modules
• CI pipeline with GitHub Actions: 9-matrix (3 OS × 3 Node versions), c8 coverage enforcement at 70% line threshold
• Cross-platform test runner (scripts/run-tests.cjs) for Windows compatibility

Fixed

• getMilestoneInfo() returns wrong version when shipped milestones are collapsed in <details> blocks
• Milestone completion stats and archive now scoped to current milestone phases only (previously counted all phases on disk including prior milestones)
• MILESTONES.md entries now insert in reverse chronological order (newest first)
• Cross-platform path separators: all user-facing file paths use forward slashes on Windows
• JSON quoting and dollar sign handling in CLI arguments on Windows
• model_overrides loaded from config and resolveModelInternal used in CLI

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

Added

• YAML frontmatter sync to STATE.md for machine-readable status tracking
• /gsd:add-tests command for post-phase test generation
• Codex runtime support with skills-first installation
• Standard project_context block in gsd-verifier output
• Codex changelog and usage documentation

Changed

• Improved onboarding UX: installer now suggests /gsd:new-project instead of /gsd:help
• Updated Discord invite to vanity URL (discord.gg/gsd)
• Compressed Nyquist validation layer to align with GSD meta-prompt conventions
• Requirements propagation now includes phase_req_ids from ROADMAP to workflow agents
• Debug sessions require human verification before resolution

Fixed

• Multi-level decimal phase handling (e.g., 72.1.1) with proper regex escaping
• /gsd:update always installs latest package version
• STATE.md decision corruption and dollar sign handling
• STATE.md frontmatter mapping for requirements-completed status
• Progress bar percent clamping to prevent RangeError crashes
• --cwd override support in state-snapshot command

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

Added

• Context window monitor hook with WARNING/CRITICAL alerts when agent context usage exceeds thresholds
• Nyquist validation layer in plan-phase pipeline to catch quality issues before execution
• Option highlighting and gray area looping in discuss-phase for clearer preference capture

Changed

• Refactored installer tools into 11 domain modules for maintainability

Fixed

• Auto-advance chain no longer breaks when skills fail to resolve inside Task subagents
• Gemini CLI workflows and templates no longer incorrectly convert to TOML format
• Universal phase number parsing handles all formats consistently (decimal phases, plain numbers)

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

Fixed

• /gsd:health --repair now creates timestamped backup before regenerating STATE.md (#657)

Changed

• Subagents now discover and load project CLAUDE.md and skills at spawn time for better project context (#671, #672)
• Improved context loading reliability in spawned agents

Fixed

• Executor agents now update ROADMAP.md and REQUIREMENTS.md after each plan completes — previously both documents stayed unchecked throughout milestone execution
• New requirements mark-complete CLI command enables per-plan requirement tracking instead of waiting for phase completion
• Executor final commit includes ROADMAP.md and REQUIREMENTS.md

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

[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

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

[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