> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/gsd-build/get-shit-done/llms.txt > Use this file to discover all available pages before exploring further. # Changelog > Release history and notable changes to Get Shit Done For the complete changelog, see the [full CHANGELOG.md on GitHub](https://github.com/glittercowboy/get-shit-done/blob/main/CHANGELOG.md). ## 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 `
` 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-advance pipeline: `--auto` on discuss/plan/execute * Brave Search integration for researchers * GitHub issue templates and security policy * Git branching strategies (none/phase/milestone) * Context compliance verification in plan checker * `--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: ```bash theme={null} /gsd:update ``` Or via npm: ```bash theme={null} npm list -g get-shit-done-cc ``` ### Update to Latest ```bash theme={null} 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: ```bash theme={null} /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:** ```json theme={null} { "depth": "standard" } ``` **After:** ```json theme={null} { "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:** ```bash theme={null} /gsd:new-project /gsd:create-roadmap ``` **After:** ```bash theme={null} /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](https://github.com/glittercowboy/get-shit-done/blob/main/CHANGELOG.md). **Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).** *** ## Contributing Found a bug or have a feature request? Submit bug reports and feature requests on GitHub. Learn how to contribute to GSD development.