
Archive completed milestone and prepare for next version
Build, query, and inspect the project knowledge graph in .planning/graphs/
Import a GSD-2 (.gsd/) project back to GSD v1 (.planning/) format
--- name: gsd:debug description: Systematic debugging with persistent state across context resets argument-hint: [list | status <slug> | continue <slug> | --diagnose] [issue description] allowed-tools: - Read - Bash - Task - AskUserQuestion --- <objective> Debug issues using scientific method with subagent isolation. **Orchestrator role:** Gather symptoms, spawn gsd-debugger agent, handle checkpoints, spawn continuations. **Why subagent:** Investigation burns context fast. Fresh 200k
Execute all plans in a phase with wave-based parallelization
Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
Initialize a new project using Documentation-Driven Development. Research, then write user-facing docs (SPEC.md) as the spec, then user validates docs, then phases derive from doc sections. Best for CLIs, libraries, SDKs, APIs, plugin systems, anything with a well-defined user-facing surface.
Gather phase context through adaptive questioning before planning. Use --all to skip area selection and discuss all gray areas interactively. Use --auto to skip interactive questions (Claude picks recommended defaults). Use --chain for interactive discuss followed by automatic plan+execute. Use --power for bulk question generation into a file-based UI (answer at your own pace).
Reapply local modifications after a GSD update
Create detailed phase plan (PLAN.md) with verification loop
Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
Manage persistent context threads for cross-session work
Schedule a future resume of work - e.g. '/gsd:resume-at 09:00', '/gsd:resume-at +2h', or '/gsd:resume-at 04:00 --cmd /gsd:execute-phase 9'
Manage parallel workstreams — list, create, switch, status, progress, complete, and resume
Resume work from previous session with full context restoration
Socratic spec refinement — clarify WHAT a phase delivers with ambiguity scoring before discuss-phase. Produces a SPEC.md with falsifiable requirements locked before implementation decisions begin.
Research how to implement a phase (standalone - usually use /gsd:plan-phase instead)
Add an idea to the backlog parking lot (999.x numbering)
Query, inspect, or refresh codebase intelligence files in .planning/intel/
Print the installed GSD plugin version and check online for updates
Capture or review how this project connects to external systems (GitHub, AWS, npm, SSH, etc.) so future sessions know the auth recipe. Auto-detection hook logs candidate captures to an inbox; this skill promotes them to permanent recipes in `.planning/AUTH-RECIPES.md` and optionally to user-global memory at `~/.claude/auth-recipes/`.
Extract decisions, lessons, patterns, and surprises from completed phase artifacts
Plan an MVP-mode phase — captures an "As a / I want to / So that" user story, runs SPIDR splitting, then delegates to plan-phase
Review source files changed during a phase for bugs, security issues, and code quality problems
Analyze phase dependencies and suggest Depends on entries for ROADMAP.md
Generate or update project documentation verified against the codebase
Retroactively audit an executed AI phase's evaluation coverage — scores each eval dimension as COVERED/PARTIAL/MISSING and produces an actionable EVAL-REVIEW.md with remediation plan
Execute a trivial task inline — no subagents, no planning overhead
Post-mortem investigation for failed GSD workflows — analyzes git history, artifacts, and state to diagnose what went wrong
Diagnose planning directory health and optionally repair issues
Ingest external plans with conflict detection against project decisions before writing anything.
Triage and review all open GitHub issues and PRs against project templates and contribution guidelines
Scan a repo for mixed ADRs, PRDs, SPECs, and DOCs and bootstrap or merge the full .planning/ setup from them. Classifies each doc in parallel, synthesizes a consolidated context with a conflicts report, and routes to new-project or merge-milestone depending on whether .planning/ already exists.
Join the GSD Discord community
Surface Claude's assumptions about a phase approach before planning
Generate a comprehensive project summary from milestone artifacts for team onboarding and review
Initialize a new project with deep context gathering and PROJECT.md
Automatically advance to the next logical step in the GSD workflow
Zero-friction idea capture. Append, list, or promote notes to todos.
Create context handoff when pausing work mid-phase
Create phases to close all gaps identified by milestone audit
Remove a GSD workspace and clean up worktrees
Review and promote backlog items to active milestone
Rapid codebase assessment — lightweight alternative to /gsd:map-codebase
Generate a session report with token usage estimates, work summary, and outcomes
Create PR, run review, and prepare for merge after verification passes
Sketch UI/design ideas with throwaway HTML mockups, or propose what to sketch next (frontier mode)
Package sketch design findings into a persistent project skill for future build conversations
Safe git revert. Roll back phase or plan commits using the phase manifest with dependency checks.
Update GSD to latest version with changelog display
Retroactively audit and fill Nyquist validation gaps for a completed phase
Validate built features through conversational UAT
Generate UI design contract (UI-SPEC.md) for frontend phases
Create an isolated workspace with repo copies and independent .planning/
Start a new milestone cycle — update PROJECT.md and route to requirements
List active GSD workspaces and their status
Insert urgent work as decimal phase (e.g., 72.1) between existing phases
Package spike findings into a persistent project skill for future build conversations
Configure GSD workflow toggles and model profile
Route freeform text to the right GSD command automatically
Retroactively verify threat mitigations for a completed phase
Switch model profile for GSD agents (quality/balanced/budget/inherit)
Check project progress, show context, and route to next action (execute or plan). Use --forensic to append a 6-check integrity audit after the standard report.
Remove a future phase from roadmap and renumber subsequent phases
Generate developer behavioral profile and create Claude-discoverable artifacts
Create a clean PR branch by filtering out .planning/ commits — ready for code review
Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone
Interactive command center for managing multiple phases from one terminal
Auto-fix issues found by code review in REVIEW.md. Spawns fixer agent, commits each fix atomically, produces REVIEW-FIX.md summary.
Run all remaining phases autonomously — discuss→plan→execute per phase
Autonomous audit-to-fix pipeline — find issues, classify, fix, test, commit
Generate tests for a completed phase based on UAT criteria and implementation
Capture idea or task as todo from current conversation context
Request cross-AI peer review of phase plans from external AI CLIs
Generate AI design contract (AI-SPEC.md) for phases that involve building AI systems — framework selection, implementation guidance from official docs, and evaluation strategy
Spike an idea through experiential exploration, or propose what to spike next (frontier mode)
Archive accumulated phase directories from completed milestones
Socratic ideation and idea routing — think through ideas before committing to plans
Show available GSD commands and usage guide
Display project statistics — phases, plans, requirements, git metrics, and timeline
[BETA] Offload plan phase to Claude Code's ultraplan cloud — drafts remotely while terminal stays free, review in browser with inline comments, import back via /gsd:import. Claude Code only.
Retroactive 6-pillar visual audit of implemented frontend code
Audit milestone completion against original intent before archiving
Add phase to end of current milestone in roadmap
Cross-phase audit of all outstanding UAT and verification items
List pending todos and select one to work on