super-gsd

Detect the current workflow stage from HANDOFF.md and STATE.md and report the next sg-* skill to activate.

Detect existing session or start new project — super-gsd workflow entry point

Display current workflow stage, last handoff timestamp, and next recommended command

Toggle the sg-learn stage on or off in the super-gsd workflow by flipping super_gsd.skip_learn in .planning/config.json. Accepts on|off, or no argument to flip.

Toggle the sg-review stage on or off in the super-gsd workflow by flipping super_gsd.skip_review in .planning/config.json. Accepts on|off, or no argument to flip.

Toggle the sg-tdd stage on or off in the super-gsd workflow by flipping super_gsd.tdd_mode in .planning/config.json. Accepts on|off, or no argument to flip.

Use this when you want to advance to the next workflow stage automatically — reads HANDOFF.md and STATE.md to determine the current stage and immediately invokes the next sg-* command.

Copy super-gsd hook and skill files to the current project — Claude Code in-session installer

Use this when starting or resuming work on a project — detects an existing session via STATE.md and prompts Resume, Start new milestone, or Cancel; falls back to gsd-new-project if no session exists.

Use this when you want to know where you are in the workflow — reads HANDOFF.md and STATE.md to show the current stage and the next recommended command.

Toggle the sg-learn stage on or off in the super-gsd workflow. Flips super_gsd.skip_learn in .planning/config.json so sg-next / sg-status / the stop hook include or skip the sg-retro retrospective after review. Accepts on|off, or no argument to flip.

Toggle the sg-review stage on or off in the super-gsd workflow. Flips super_gsd.skip_review in .planning/config.json so sg-next / sg-status / the stop hook include or skip code review after implementation. Accepts on|off, or no argument to flip.

Toggle the sg-tdd stage on or off in the super-gsd workflow. Flips super_gsd.tdd_mode in .planning/config.json so sg-next / sg-status / the stop hook include or skip TDD verification after execute. Accepts on|off, or no argument to flip.

Use this when execute is complete and TDD verification is required — invokes superpowers:test-driven-development and appends a tdd stage row to HANDOFF.md.

Use this when execute is complete and TDD verification is required — invokes superpowers:test-driven-development and appends a tdd stage row to HANDOFF.md.

Collect context then generate GSD phase plan — gsd-discuss-phase → gsd-plan-phase chain (falls back to prose if GSD not installed)

Use this when a new phase needs to be planned — injects prior lessons, then chains gsd-discuss-phase and gsd-plan-phase automatically.

Run a structured retrospective on a GSD phase with one of three lenses (ssc, dspm, analyze) — select multiple lenses in one call or omit lens argument for smart default (dspm+ssc) — and append results to .planning/lessons/{NN}-{YYYY-MM-DD}.md. `--pick` flag is rejected with a graceful exit explaining positional alternative (no AskUserQuestion in this environment). AskUserQuestion-free version for Codex/Gemini CLI/Antigravity CLI.

Use this when a phase is complete and a structured retrospective is needed — collects phase artifacts and git context, then facilitates one or more of three lenses (ssc, dspm, analyze) and appends results to .planning/lessons/. Smart default (dspm+ssc) runs when no lens argument is provided; pass --pick for interactive lens selection.

Directly perform code review on changed files — prose review mode without Superpowers

Use this when implementation is complete and a code review is needed — derives the git range automatically and invokes superpowers:requesting-code-review.

Read PLAN.md and execute phase tasks sequentially — direct implementation mode without Superpowers

Use this when something feels broken or before onboarding — diagnoses GSD, Superpowers, hooks, HANDOFF.md, and STATE.md installation line by line.

Use this when you need a map of the current codebase structure — invokes gsd-map-codebase to analyse and document the project layout.

Use this when the phase plan is ready and implementation should begin — packages PLAN/REQ/SC and hands off to Superpowers via superpowers:executing-plans.

Use this to edit, remove, or complete a phase — edit/remove delegate to GSD's gsd-phase, while complete reconciles a finished phase's ROADMAP/STATE metadata (an operation gsd-phase does not provide).

Use this when parallel_groups.json exists and independent plan groups should run concurrently — dispatches up to 3 Task() agents, one per group, without calling superpowers:executing-plans.

Merge phase work into main branch and push to remote — GSD ship fallback or direct git merge mode

Complete a phase (bare number → delegates to sg-phase) or close a milestone (vX.Y, or the current milestone when no argument) via gsd-complete-milestone.

Use this when the milestone is ready to be shipped — resolves the current phase and invokes gsd-ship to complete delivery.

Use this when UI design brainstorming is needed before planning a phase — reads phase context from ROADMAP.md and runs superpowers:brainstorming.

Use this to archive accumulated phase directories from completed milestones — delegates to gsd-cleanup, then displays a table of what was archived.

Delegates to sg-retro skill to run a structured retrospective and extract learnable patterns.

Copy super-gsd hook and skill files to the current project — Codex/Gemini in-session installer

Use this when a phase is complete and you want to extract patterns and lessons from the session — delegates to sg-retro for structured retrospective.

Use this when starting a new phase and you want to review prior lessons before planning — lists weighted lessons from .planning/lessons/ as context.

Use this when a milestone is complete and a new one should begin — invokes gsd-new-milestone, then recommends sg-plan for the next phase.

Use this when a small ad-hoc task needs to be done without a full phase plan — runs gsd-planner then superpowers:executing-plans with atomic commits and STATE.md tracking.

Use this when GSD, Superpowers, or super-gsd may be outdated — checks each tool's installation status and installs or updates to the latest version.