gsd

Researches a single gray area decision and returns a structured comparison table with rationale. Spawned by discuss-phase advisor mode.

Researches a chosen AI framework's official docs to produce implementation-ready guidance — best practices, syntax, core patterns, and pitfalls distilled for the specific use case. Writes the Framework Quick Reference and Implementation Guidance sections of AI-SPEC.md. Spawned by /gsd:ai-integration-phase orchestrator.

Deeply analyzes codebase for a phase and returns structured assumptions with evidence. Spawned by discuss-phase assumptions mode.

Applies fixes to code review findings from REVIEW.md. Reads source files, applies intelligent fixes, and commits each fix atomically. Spawned by /gsd:code-review --fix.

Reviews source files for bugs, security issues, and code quality problems. Produces structured REVIEW.md with severity-classified findings. Spawned by /gsd:code-review.

Explores codebase and writes structured analysis documents. Spawned by map-codebase with a focus area (tech, arch, quality, concerns). Writes documents directly to reduce orchestrator context load.

Manages multi-cycle /gsd:debug checkpoint and continuation loop in isolated context. Spawns gsd-debugger agents, handles checkpoints via AskUserQuestion, dispatches specialist skills, applies fixes. Returns compact summary to main context. Spawned by /gsd:debug command.

Investigates bugs using scientific method, manages debug sessions, handles checkpoints. Spawned by /gsd:debug orchestrator.

Classifies a single planning document as ADR, PRD, SPEC, DOC, or UNKNOWN. Extracts title, scope summary, and cross-references. Spawned in parallel by /gsd:ingest-docs. Writes a JSON classification file and returns a one-line confirmation.

Synthesizes classified planning docs into a single consolidated context. Applies precedence rules, detects cross-ref cycles, enforces LOCKED-vs-LOCKED hard-blocks, and writes INGEST-CONFLICTS.md with three buckets (auto-resolved, competing-variants, unresolved-blockers). Spawned by /gsd:ingest-docs.

Verifies factual claims in generated docs against the live codebase. Returns structured JSON per doc.

Writes and updates project documentation. Spawned with a doc_assignment block specifying doc type, mode (create/update/supplement), and project context.

Researches the business domain and real-world application context of the AI system being built. Surfaces domain expert evaluation criteria, industry-specific failure modes, regulatory context, and what "good" looks like for practitioners in this field — before the eval-planner turns it into measurable rubrics. Spawned by /gsd:ai-integration-phase orchestrator.

Retroactive audit of an implemented AI phase's evaluation coverage. Checks implementation against the AI-SPEC.md evaluation plan. Scores each eval dimension as COVERED/PARTIAL/MISSING. Produces a scored EVAL-REVIEW.md with findings, gaps, and remediation guidance. Spawned by /gsd:eval-review orchestrator.

Designs a structured evaluation strategy for an AI phase. Identifies critical failure modes, selects eval dimensions with rubrics, recommends tooling, and specifies the reference dataset. Writes the Evaluation Strategy, Guardrails, and Production Monitoring sections of AI-SPEC.md. Spawned by /gsd:ai-integration-phase orchestrator.

Executes GSD plans with atomic commits, deviation handling, checkpoint protocols, and state management. Spawned by execute-phase orchestrator or execute-plan command.

Presents an interactive decision matrix to surface the right AI/LLM framework for the user's specific use case. Produces a scored recommendation with rationale. Spawned by /gsd:ai-integration-phase and /gsd-select-framework orchestrators.

Verifies cross-phase integration and E2E flows. Checks that phases connect properly and user workflows complete end-to-end.

Analyzes codebase and writes structured intel files to .planning/intel/.

Fills Nyquist validation gaps by generating tests and verifying coverage for phase requirements

Analyzes codebase for existing patterns and produces PATTERNS.md mapping new files to closest analogs. Read-only codebase analysis spawned by /gsd:plan-phase orchestrator before planning.

Researches how to implement a phase before planning. Produces RESEARCH.md consumed by gsd-planner. Spawned by /gsd:plan-phase orchestrator.

Verifies plans will achieve phase goal before execution. Goal-backward analysis of plan quality. Spawned by /gsd:plan-phase orchestrator.

Creates executable phase plans with task breakdown, dependency analysis, and goal-backward verification. Spawned by /gsd:plan-phase orchestrator.

Researches domain ecosystem before roadmap creation. Produces files in .planning/research/ consumed during roadmap creation. Spawned by /gsd:new-project or /gsd:new-milestone orchestrators.

Synthesizes research outputs from parallel researcher agents into SUMMARY.md. Spawned by /gsd:new-project after 4 researcher agents complete.

