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.

2026-06-012

sg-toggle-review

gyuha/super-gsd

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.

2026-06-012

sg-toggle-tdd

gyuha/super-gsd

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.

2026-06-012

sg-next

gyuha/super-gsd

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.

2026-06-012

# --- BEGIN STATE.md Phase parsing block --- PHASE_LINE=$(grep -E '^Phase:' .planning/STATE.md 2>/dev/null | head -1 | sed -E 's/^Phase:[[:space:]]*//' | sed -E 's/[[:space:]]+$//') [ -z "$PHASE_LINE" ] && PHASE_LINE="(none)" PHASE_NUM=$(echo "$PHASE_LINE" | grep -oE '^[0-9]+' || echo "") # --- END STATE.md Phase parsing block ---

# --- BEGIN HANDOFF.md stage detection block --- LAST_ROW=$(grep -E '^\| [0-9]{4}-' .planning/HANDOFF.md 2>/dev/null | tail -1) if [ -z "$LAST_ROW" ]; then STAGE_RAW="init" TS="" else STAGE_RAW=$(echo "$LAST_ROW" | awk -F'|' '{gsub(/ /,"",$5); print $5}') TS=$(echo "$LAST_ROW" | awk -F'|' '{gsub(/ /,"",$2); print $2}') case "$STAGE_RAW" in gsd-plan|ui-plan|superpowers|parallel|execute|tdd|review|sg-retro|ship|complete|sg-next) ;; *) echo "Unknown stage '${STAGE_RAW}' in .planning/HANDOFF.md last row. Schema may be corrupted." >&2; exit 1 ;; esac # sg-next is a meta-transition row, so use the preceding FROM column ($4) as the actual current stage if [ "$STAGE_RAW" = "sg-next" ]; then STAGE_RAW=$(echo "$LAST_ROW" | awk -F'|' '{gsub(/ /,"",$4); print $4}') # If FROM is also sg-next (corrupted chain), scan back for the last real stage if [ "$STAGE_RAW" = "sg-next" ] || [ -z "$STAGE_RAW" ]; then STAGE_RAW=$(grep -E '^\| [0-9]{4}-' .planning/HANDOFF.md 2>/dev/null \ | awk -F'|' '{gsub(/ /,"",$5); print $5}' \ | grep -vE '^sg-next$' | tail -1) [ -z "$STAGE_RAW" ] && STAGE_RAW="init" fi # Re-validate after scan-back — corrupt HANDOFF.md data must not propagate to FROM_STAGE case "$STAGE_RAW" in init|gsd-plan|ui-plan|superpowers|parallel|execute|tdd|review|sg-retro|ship|complete) ;; *) echo "Scan-back recovered unknown stage '${STAGE_RAW}' — defaulting to init." >&2; STAGE_RAW="init" ;; esac fi fi # --- END HANDOFF.md stage detection block ---

# --- BEGIN next-command routing block --- if [ "$STAGE_RAW" = "sg-retro" ] || [ "$STAGE_RAW" = "ship" ]; then if echo "$PHASE_NUM" | grep -qE '^[0-9]+$'; then NEXT_PHASE=$((PHASE_NUM + 1)) if grep -qE "^### Phase ${NEXT_PHASE}:" .planning/ROADMAP.md 2>/dev/null; then NEXT_PHASE_EXISTS=1 else NEXT_PHASE_EXISTS=0 fi else NEXT_PHASE_EXISTS=0 fi fi case "$STAGE_RAW" in init) if [ -n "$PHASE_NUM" ]; then NEXT_CMD="\$sg-plan $PHASE_NUM" else NEXT_CMD="\$sg-plan" fi ;; gsd-plan) NEXT_CMD="\$sg-execute" ;; ui-plan) NEXT_CMD="\$sg-execute" ;; superpowers|parallel|execute|tdd|review) # Skip-aware routing for the implementation→ship segment. Reads super_gsd config: # tdd_mode (execute only) → run $sg-tdd; skip_review → omit $sg-review; skip_learn → omit $sg-learn. # With all flags false/absent this reproduces the prior fixed routing exactly. NEXT_CMD=$(SG_STAGE="$STAGE_RAW" node -e 'let c={};try{c=(require("./.planning/config.json").super_gsd)||{}}catch(e){}var tdd=!!c.tdd_mode,sr=!!c.skip_review,sl=!!c.skip_learn,s=process.env.SG_STAGE,n;if(s==="execute"&&tdd){n="sg-tdd"}else if(s==="review"){n=sl?"sg-ship":"sg-learn"}else{n=sr?(sl?"sg-ship":"sg-learn"):"sg-review"}process.stdout.write("$"+n)' 2>/dev/null) [ -z "$NEXT_CMD" ] && NEXT_CMD="\$sg-review" ;; sg-retro) NEXT_CMD="\$sg-ship" ;; ship) if [ "$NEXT_PHASE_EXISTS" = "1" ]; then NEXT_CMD="\$sg-plan $NEXT_PHASE" else NEXT_CMD="\$sg-complete" fi ;; complete) NEXT_CMD="\$sg-new" ;; *) NEXT_CMD="(unknown stage: $STAGE_RAW)" ;; esac # --- END next-command routing block ---

HANDOFF_FILE=".planning/HANDOFF.md" if [ ! -f "$HANDOFF_FILE" ] || ! grep -q "Timestamp.*Phase.*From.*To.*Plan Hash" "$HANDOFF_FILE" 2>/dev/null; then mkdir -p "$(dirname "$HANDOFF_FILE")" printf '| Timestamp | Phase | From | To | Plan Hash | User |\n| --- | --- | --- | --- | --- | --- |\n' > "$HANDOFF_FILE" fi PHASE_PAD=$(printf "%02d" "${PHASE_NUM:-0}" 2>/dev/null || echo "${PHASE_NUM:-0}") PHASE_SLUG=$(ls -d .planning/phases/${PHASE_PAD}-* 2>/dev/null | head -1 | xargs basename 2>/dev/null) [ -z "$PHASE_SLUG" ] && PHASE_SLUG="${PHASE_NUM:-unknown}" FROM_STAGE="$STAGE_RAW" if [ "$STAGE_RAW" != "complete" ] && [ "$STAGE_RAW" != "init" ]; then TS=$(date -u +%Y-%m-%dT%H:%M:%SZ) GIT_USER=$(git config user.name 2>/dev/null || echo "-") [ -z "$GIT_USER" ] && GIT_USER="-" echo "| $TS | $PHASE_SLUG | $FROM_STAGE | sg-next | - | $GIT_USER |" >> "$HANDOFF_FILE" fi

name	sg-next
description	Detect the current workflow stage from HANDOFF.md and STATE.md and report the next sg-* skill to activate.
argument-hint	No arguments needed.