open-gsd/gsd-core

AI Integration Phase generates an AI-SPEC.md design contract for phases that involve building AI systems. It orchestrates framework selection, research, and evaluation strategy design.

Add Tests generates unit and E2E tests for a completed phase based on UAT criteria and implementation. Use it to classify implementation files, approve a test plan, and commit tests following RED-GREEN conventions.

Complete Milestone archives a finished milestone to the milestones directory, updates ROADMAP.md and REQUIREMENTS.md, and creates a git tag. Use it after all phases pass audit to close out a version and prepare for the next milestone.

Execute Phase runs all plans in a phase using wave-based parallel execution with subagents. It discovers plans, analyzes dependencies, groups them into waves, and collects results while preserving checkpoints and verification gates.

GSD Audit Fix runs an audit, classifies findings as auto-fixable or manual-only, then fixes auto-fixable issues with test verification and atomic commits. Use it when you want to automate code audit remediation in Claude Code.

GSD Audit Milestone audits milestone completion against original intent before archiving. It checks requirements coverage, cross-phase integration, and end-to-end flows by reading existing verification files and spawning an integration checker.

GSD Audit UAT scans all planning phases for pending, skipped, blocked, and human_needed UAT and verification items, cross-references the codebase to detect stale documentation, and produces a prioritized human test plan. Use it before release or when UAT status is unclear to ensure all verification work is accounted for.

GSD Autonomous runs all remaining milestone phases autonomously, moving through discuss, plan, and execute for each phase. Use it to advance a project through its roadmap without manually invoking each phase.

GSD Capture routes ideas, tasks, notes, and seeds to the correct GSD planning destination, such as todos, backlog, notes, or seed files. Use it when capturing an item during Claude Code sessions to avoid deciding where it should live.

GSD Cleanup archives phase directories from completed milestones into .planning/milestones/v{X.Y}-phases/. Use when .planning/phases/ has accumulated directories from past milestones.

GSD Code Review analyzes source files changed during a phase for bugs, security vulnerabilities, and code quality problems. It spawns a code reviewer agent to produce a severity-classified REVIEW.md artifact.

GSD Config configures GSD settings — workflow toggles, advanced knobs, integrations, and model profile — for Claude Code. Use it to switch model profiles, manage API keys, and tune planning and execution settings.

GSD Debug systematically debugs issues using the scientific method with subagent isolation, maintaining persistent state across context resets. It orchestrates a debugger subagent and session manager, supports a diagnose-only mode, and lets users list, check status, or continue debug sessions.

GSD Discuss Phase gathers phase context through adaptive questioning before planning. It loads prior context, scouts the codebase, identifies undecided gray areas, and produces a CONTEXT.md with implementation decisions for downstream agents.

GSD Docs Update generates and updates up to nine project documentation files verified against the codebase. Use it when you need current, accurate docs without hallucinated paths or stale signatures.

GSD Eval Review audits a completed AI phase's evaluation coverage against the plan in AI-SPEC.md and produces an EVAL-REVIEW.md remediation plan. Use it after executing an AI phase to verify whether the evaluation strategy was implemented.

GSD Explore runs a Socratic ideation session that probes an idea with questions and optionally spawns research, then routes the outputs to GSD artifacts like notes, todos, seeds, research questions, requirements, or phases.

GSD Extract Learnings pulls decisions, lessons, patterns, and surprises from completed phase artifacts into a LEARNINGS.md file. Use it after a GSD phase completes to capture retrospective insights from PLAN.md, SUMMARY.md, VERIFICATION.md, UAT.md, and STATE.md.

GSD Fast executes a trivial task directly in the current context without spawning subagents or generating PLAN.md files. Use it for typo fixes, config changes, small refactors, forgotten commits, or simple additions that take under two minutes.

GSD Forensics investigates what went wrong during a GSD workflow execution by analyzing git history, planning artifacts, and file system state to detect anomalies and generate a structured diagnostic report. Use it after a failed or stuck workflow to determine root cause and take corrective action.

GSD Graphify builds, queries, and inspects the project knowledge graph stored in .planning/graphs/. Use it to build or rebuild the graph, search for terms, check status and diff, or see changes since last build.

GSD Health validates .planning/ directory integrity and reports actionable issues. Use --repair to fix problems and --context to check the current session's context utilization.

GSD Help shows available GSD commands and usage guides at the tier the user requests, from brief one-line refreshers to full reference. Use it when a user asks for help with GSD commands.

GSD Import ingests external plan files into the GSD planning system, detecting conflicts against PROJECT.md decisions before writing anything. It also reverse-migrates GSD-2 projects back to the v1 format.

GSD Inbox triages open GitHub issues and pull requests against project templates and contribution guidelines. Use it to review submissions, report completeness, and optionally label or close non-compliant items.