msd-core/CHANGELOG.md

Changelog

All notable changes to GSD will be documented in this file.

Format follows Keep a Changelog.

Unreleased

1.5.24 - 2026-01-16

Fixed

• Stop notification hook now correctly parses STATE.md fields (was always showing "Ready for input")
• Planner agent now reliably loads CONTEXT.md and RESEARCH.md files

1.5.23 - 2025-01-16

Added

• Cross-platform completion notification hook (Mac/Linux/Windows alerts when Claude stops)
• Phase researcher now loads CONTEXT.md from discuss-phase to focus research on user decisions

Fixed

• Consistent zero-padding for phase directories (01-name, not 1-name)
• Plan file naming: {phase}-{plan}-PLAN.md pattern restored across all agents
• Double-path bug in researcher git add command
• Removed /gsd:research-phase from next-step suggestions (use /gsd:plan-phase instead)

1.5.22 - 2025-01-16

Added

• Statusline update indicator — shows ⬆ /gsd:update when a new version is available

Fixed

• Planner now updates ROADMAP.md placeholders after planning completes

1.5.21 - 2026-01-16

Added

• GSD brand system for consistent UI (checkpoint boxes, stage banners, status symbols)
• Research synthesizer agent that consolidates parallel research into SUMMARY.md

Changed

• Unified /gsd:new-project flow — Single command now handles questions → research → requirements → roadmap (~10 min)
• Simplified README to reflect streamlined workflow: new-project → plan-phase → execute-phase
• Added optional /gsd:discuss-phase documentation for UI/UX/behavior decisions before planning

Fixed

• verify-work now shows clear checkpoint box with action prompt ("Type 'pass' or describe what's wrong")
• Planner uses correct {phase}-{plan}-PLAN.md naming convention
• Planner no longer surfaces internal user_setup in output
• Research synthesizer commits all research files together (not individually)
• Project researcher agent can no longer commit (orchestrator handles commits)
• Roadmap requires explicit user approval before committing

1.5.20 - 2026-01-16

Fixed

• Research no longer skipped based on premature "Research: Unlikely" predictions made during roadmap creation. The --skip-research flag provides explicit control when needed.

Removed

• Research: Likely/Unlikely fields from roadmap phase template
• detect_research_needs step from roadmap creation workflow
• Roadmap-based research skip logic from planner agent

1.5.19 - 2026-01-16

Changed

