GSD Command Reference
═══════════════════════════════════════════
## Project Management
/gsd:new-project
Initialize new project with goals and roadmap.
Creates .planning/ directory with STATE.md and ROADMAP.md.
Usage:
/gsd:new-project
/gsd:map-codebase [focus-area]
Analyze existing codebase with parallel mapper agents.
Produces 7 documents in .planning/codebase/.
Usage:
/gsd:map-codebase # Map entire codebase
/gsd:map-codebase api # Focus on API subsystem
/gsd:discuss [topic]
Explore ideas and capture decisions in CONTEXT.md.
Lightweight discussion before planning.
Usage:
/gsd:discuss
/gsd:discuss "caching strategy"
## Phase Workflow
/gsd:plan-phase [--no-research] [--gaps]
Create detailed phase plan with research and breakdown.
Flags:
--no-research Skip research agent
--gaps Plan addresses specific gap or issue
Usage:
/gsd:plan-phase
/gsd:plan-phase --no-research
/gsd:plan-phase --gaps
/gsd:execute <phase-number> [--no-verify] [--branch]
Execute phase plan with optional verification.
Arguments:
phase-number Phase number to execute (required)
Flags:
--no-verify Skip post-execution verification
--branch Create feature branch for this phase
Usage:
/gsd:execute 3
/gsd:execute 5 --branch
/gsd:finalize [phase-number]
Review implementation and complete phase.
Creates SUMMARY.md and updates STATE.md.
Usage:
/gsd:finalize
/gsd:finalize 3
## Session Management
/gsd:resume-work
Resume from previous session with full context restoration.
Detects checkpoints and incomplete work.
Usage:
/gsd:resume-work
/gsd:pause-work
Create checkpoint before pausing mid-phase.
Saves complete work state to .continue-here.md.
Usage:
/gsd:pause-work
/gsd:progress
Check project progress and route to next action.
Analyzes recent work and upcoming tasks.
Usage:
/gsd:progress
## Utilities
/gsd:quick [--discuss] [--full]
Execute quick tasks with GSD guarantees.
Flags:
--discuss Enable discussion phase
--full Enable plan-checking and verification
Usage:
/gsd:quick
/gsd:quick --discuss
/gsd:quick --full
/gsd:debug [issue-description]
Systematic debugging with persistent state.
Uses subagents for deep investigation.
Usage:
/gsd:debug # List active sessions
/gsd:debug "login fails with OAuth" # New session
/gsd:add-todo [description]
Capture idea or task as structured todo.
Extracts context from conversation if no description.
Usage:
/gsd:add-todo Add rate limiting
/gsd:add-todo # Extract from context
/gsd:check-todos [area]
List pending todos and select one to work on.
Usage:
/gsd:check-todos # All todos
/gsd:check-todos api # Filter by area
/gsd:settings
Configure GSD workflow agents and model profile.
Interactive 5-question prompt.
Usage:
/gsd:settings
/gsd:set-profile <profile>
Quick switch model profile.
Arguments:
profile quality | balanced | budget (required)
Usage:
/gsd:set-profile balanced
/gsd:set-profile quality
/gsd:health [--repair]
Diagnose and optionally repair planning directory issues.
Flags:
--repair Automatically fix detected issues
Usage:
/gsd:health
/gsd:health --repair
/gsd:help
Show this command reference.
Usage:
/gsd:help
/gsd:update
Update GSD to latest version with changelog.
Usage:
/gsd:update
## Common Workflows
**New Project (Greenfield)**
/gsd:new-project
/gsd:plan-phase
/gsd:execute 1
**New Project (Brownfield)**
/gsd:map-codebase
/gsd:new-project
/gsd:plan-phase
**Daily Work Cycle**
/gsd:resume-work
/gsd:progress
[work]
/gsd:pause-work
**Quick Fix**
/gsd:quick
[describe task]
**Complex Investigation**
/gsd:debug
[gather symptoms]
[agent investigates]
[fix or plan]
**Idea Management**
/gsd:add-todo [idea]
[accumulate todos]
/gsd:check-todos
[work on selected]
═══════════════════════════════════════════
For detailed documentation: https://gsd-docs.example.com
For issues or feedback: https://github.com/gsd/issues
