All notable changes to GSD will be documented in this file.
Format follows Keep a Changelog.
- Research agents write their own files directly (STACK.md, FEATURES.md, ARCHITECTURE.md, PITFALLS.md) instead of returning results to orchestrator
- Slimmed principles.md and load it dynamically in core commands
- New
/gsd:research-projectcommand for pre-roadmap ecosystem research — spawns parallel agents to investigate stack, features, architecture, and pitfalls before you commit to a roadmap - New
/gsd:define-requirementscommand for scoping v1 requirements from research findings — transforms "what exists in this domain" into "what we're building" - Requirements traceability: phases now map to specific requirement IDs with 100% coverage validation
- BREAKING: New project flow is now:
new-project → research-project → define-requirements → create-roadmap - Roadmap creation now requires REQUIREMENTS.md and validates all v1 requirements are mapped to phases
- Simplified questioning in new-project to four essentials (vision, core priority, boundaries, constraints)
1.4.29 - 2026-01-14
- Deleted obsolete
_archive/execute-phase.mdandstatus.mdcommands
1.4.28 - 2026-01-14
- Restored comprehensive checkpoint documentation with full examples for verification, decisions, and auth gates
- Fixed execute-plan command to use fresh continuation agents instead of broken resume pattern
- Rich checkpoint presentation formats now documented for all three checkpoint types
- Slimmed execute-phase command to properly delegate checkpoint handling to workflow
1.4.27 - 2025-01-14
- Restored "what to do next" commands after plan/phase execution completes — orchestrator pattern conversion had inadvertently removed the copy/paste-ready next-step routing
1.4.26 - 2026-01-14
- Full changelog history backfilled from git (66 historical versions from 1.0.0 to 1.4.23)
1.4.25 - 2026-01-14
- New
/gsd:whats-newcommand shows changes since your installed version - VERSION file written during installation for version tracking
- CHANGELOG.md now included in package installation
1.4.24 - 2026-01-14
- USER-SETUP.md template for external service configuration
- BREAKING: ISSUES.md system (replaced by phase-scoped UAT issues and TODOs)
1.4.23 - 2026-01-14
- Removed dead ISSUES.md system code
1.4.22 - 2026-01-14
- Subagent isolation for debug investigations with checkpoint support
- DEBUG_DIR path constant to prevent typos in debug workflow
1.4.21 - 2026-01-14
- SlashCommand tool added to plan-fix allowed-tools
1.4.20 - 2026-01-14
- Standardized debug file naming convention
- Debug workflow now invokes execute-plan correctly
1.4.19 - 2026-01-14
- Auto-diagnose issues instead of offering choice in plan-fix
1.4.18 - 2026-01-14
- Parallel diagnosis before plan-fix execution
1.4.17 - 2026-01-14
- Redesigned verify-work as conversational UAT with persistent state
1.4.16 - 2026-01-13
- Pre-execution summary for interactive mode in execute-plan
- Pre-computed wave numbers at plan time
1.4.15 - 2026-01-13
- Context rot explanation to README header
1.4.14 - 2026-01-13
- YOLO mode is now recommended default in new-project
1.4.13 - 2026-01-13
- Brownfield flow documentation
- Removed deprecated resume-task references
1.4.12 - 2026-01-13
- execute-phase is now recommended as primary execution command
1.4.11 - 2026-01-13
- Checkpoints now use fresh continuation agents instead of resume
1.4.10 - 2026-01-13
- execute-plan converted to orchestrator pattern for performance
1.4.9 - 2026-01-13
- Removed subagent-only context from execute-phase orchestrator
- Removed "what's out of scope" question from discuss-phase
1.4.8 - 2026-01-13
- TDD reasoning explanation restored to plan-phase docs
1.4.7 - 2026-01-13
- Project state loading before execution in execute-phase
- Parallel execution marked as recommended, not experimental
1.4.6 - 2026-01-13
- Checkpoint pause/resume for spawned agents
- Deviation rules, commit rules, and workflow references to execute-phase
1.4.5 - 2026-01-13
- Parallel-first planning with dependency graphs
- Checkpoint-resume capability for long-running phases
.claude/rules/directory for auto-loaded contribution rules
- execute-phase uses wave-based blocking execution
1.4.4 - 2026-01-13
- Inline listing for multiple active debug sessions
1.4.3 - 2026-01-13
/gsd:debugcommand for systematic debugging with persistent state
1.4.2 - 2026-01-13
- Installation verification step clarification
1.4.1 - 2026-01-13
- Parallel phase execution via
/gsd:execute-phase - Parallel-aware planning in
/gsd:plan-phase /gsd:statuscommand for parallel agent monitoring- Parallelization configuration in config.json
- Wave-based parallel execution with dependency graphs
- Renamed
execute-phase.mdworkflow toexecute-plan.mdfor clarity - Plan frontmatter now includes
wave,depends_on,files_modified,autonomous
1.4.0 - 2026-01-12
- Full parallel phase execution system
- Parallelization frontmatter in plan templates
- Dependency analysis for parallel task scheduling
- Agent history schema v1.2 with parallel execution support
- Plans can now specify wave numbers and dependencies
- execute-phase orchestrates multiple subagents in waves
1.3.34 - 2026-01-11
/gsd:add-todoand/gsd:check-todosfor mid-session idea capture
1.3.33 - 2026-01-11
- Consistent zero-padding for decimal phase numbers (e.g., 01.1)
- Removed obsolete .claude-plugin directory
1.3.32 - 2026-01-10
/gsd:resume-taskfor resuming interrupted subagent executions
1.3.31 - 2026-01-08
- Planning principles for security, performance, and observability
- Pro patterns section in README
1.3.30 - 2026-01-08
- verify-work option surfaces after plan execution
1.3.29 - 2026-01-08
/gsd:verify-workfor conversational UAT validation/gsd:plan-fixfor fixing UAT issues- UAT issues template
1.3.28 - 2026-01-07
--config-dirCLI argument for multi-account setups/gsd:remove-phasecommand
- Validation for --config-dir edge cases
1.3.27 - 2026-01-07
- Recommended permissions mode documentation
- Mandatory verification enforced before phase/milestone completion routing
1.3.26 - 2026-01-06
- Claude Code marketplace plugin support
- Phase artifacts now committed when created
1.3.25 - 2026-01-06
- Milestone discussion context persists across /clear
1.3.24 - 2026-01-06
CLAUDE_CONFIG_DIRenvironment variable support
1.3.23 - 2026-01-06
- Non-interactive install flags (
--global,--local) for Docker/CI
1.3.22 - 2026-01-05
- Removed unused auto.md command
1.3.21 - 2026-01-05
- TDD features use dedicated plans for full context quality
1.3.20 - 2026-01-05
- Per-task atomic commits for better AI observability
1.3.19 - 2026-01-05
- Clarified create-milestone.md file locations with explicit instructions
1.3.18 - 2026-01-05
- YAML frontmatter schema with dependency graph metadata
- Intelligent context assembly via frontmatter dependency graph
1.3.17 - 2026-01-04
- Clarified depth controls compression, not inflation in planning
1.3.16 - 2026-01-04
- Depth parameter for planning thoroughness (
--depth=1-5)
1.3.15 - 2026-01-01
- TDD reference loaded directly in commands
1.3.14 - 2025-12-31
- TDD integration with detection, annotation, and execution flow
1.3.13 - 2025-12-29
- Restored deterministic bash commands
- Removed redundant decision_gate
1.3.12 - 2025-12-29
- Restored plan-format.md as output template
1.3.11 - 2025-12-29
- 70% context reduction for plan-phase workflow
- Merged CLI automation into checkpoints
- Compressed scope-estimation (74% reduction) and plan-phase.md (66% reduction)
1.3.10 - 2025-12-29
- Explicit plan count check in offer_next step
1.3.9 - 2025-12-27
- Evolutionary PROJECT.md system with incremental updates
1.3.8 - 2025-12-18
- Brownfield/existing projects section in README
1.3.7 - 2025-12-18
- Improved incremental codebase map updates
1.3.6 - 2025-12-18
- File paths included in codebase mapping output
1.3.5 - 2025-12-17
- Removed arbitrary 100-line limit from codebase mapping
1.3.4 - 2025-12-17
- Inline code for Next Up commands (avoids nesting ambiguity)
1.3.3 - 2025-12-17
- Check PROJECT.md not .planning/ directory for existing project detection
1.3.2 - 2025-12-17
- Git commit step to map-codebase workflow
1.3.1 - 2025-12-17
/gsd:map-codebasedocumentation in help and README
1.3.0 - 2025-12-17
/gsd:map-codebasecommand for brownfield project analysis- Codebase map templates (stack, architecture, structure, conventions, testing, integrations, concerns)
- Parallel Explore agent orchestration for codebase analysis
- Brownfield integration into GSD workflows
- Improved continuation UI with context and visual hierarchy
- Permission errors for non-DSP users (removed shell context)
- First question is now freeform, not AskUserQuestion
1.2.13 - 2025-12-17
- Improved continuation UI with context and visual hierarchy
1.2.12 - 2025-12-17
- First question should be freeform, not AskUserQuestion
1.2.11 - 2025-12-17
- Permission errors for non-DSP users (removed shell context)
1.2.10 - 2025-12-16
- Inline command invocation replaced with clear-then-paste pattern
1.2.9 - 2025-12-16
- Git init runs in current directory
1.2.8 - 2025-12-16
- Phase count derived from work scope, not arbitrary limits
1.2.7 - 2025-12-16
- AskUserQuestion mandated for all exploration questions
1.2.6 - 2025-12-16
- Internal refactoring
1.2.5 - 2025-12-16
<if mode>tags for yolo/interactive branching
1.2.4 - 2025-12-16
- Stale CONTEXT.md references updated to new vision structure
1.2.3 - 2025-12-16
- Enterprise language removed from help and discuss-milestone
1.2.2 - 2025-12-16
- new-project completion presented inline instead of as question
1.2.1 - 2025-12-16
- AskUserQuestion restored for decision gate in questioning flow
1.2.0 - 2025-12-15
- Research workflow implemented as Claude Code context injection
1.1.2 - 2025-12-15
- YOLO mode now skips confirmation gates in plan-phase
1.1.1 - 2025-12-15
- README documentation for new research workflow
1.1.0 - 2025-12-15
- Pre-roadmap research workflow
/gsd:research-phasefor niche domain ecosystem discovery/gsd:research-projectcommand with workflow and templates/gsd:create-roadmapcommand with research-aware workflow- Research subagent prompt templates
- new-project split to only create PROJECT.md + config.json
- Questioning rewritten as thinking partner, not interviewer
1.0.11 - 2025-12-15
/gsd:research-phasefor niche domain ecosystem discovery
1.0.10 - 2025-12-15
- Scope creep prevention in discuss-phase command
1.0.9 - 2025-12-15
- Phase CONTEXT.md loaded in plan-phase command
1.0.8 - 2025-12-15
- PLAN.md included in phase completion commits
1.0.7 - 2025-12-15
- Path replacement for local installs
1.0.6 - 2025-12-15
- Internal improvements
1.0.5 - 2025-12-15
- Global/local install prompt during setup
- Bin path fixed (removed ./)
- .DS_Store ignored
1.0.4 - 2025-12-15
- Bin name and circular dependency removed
1.0.3 - 2025-12-15
- TDD guidance in planning workflow
1.0.2 - 2025-12-15
- Issue triage system to prevent deferred issue pile-up
1.0.1 - 2025-12-15
- Initial npm package release
1.0.0 - 2025-12-14
- Initial release of GSD (Get Shit Done) meta-prompting system
- Core slash commands:
/gsd:new-project,/gsd:discuss-phase,/gsd:plan-phase,/gsd:execute-phase - PROJECT.md and STATE.md templates
- Phase-based development workflow
- YOLO mode for autonomous execution
- Interactive mode with checkpoints