scaffold

Scaffold

Use the Read tool to load skills/scaffold/data/guard-block.md BEFORE any other instruction in this file. The guard is load-bearing; it establishes the orchestrator role, blocks pre-dispatch deferrals, and contains the rationalization-red-flags STOP protocol.

Input: $ARGUMENTS = either add <component> (subcommand mode) OR project description (natural language) + optional flags

Step 0 — Subcommand dispatch

Read the first non-empty token of $ARGUMENTS. If it equals add, branch into the add <component> subcommand body (see ## Subcommand: add <component> at the end of this file). Otherwise, fall through to the new-project flow (Flag Parsing section below).

read -ra ARG_TOKENS <<< "$ARGUMENTS"
FIRST_TOKEN="${ARG_TOKENS[0]:-}"

if [ "$FIRST_TOKEN" = "add" ]; then
  # Subcommand mode — extend an existing project with a single component.
  COMPONENT="${ARG_TOKENS[1]:-}"
  if [ -z "$COMPONENT" ]; then
    echo "[ERROR] Usage: /agent-flow:scaffold add <component>" >&2
    echo "Supported components: claude-md | ci | docker | tests" >&2
    exit 1
  fi
  case "$COMPONENT" in
    claude-md|ci|docker|tests) ;;
    *)
      echo "[ERROR] Unknown component: ${COMPONENT}" >&2
      echo "Supported components: claude-md | ci | docker | tests" >&2
      exit 1
      ;;
  esac
  # Branch into the Subcommand body at the END of this file (## Subcommand: add <component>).
  # The subcommand branch MUST exit after step 6 (Report) and MUST NOT fall through to the new-project flow.
fi

# Otherwise: existing new-project flow continues with Flag Parsing below.

The add subcommand is a single-shot operation and does NOT use resume detection. The new-project flow does — see the resume detection invocation immediately after Flag Parsing / Mode Resolution below.

Flag Parsing

Parse $ARGUMENTS for these flags:

Flag	Variable	Notes
--template <path>	template_path
--spec <path>	spec_path
--issue <ID>	issue_id
--no-implement	no_implement = true
--yolo	GOT_YOLO = true	B6 mode flag
--step-mode	GOT_STEP_MODE = true	B6 mode flag
--lang <v>	preset_lang
--framework <v>	preset_framework
--db <v>	preset_db
--ci <v>	preset_ci
--brainstorm	brainstorm = true
--infra <v>	infra_preset	See validation below