/gsd-code-review N
Review phase changes for bugs, security issues, and code quality problems.
Syntax
gsd-code-reviewer agent to analyze source files changed during the specified phase. Produces a REVIEW.md artifact in the phase directory with severity-classified findings. With --fix, spawns a gsd-code-fixer agent to apply the found issues. All three depth levels use the phase’s SUMMARY.md and git diff to scope the file set.
Produces
{padded_phase}-REVIEW.md — findings classified as Critical, Warning, or Info, with file references and remediation suggestions.
Flags
Review depth. Accepted values:
quick— Pattern-matching only (~2 min)standard— Per-file analysis with language-specific checks (~5–15 min, default)deep— Cross-file analysis including import graphs and call chains (~15–30 min)
Comma-separated explicit file list. Bypasses
SUMMARY.md extraction and git diff scoping entirely. Highest precedence for file selection. Example: --files src/api.ts,src/middleware.ts.After review completes (or if
REVIEW.md already exists), auto-apply fixes. Spawns a gsd-code-fixer agent. Combines with the sub-flags below.Expand the fix scope to include Info-level findings in addition to the default Critical + Warning.
Enable a fix → re-review iteration loop, capped at 3 cycles, until no Critical or Warning findings remain.
/gsd-audit-fix
Autonomous audit-to-fix pipeline: find issues, classify, fix, test, commit.
Syntax
Which audit to run. Default:
audit-uat. Pass the audit type name as the value.Minimum severity to process. Accepted values:
high, medium, all. Default: medium.Maximum number of findings to fix in a single run. Default:
5.Classify findings and show the classification table — auto-fixable vs manual-only — without applying any fixes.
/gsd-add-tests N
Generate unit and end-to-end tests for a completed phase.
Syntax
SUMMARY.md, CONTEXT.md, and VERIFICATION.md as specifications. Classifies each file as TDD (unit tests), E2E (browser tests), or Skip, presents the test plan for your approval, then generates tests following RED-GREEN conventions. Any additional instructions you include after the phase number are passed through to the test generator.
Produces
Test files committed with message test(phase-{N}): add unit and E2E tests from add-tests command.
/gsd-secure-phase N
Retroactively verify threat mitigations for a completed phase.
Syntax
SECURITY.md already exists it audits and verifies the mitigations; if only a PLAN.md with a threat model exists it runs the analysis from those artifacts; if the phase was never executed it exits with guidance. Omit the phase number to default to the last completed phase.
Produces
Updated {phase_num}-SECURITY.md — threat list with mitigation status and any remaining gaps.
/gsd-ui-review N
Six-pillar visual frontend audit of implemented code.
Syntax
{phase_num}-UI-REVIEW.md — graded assessment across the six pillars with specific improvement recommendations per finding.
/gsd-validate-phase N
Retroactive Nyquist test coverage audit for a completed phase.
Syntax
VALIDATION.md already exists it audits and fills any gaps. If no VALIDATION.md exists but a SUMMARY.md does it reconstructs the validation state from available artifacts. Omit the phase number to default to the last completed phase.
Produces
Updated VALIDATION.md and generated test files covering any previously unvalidated paths.
/gsd-debug [description]
Systematic debugging with persistent state across context resets.
Syntax
gsd-debugger agent for isolated investigation, handles checkpoints to persist state across context resets, and spawns continuation agents when needed. Subcommands let you list active sessions, check the status of a specific session by slug, or continue an interrupted session.
Flags
Diagnose only. Returns a Root Cause Report with findings but does not apply a fix.
List all active (unresolved) debug sessions.
Show the current status of a specific debug session identified by its slug.
Resume an interrupted debug session by slug, restoring all prior investigation context.
/gsd-forensics [description]
Post-mortem investigation for failed or stuck GSD workflows.
Syntax
.planning/ artifacts, and filesystem state to detect anomalies — stuck loops, missing artifacts, abandoned work, crash/interruption patterns — and generates a structured forensic report. Read-only investigation only: it never modifies your project source files. Omit the description to be prompted interactively.
Produces
.planning/forensics/report-{timestamp}.md — evidence-based findings, anomaly list, root cause analysis, and recommended corrective actions.
/gsd-eval-review N
Audit AI phase evaluation coverage.
Syntax
AI-SPEC.md was actually implemented in the phase’s output. Produces a scored verdict with a list of gaps and a remediation plan. Omit the phase number to default to the last completed phase.
Produces
{phase_num}-EVAL-REVIEW.md — coverage score, verdict (pass/fail), gap list, and remediation steps.
/gsd-review --phase N
Cross-AI peer review of phase plans from external AI CLIs.
Syntax
REVIEWS.md that you can feed back into planning via /gsd-plan-phase --reviews. Detects which CLIs are installed and available before dispatching.
Produces
{phase_num}-REVIEWS.md — per-reviewer feedback with severity classification (HIGH / MEDIUM / LOW) for each concern.
Flags
The phase whose plans you want reviewed.
Include Gemini CLI as a reviewer.
Include a separate Claude CLI session as a reviewer.
Include Codex CLI as a reviewer.
Include OpenCode as a reviewer (uses the model from your OpenCode config).
Include Qwen Code (Alibaba Qwen models) as a reviewer.
Include Cursor agent as a reviewer.
Include Antigravity CLI as a reviewer. Also accepted as
--antigravity.Include CodeRabbit as a reviewer.
Include a local Ollama server as a reviewer.
Include a local LM Studio server as a reviewer.
Include a local llama.cpp server as a reviewer.
Include every available CLI and running local model server as reviewers.