Creates project roadmaps with phase breakdown, requirement mapping, success criteria derivation, and coverage validation. Spawned by /gsd:new-project orchestrator.

Verifies threat mitigations from PLAN.md threat model exist in implemented code. Produces SECURITY.md. Spawned by /gsd:secure-phase.

Retroactive 6-pillar visual audit of implemented frontend code. Produces scored UI-REVIEW.md. Spawned by /gsd:ui-review orchestrator.

Validates UI-SPEC.md design contracts against 6 quality dimensions. Produces BLOCK/FLAG/PASS verdicts. Spawned by /gsd:ui-phase orchestrator.

Produces UI-SPEC.md design contract for frontend phases. Reads upstream artifacts, detects design system state, asks only unanswered questions. Spawned by /gsd:ui-phase orchestrator.

Analyzes extracted session messages across 8 behavioral dimensions to produce a scored developer profile with confidence levels and evidence. Spawned by profile orchestration workflows.

Verifies phase goal achievement through goal-backward analysis. Checks codebase delivers what phase promised, not just that tasks completed. Creates VERIFICATION.md report.

Add an idea to the backlog parking lot (999.x numbering)

Add phase to end of current milestone in roadmap

Generate tests for a completed phase based on UAT criteria and implementation

Capture idea or task as todo from current conversation context

Generate AI design contract (AI-SPEC.md) for phases that involve building AI systems — framework selection, implementation guidance from official docs, and evaluation strategy

Analyze phase dependencies and suggest Depends on entries for ROADMAP.md

Autonomous audit-to-fix pipeline — find issues, classify, fix, test, commit

Audit milestone completion against original intent before archiving

Cross-phase audit of all outstanding UAT and verification items

Run all remaining phases autonomously — discuss→plan→execute per phase

List pending todos and select one to work on

Archive accumulated phase directories from completed milestones

Auto-fix issues found by code review in REVIEW.md. Spawns fixer agent, commits each fix atomically, produces REVIEW-FIX.md summary.

Review source files changed during a phase for bugs, security issues, and code quality problems

Archive completed milestone and prepare for next version

<objective>

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).

Route freeform text to the right GSD command automatically

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 all plans in a phase with wave-based parallelization

Socratic ideation and idea routing — think through ideas before committing to plans

Extract decisions, lessons, patterns, and surprises from completed phase artifacts

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

Import a GSD-2 (.gsd/) project back to GSD v1 (.planning/) format

Build, query, and inspect the project knowledge graph in .planning/graphs/

Diagnose planning directory health and optionally repair issues

Show available GSD commands and usage guide

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.

Insert urgent work as decimal phase (e.g., 72.1) between existing phases

Query, inspect, or refresh codebase intelligence files in .planning/intel/

Join the GSD Discord community

Surface Claude's assumptions about a phase approach before planning

List active GSD workspaces and their status

Interactive command center for managing multiple phases from one terminal

Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents

Generate a comprehensive project summary from milestone artifacts for team onboarding and review

Start a new milestone cycle — update PROJECT.md and route to requirements

Initialize a new project with deep context gathering and PROJECT.md

Create an isolated workspace with repo copies and independent .planning/

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

Create detailed phase plan (PLAN.md) with verification loop

Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone

Create a clean PR branch by filtering out .planning/ commits — ready for code review

Generate developer behavioral profile and create Claude-discoverable artifacts

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.

Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents

Reapply local modifications after a GSD update

Remove a future phase from roadmap and renumber subsequent phases

Remove a GSD workspace and clean up worktrees

Research how to implement a phase (standalone - usually use /gsd:plan-phase instead)

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'

Resume work from previous session with full context restoration

Review and promote backlog items to active milestone

Request cross-AI peer review of phase plans from external AI CLIs

Rapid codebase assessment — lightweight alternative to /gsd:map-codebase

Retroactively verify threat mitigations for a completed phase

Generate a session report with token usage estimates, work summary, and outcomes

Switch model profile for GSD agents (quality/balanced/budget/inherit)

Configure GSD workflow toggles and model profile

Create PR, run review, and prepare for merge after verification passes

Package sketch design findings into a persistent project skill for future build conversations

Sketch UI/design ideas with throwaway HTML mockups, or propose what to sketch next (frontier mode)

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.

Package spike findings into a persistent project skill for future build conversations

Spike an idea through experiential exploration, or propose what to spike next (frontier mode)

Display project statistics — phases, plans, requirements, git metrics, and timeline

Manage persistent context threads for cross-session work

Generate UI design contract (UI-SPEC.md) for frontend phases

Retroactive 6-pillar visual audit of implemented frontend code

[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.

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

Manage parallel workstreams — list, create, switch, status, progress, complete, and resume

5 hooks across 5 events