Skip to main content
For the complete changelog, see the full CHANGELOG.md on GitHub.

​
Recent Releases

​
[1.22.4] - 2026-03-03

Added:
  • --discuss flag for /gsd:quick — lightweight pre-planning discussion to gather context before quick tasks
Fixed:
  • Windows: @file: protocol resolution for large init payloads (>50KB) — all 32 workflow/agent files now resolve temp file paths instead of letting agents hallucinate /tmp paths (#841)
  • Missing skills frontmatter on gsd-nyquist-auditor agent

​
[1.22.3] - 2026-03-03

Added:
  • Verify-work auto-injects a cold-start smoke test for phases that modify server, database, seed, or startup files — catches warm-state blind spots
Changed:
  • Renamed depth setting to granularity with values coarse/standard/fine to accurately reflect what it controls (phase count, not investigation depth). Backward-compatible migration auto-renames existing config.
Fixed:
  • Installer now replaces $HOME/.claude/ paths (not just ~/.claude/) for non-Claude runtimes — fixes broken commands on local installs and Gemini/OpenCode/Codex installs (#905, #909)

​
[1.22.2] - 2026-03-03

Fixed:
  • Codex installer no longer creates duplicate [features] and [agents] sections on re-install (#902, #882)
  • Context monitor hook is advisory instead of blocking non-GSD workflows
  • Hooks respect CLAUDE_CONFIG_DIR for custom config directories
  • Hooks include stdin timeout guard to prevent hanging on pipe errors
  • Statusline context scaling matches autocompact buffer thresholds
  • Gap closure plans compute wave numbers instead of hardcoding wave 1
  • auto_advance config flag no longer persists across sessions
  • Phase-complete scans ROADMAP.md as fallback for next-phase detection
  • getMilestoneInfo() prefers in-progress milestone marker instead of always returning first
  • State parsing supports both bold and plain field formats
  • Phase counting scoped to current milestone
  • Total phases derived from ROADMAP when phase directories don’t exist yet
  • OpenCode detects runtime config directory instead of hardcoding .claude
  • Gemini hooks use AfterTool event instead of PostToolUse
  • Multi-word commit messages preserved in CLI router
  • Regex patterns in milestone/state helpers properly escaped
  • isGitIgnored uses --no-index for tracked file detection
  • AskUserQuestion freeform answer loop properly breaks on valid input
  • Agent spawn types standardized across all workflows
Changed:
  • Anti-heredoc instruction extended to all file-writing agents
  • Agent definitions include skills frontmatter and hooks examples
Chores:
  • Removed leftover new-project.md.bak file
  • Deduplicated extractField and phase filter helpers into shared modules
  • Added 47 agent frontmatter and spawn consistency tests

​
[1.22.1] - 2026-03-02

Added:
  • Discuss phase now loads prior context (PROJECT.md, REQUIREMENTS.md, STATE.md, and all prior CONTEXT.md files) before identifying gray areas — prevents re-asking questions you’ve already answered in earlier phases
Fixed:
  • Shell snippets in workflows use printf instead of echo to prevent jq parse errors with special characters

​
[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

​
[1.21.0] - 2026-02-25

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

​
[1.20.6] - 2025-02-23

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)

​
Notable Features by Version

  • /gsd:health command for validating .planning/ integrity
  • --repair flag for auto-fixing corrupted files
  • --auto flag wired through full phase chain
  • Auto-advance chains phase execution across milestones
  • --full flag for /gsd:quick with verification
  • User-level defaults via ~/.gsd/defaults.json
  • --auto flag for /gsd:new-project
  • Auto-runs research/requirements/roadmap from document
  • Windows SessionStart hook fixes
  • HEREDOC replaced with literal newlines for git
  • Deterministic structural checks
  • Frontmatter CRUD operations
  • Template fill functionality
  • State progression automation
  • Local patch preservation on update
  • /gsd:reapply-patches command
  • 10 new gsd-tools CLI commands
  • Phase management (add/insert/remove/complete)
  • Roadmap analysis and validation
  • Milestone completion automation
  • Todo management
  • Template scaffolding
  • gsd-researcher agent (915 lines)
  • gsd-debugger agent (990 lines)
  • gsd-codebase-mapper agent
  • Research subagent prompt templates
  • Thin orchestrator pattern for all research/debug
  • Thin orchestrator pattern across all commands
  • Centralized gsd-tools.cjs utility
  • Token reduction (~22k characters removed)
  • Condensed agent prompts
  • Compound init commands
  • Model profiles (quality/balanced/budget)
  • /gsd:settings for workflow toggles
  • Native OpenCode support
  • Uncommitted planning mode
  • Quick Mode (/gsd:quick)
  • Ad-hoc task execution with GSD guarantees
  • Separate tracking in .planning/quick/
  • Same quality, faster path
  • Single /gsd:new-milestone command
  • Mirrors /gsd:new-project flow
  • Research → requirements → roadmap
  • /gsd:verify-work routing
  • gsd-plan-checker agent
  • Planner → checker → revise cycle
  • Six verification dimensions
  • --skip-verify flag
  • Statusline integration
  • Wave-based parallel execution
  • Dependency graph analysis
  • /gsd:execute-phase orchestration
  • Checkpoint pause/resume

​
Upgrade Instructions

​
Check Your Version

In Claude Code: 
/gsd:update
Or via npm: 
npm list -g get-shit-done-cc

​
Update to Latest

npx get-shit-done-cc@latest
The installer:
  1. Shows changelog of what changed
  2. Backs up any locally modified files to gsd-local-patches/
  3. Installs new version
  4. Offers to restore your modifications

​
Restore Local Modifications

If you had local changes: 
/gsd:reapply-patches

​
Breaking Changes

Major breaking changes are listed here. For minor breaking changes, see the full changelog.

​
v1.22.3 - depth renamed to granularity

Before: 
{
  "depth": "standard"
}
After: 
{
  "granularity": "standard"
}
Migration: Automatic. The system auto-renames on first load.

​
v1.6.0 - Unified Milestone Flow

Removed commands:
  • /gsd:discuss-milestone (consolidated into /gsd:new-milestone)
  • /gsd:create-roadmap (integrated into project/milestone flows)
  • /gsd:define-requirements (integrated into project/milestone flows)
  • /gsd:research-project (integrated into project/milestone flows)
Migration: Use /gsd:new-milestone for all milestone initialization.

​
v1.5.28 - /gsd:execute-plan Removed

Removed: /gsd:execute-plan command Migration: Use /gsd:execute-phase instead.

​
v1.5.0 - New Project Flow

Before: 
/gsd:new-project
/gsd:create-roadmap
After: 
/gsd:new-project  # Now includes research/requirements/roadmap
Migration: Use the unified /gsd:new-project command.

​
v1.4.24 - ISSUES.md System Removed

Removed: ISSUES.md tracking system Migration: Use phase-scoped UAT issues (/gsd:verify-work) and TODOs (/gsd:add-todo).

​
Version History

For the complete version history including all patches and minor releases, see the full CHANGELOG.md on GitHub. Format follows Keep a Changelog.

​
Contributing

Found a bug or have a feature request?

Report Issues

Submit bug reports and feature requests on GitHub.

Contributing Guide

Learn how to contribute to GSD development.