• /gsd:discuss-phase redesigned with intelligent gray area analysis — analyzes phase to identify discussable areas (UI, UX, Behavior, etc.), presents multi-select for user control, deep-dives each area with focused questioning
• Explicit scope guardrail prevents scope creep during discussion — captures deferred ideas without acting on them
• CONTEXT.md template restructured for decisions (domain boundary, decisions by category, Claude's discretion, deferred ideas)
• Downstream awareness: discuss-phase now explicitly documents that CONTEXT.md feeds researcher and planner agents
• /gsd:plan-phase now integrates research — spawns gsd-phase-researcher before planning unless research exists or --skip-research flag used

1.5.18 - 2026-01-16

Added

• Plan verification loop — Plans are now verified before execution with a planner → checker → revise cycle
  • New gsd-plan-checker agent (744 lines) validates plans will achieve phase goals
  • Six verification dimensions: requirement coverage, task completeness, dependency correctness, key links, scope sanity, must_haves derivation
  • Max 3 revision iterations before user escalation
  • --skip-verify flag for experienced users who want to bypass verification
• Dedicated planner agent — gsd-planner (1,319 lines) consolidates all planning expertise
  • Complete methodology: discovery levels, task breakdown, dependency graphs, scope estimation, goal-backward analysis
  • Revision mode for handling checker feedback
  • TDD integration and checkpoint patterns
• Statusline integration — Context usage, model, and current task display

Changed

• /gsd:plan-phase refactored to thin orchestrator pattern (310 lines)
  • Spawns gsd-planner for planning, gsd-plan-checker for verification
  • User sees status between agent spawns (not a black box)
• Planning references deprecated with redirects to gsd-planner agent sections
  • plan-format.md, scope-estimation.md, goal-backward.md, principles.md
  • workflows/plan-phase.md

Fixed

• Removed zombie gsd-milestone-auditor agent (was accidentally re-added after correct deletion)

Removed

• Phase 99 throwaway test files

1.5.17 - 2026-01-15

Added

• New /gsd:update command — check for updates, install, and display changelog of what changed (better UX than raw npx get-shit-done-cc)

1.5.16 - 2026-01-15

Added

• New gsd-researcher agent (915 lines) with comprehensive research methodology, 4 research modes (ecosystem, feasibility, implementation, comparison), source hierarchy, and verification protocols
• New gsd-debugger agent (990 lines) with scientific debugging methodology, hypothesis testing, and 7+ investigation techniques
• New gsd-codebase-mapper agent for brownfield codebase analysis
• Research subagent prompt template for context-only spawning

Changed

• /gsd:research-phase refactored to thin orchestrator — now injects rich context (key insight framing, downstream consumer info, quality gates) to gsd-researcher agent
• /gsd:research-project refactored to spawn 4 parallel gsd-researcher agents with milestone-aware context (greenfield vs v1.1+) and roadmap implications guidance
• /gsd:debug refactored to thin orchestrator (149 lines) — spawns gsd-debugger agent with full debugging expertise
• /gsd:new-milestone now explicitly references MILESTONE-CONTEXT.md

Deprecated

• workflows/research-phase.md — consolidated into gsd-researcher agent
• workflows/research-project.md — consolidated into gsd-researcher agent
• workflows/debug.md — consolidated into gsd-debugger agent
• references/research-pitfalls.md — consolidated into gsd-researcher agent
• references/debugging.md — consolidated into gsd-debugger agent
• references/debug-investigation.md — consolidated into gsd-debugger agent

1.5.15 - 2025-01-15

Fixed

• Agents now install correctly — The agents/ folder (gsd-executor, gsd-verifier, gsd-integration-checker, gsd-milestone-auditor) was missing from npm package, now included

Changed

• Consolidated /gsd:plan-fix into /gsd:plan-phase --gaps for simpler workflow
• UAT file writes now batched instead of per-response for better performance

1.5.14 - 2025-01-15

Fixed

• Plan-phase now always routes to /gsd:execute-phase after planning, even for single-plan phases

1.5.13 - 2026-01-15

Fixed

• /gsd:new-milestone now presents research and requirements paths as equal options, matching /gsd:new-project format

1.5.12 - 2025-01-15

Changed

• Milestone cycle reworked for proper requirements flow:
  • complete-milestone now archives AND deletes ROADMAP.md and REQUIREMENTS.md (fresh for next milestone)
  • new-milestone is now a "brownfield new-project" — updates PROJECT.md with new goals, routes to define-requirements
  • discuss-milestone is now required before new-milestone (creates context file)
  • research-project is milestone-aware — focuses on new features, ignores already-validated requirements
  • create-roadmap continues phase numbering from previous milestone
  • Flow: complete → discuss → new-milestone → research → requirements → roadmap

Fixed

• MILESTONE-AUDIT.md now versioned as v{version}-MILESTONE-AUDIT.md and archived on completion
• progress now correctly routes to /gsd:discuss-milestone when between milestones (Route F)

1.5.11 - 2025-01-15

Changed

• Verifier reuses previous must-haves on re-verification instead of re-deriving, focuses deep verification on failed items with quick regression checks on passed items

1.5.10 - 2025-01-15

Changed

• Milestone audit now reads existing phase VERIFICATION.md files instead of re-verifying each phase, aggregates tech debt and deferred gaps, adds tech_debt status for non-blocking accumulated debt

Fixed

• VERIFICATION.md now included in phase completion commit alongside ROADMAP.md, STATE.md, and REQUIREMENTS.md

1.5.9 - 2025-01-15

Added

• Milestone audit system (/gsd:audit-milestone) for verifying milestone completion with parallel verification agents

Changed

• Checkpoint display format improved with box headers and unmissable "→ YOUR ACTION:" prompts
• Subagent colors updated (executor: yellow, integration-checker: blue)
• Execute-phase now recommends /gsd:audit-milestone when milestone completes

Fixed

• Research-phase no longer gatekeeps by domain type

Removed

• Domain expertise feature (~/.claude/skills/expertise/) - was personal tooling not available to other users

1.5.8 - 2025-01-15

Added

• Verification loop: When gaps are found, verifier generates fix plans that execute automatically before re-verifying

Changed

• gsd-executor subagent color changed from red to blue

1.5.7 - 2025-01-15

Added

• gsd-executor subagent: Dedicated agent for plan execution with full workflow logic built-in
• gsd-verifier subagent: Goal-backward verification that checks if phase goals are actually achieved (not just tasks completed)
• Phase verification: Automatic verification runs when a phase completes to catch stubs and incomplete implementations
• Goal-backward planning reference: Documentation for deriving must-haves from goals

Changed

• execute-plan and execute-phase now spawn gsd-executor subagent instead of using inline workflow
• Roadmap and planning workflows enhanced with goal-backward analysis

Removed

• Obsolete templates (checkpoint-resume.md, subagent-task-prompt.md) — logic now lives in subagents

Fixed

• Updated remaining general-purpose subagent references to use gsd-executor

1.5.6 - 2025-01-15

Changed

• README: Separated flow into distinct steps (1 → 1.5 → 2 → 3 → 4 → 5) making research-project clearly optional and define-requirements required
• README: Research recommended for quality; skip only for speed

Fixed

• execute-phase: Phase metadata (timing, wave info) now bundled into single commit instead of separate commits

1.5.5 - 2025-01-15

Changed

• README now documents the research-project → define-requirements flow (optional but recommended before create-roadmap)
• Commands section reorganized into 7 grouped tables (Setup, Execution, Verification, Milestones, Phase Management, Session, Utilities) for easier scanning
• Context Engineering table now includes research/ and REQUIREMENTS.md

1.5.4 - 2025-01-15

Changed

• Research phase now loads REQUIREMENTS.md to focus research on concrete requirements (e.g., "email verification") rather than just high-level roadmap descriptions

1.5.3 - 2025-01-15

Changed

• execute-phase narration: Orchestrator now describes what each wave builds before spawning agents, and summarizes what was built after completion. No more staring at opaque status updates.
• new-project flow: Now offers two paths — research first (recommended) or define requirements directly (fast path for familiar domains)
• define-requirements: Works without prior research. Gathers requirements through conversation when FEATURES.md doesn't exist.

Removed

• Dead /gsd:status command (referenced abandoned background agent model)
• Unused agent-history.md template
• _archive/ directory with old execute-phase version

1.5.2 - 2026-01-15

Added

• Requirements traceability: roadmap phases now include Requirements: field listing which REQ-IDs they cover
• plan-phase loads REQUIREMENTS.md and shows phase-specific requirements before planning
• Requirements automatically marked Complete when phase finishes

Changed

• Workflow preferences (mode, depth, parallelization) now asked in single prompt instead of 3 separate questions
• define-requirements shows full requirements list inline before commit (not just counts)
• Research-project and workflow aligned to both point to define-requirements as next step

Fixed

• Requirements status now updated by orchestrator (commands) instead of subagent workflow, which couldn't determine phase completion

1.5.1 - 2026-01-14

Changed

• 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

1.5.0 - 2026-01-14

Added

• New /gsd:research-project command for pre-roadmap ecosystem research — spawns parallel agents to investigate stack, features, architecture, and pitfalls before you commit to a roadmap
• New /gsd:define-requirements command 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

Changed

• 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

Removed

• Deleted obsolete _archive/execute-phase.md and status.md commands

1.4.28 - 2026-01-14

Fixed

• 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

Changed

• Slimmed execute-phase command to properly delegate checkpoint handling to workflow

1.4.27 - 2025-01-14

Fixed

• 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

Added

• Full changelog history backfilled from git (66 historical versions from 1.0.0 to 1.4.23)

1.4.25 - 2026-01-14

Added

• New /gsd:whats-new command 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

Added

• USER-SETUP.md template for external service configuration

Removed

• BREAKING: ISSUES.md system (replaced by phase-scoped UAT issues and TODOs)

1.4.23 - 2026-01-14

Changed

• Removed dead ISSUES.md system code

1.4.22 - 2026-01-14

Added

• Subagent isolation for debug investigations with checkpoint support

Fixed

• DEBUG_DIR path constant to prevent typos in debug workflow

1.4.21 - 2026-01-14

Fixed

• SlashCommand tool added to plan-fix allowed-tools

1.4.20 - 2026-01-14

Fixed

• Standardized debug file naming convention
• Debug workflow now invokes execute-plan correctly

1.4.19 - 2026-01-14

Fixed

• Auto-diagnose issues instead of offering choice in plan-fix

1.4.18 - 2026-01-14

Added

• Parallel diagnosis before plan-fix execution

1.4.17 - 2026-01-14

Changed

• Redesigned verify-work as conversational UAT with persistent state

1.4.16 - 2026-01-13

Added

• Pre-execution summary for interactive mode in execute-plan
• Pre-computed wave numbers at plan time

1.4.15 - 2026-01-13

Added

• Context rot explanation to README header

1.4.14 - 2026-01-13

Changed

• YOLO mode is now recommended default in new-project

1.4.13 - 2026-01-13

Fixed

• Brownfield flow documentation
• Removed deprecated resume-task references

1.4.12 - 2026-01-13

Changed

• execute-phase is now recommended as primary execution command

1.4.11 - 2026-01-13

Fixed

• Checkpoints now use fresh continuation agents instead of resume

1.4.10 - 2026-01-13

Changed

• execute-plan converted to orchestrator pattern for performance

1.4.9 - 2026-01-13

Changed

• Removed subagent-only context from execute-phase orchestrator

Fixed

• Removed "what's out of scope" question from discuss-phase

1.4.8 - 2026-01-13

Added

• TDD reasoning explanation restored to plan-phase docs

1.4.7 - 2026-01-13

Added

• Project state loading before execution in execute-phase

Fixed

• Parallel execution marked as recommended, not experimental

1.4.6 - 2026-01-13

Added

• Checkpoint pause/resume for spawned agents
• Deviation rules, commit rules, and workflow references to execute-phase

1.4.5 - 2026-01-13

Added

• Parallel-first planning with dependency graphs
• Checkpoint-resume capability for long-running phases
• .claude/rules/ directory for auto-loaded contribution rules

Changed

• execute-phase uses wave-based blocking execution

1.4.4 - 2026-01-13

Fixed

• Inline listing for multiple active debug sessions

1.4.3 - 2026-01-13

Added

• /gsd:debug command for systematic debugging with persistent state

1.4.2 - 2026-01-13

Fixed

• Installation verification step clarification

1.4.1 - 2026-01-13

Added

• Parallel phase execution via /gsd:execute-phase
• Parallel-aware planning in /gsd:plan-phase
• /gsd:status command for parallel agent monitoring
• Parallelization configuration in config.json
• Wave-based parallel execution with dependency graphs

Changed

• Renamed execute-phase.md workflow to execute-plan.md for clarity
• Plan frontmatter now includes wave, depends_on, files_modified, autonomous

1.4.0 - 2026-01-12

Added

• 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

Changed

• Plans can now specify wave numbers and dependencies
• execute-phase orchestrates multiple subagents in waves

1.3.34 - 2026-01-11

Added

• /gsd:add-todo and /gsd:check-todos for mid-session idea capture

1.3.33 - 2026-01-11

Fixed

• Consistent zero-padding for decimal phase numbers (e.g., 01.1)

Changed

• Removed obsolete .claude-plugin directory

1.3.32 - 2026-01-10

Added

• /gsd:resume-task for resuming interrupted subagent executions

1.3.31 - 2026-01-08

Added

• Planning principles for security, performance, and observability
• Pro patterns section in README

1.3.30 - 2026-01-08

Added

• verify-work option surfaces after plan execution

1.3.29 - 2026-01-08

Added

• /gsd:verify-work for conversational UAT validation
• /gsd:plan-fix for fixing UAT issues
• UAT issues template

1.3.28 - 2026-01-07

Added

• --config-dir CLI argument for multi-account setups
• /gsd:remove-phase command

Fixed

• Validation for --config-dir edge cases

1.3.27 - 2026-01-07

Added

• Recommended permissions mode documentation

Fixed

• Mandatory verification enforced before phase/milestone completion routing

1.3.26 - 2026-01-06

Added

• Claude Code marketplace plugin support

Fixed

• Phase artifacts now committed when created

1.3.25 - 2026-01-06

Fixed

• Milestone discussion context persists across /clear

1.3.24 - 2026-01-06

Added

• CLAUDE_CONFIG_DIR environment variable support

1.3.23 - 2026-01-06

Added

• Non-interactive install flags (--global, --local) for Docker/CI

1.3.22 - 2026-01-05

Changed

• Removed unused auto.md command

1.3.21 - 2026-01-05

Changed

• TDD features use dedicated plans for full context quality

1.3.20 - 2026-01-05

Added

• Per-task atomic commits for better AI observability

1.3.19 - 2026-01-05

Fixed

• Clarified create-milestone.md file locations with explicit instructions

1.3.18 - 2026-01-05

Added

• YAML frontmatter schema with dependency graph metadata
• Intelligent context assembly via frontmatter dependency graph

1.3.17 - 2026-01-04

Fixed

• Clarified depth controls compression, not inflation in planning

1.3.16 - 2026-01-04

Added

• Depth parameter for planning thoroughness (--depth=1-5)

1.3.15 - 2026-01-01

Fixed

• TDD reference loaded directly in commands

1.3.14 - 2025-12-31

Added

• TDD integration with detection, annotation, and execution flow

1.3.13 - 2025-12-29

Fixed

• Restored deterministic bash commands
• Removed redundant decision_gate

1.3.12 - 2025-12-29

Fixed

• Restored plan-format.md as output template

1.3.11 - 2025-12-29

Changed

• 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

Fixed

• Explicit plan count check in offer_next step

1.3.9 - 2025-12-27

Added

• Evolutionary PROJECT.md system with incremental updates

1.3.8 - 2025-12-18

Added

• Brownfield/existing projects section in README

1.3.7 - 2025-12-18

Fixed

• Improved incremental codebase map updates

1.3.6 - 2025-12-18

Added

• File paths included in codebase mapping output

1.3.5 - 2025-12-17

Fixed

• Removed arbitrary 100-line limit from codebase mapping

1.3.4 - 2025-12-17

Fixed

• Inline code for Next Up commands (avoids nesting ambiguity)

1.3.3 - 2025-12-17

Fixed

• Check PROJECT.md not .planning/ directory for existing project detection

1.3.2 - 2025-12-17

Added

• Git commit step to map-codebase workflow

1.3.1 - 2025-12-17

Added

• /gsd:map-codebase documentation in help and README

1.3.0 - 2025-12-17

Added

• /gsd:map-codebase command 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

Changed

• Improved continuation UI with context and visual hierarchy

Fixed

• Permission errors for non-DSP users (removed shell context)
• First question is now freeform, not AskUserQuestion

1.2.13 - 2025-12-17

Added

• Improved continuation UI with context and visual hierarchy

1.2.12 - 2025-12-17

Fixed

• First question should be freeform, not AskUserQuestion

1.2.11 - 2025-12-17

Fixed

• Permission errors for non-DSP users (removed shell context)

1.2.10 - 2025-12-16

Fixed

• Inline command invocation replaced with clear-then-paste pattern

1.2.9 - 2025-12-16

Fixed

• Git init runs in current directory

1.2.8 - 2025-12-16

Changed

• Phase count derived from work scope, not arbitrary limits

1.2.7 - 2025-12-16

Fixed

• AskUserQuestion mandated for all exploration questions

1.2.6 - 2025-12-16

Changed

• Internal refactoring

1.2.5 - 2025-12-16

Changed

• <if mode> tags for yolo/interactive branching

1.2.4 - 2025-12-16

Fixed

• Stale CONTEXT.md references updated to new vision structure

1.2.3 - 2025-12-16

Fixed

• Enterprise language removed from help and discuss-milestone

1.2.2 - 2025-12-16

Fixed

• new-project completion presented inline instead of as question

1.2.1 - 2025-12-16

Fixed

• AskUserQuestion restored for decision gate in questioning flow

1.2.0 - 2025-12-15

Changed

• Research workflow implemented as Claude Code context injection

1.1.2 - 2025-12-15

Fixed

• YOLO mode now skips confirmation gates in plan-phase

1.1.1 - 2025-12-15

Added

• README documentation for new research workflow

1.1.0 - 2025-12-15

Added

• Pre-roadmap research workflow
• /gsd:research-phase for niche domain ecosystem discovery
• /gsd:research-project command with workflow and templates
• /gsd:create-roadmap command with research-aware workflow
• Research subagent prompt templates

Changed

• new-project split to only create PROJECT.md + config.json
• Questioning rewritten as thinking partner, not interviewer

1.0.11 - 2025-12-15

Added

• /gsd:research-phase for niche domain ecosystem discovery

1.0.10 - 2025-12-15

Fixed

• Scope creep prevention in discuss-phase command

1.0.9 - 2025-12-15

Added

• Phase CONTEXT.md loaded in plan-phase command

1.0.8 - 2025-12-15

Changed

• PLAN.md included in phase completion commits

1.0.7 - 2025-12-15

Added

• Path replacement for local installs

1.0.6 - 2025-12-15

Changed

• Internal improvements

1.0.5 - 2025-12-15

Added

• Global/local install prompt during setup

Fixed

• Bin path fixed (removed ./)
• .DS_Store ignored

1.0.4 - 2025-12-15

Fixed

• Bin name and circular dependency removed

1.0.3 - 2025-12-15

Added

• TDD guidance in planning workflow

1.0.2 - 2025-12-15

Added

• Issue triage system to prevent deferred issue pile-up

1.0.1 - 2025-12-15

Added

• Initial npm package release

1.0.0 - 2025-12-14

Added

• 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