@atlashub/smartstack-cli 2.9.0 → 3.0.0

package/templates/skills/efcore/steps/db/step-seed.md

@@ -29,6 +29,16 @@ Populate the database with test or initial data using EF Core conventions.
 ### 1. Environment Check
 
 ```bash
+# Validate required variables from step-00-init
+for VAR_NAME in DBCONTEXT DBCONTEXT_TYPE INFRA_PROJECT STARTUP_PROJECT SELECTED_ENV; do
+  eval VAR_VALUE=\$$VAR_NAME
+  if [ -z "$VAR_VALUE" ]; then
+    echo "ERROR: Required variable $VAR_NAME is not set"
+    echo "Run step-00-init first"
+    exit 1
+  fi
+done
+
 echo "Seed Configuration"
 echo "=================="
 echo ""
@@ -118,9 +128,10 @@ echo ""
 echo "Running seeder class..."
 
 dotnet run --project "$STARTUP_PROJECT" -- --seed
+EXIT_CODE=$?
 
-if [ $? -ne 0 ]; then
-  echo "Seed command failed or not supported."
+if [ $EXIT_CODE -ne 0 ]; then
+  echo "Seed command failed or not supported (exit code: $EXIT_CODE)"
   echo "Check if --seed argument is implemented in Program.cs"
 fi
 ```
@@ -239,6 +250,39 @@ builder.HasData(new User {
 
 ---
 
+## BOTH CONTEXTS:
+
+If `RUN_BOTH=true` (auto-detected for client projects with SmartStack NuGet):
+
+Run the seed sequence for both contexts, in order:
+
+```bash
+# 1. Seed CoreDbContext first (system data: Users, Roles, Permissions...)
+echo "=== Seeding CoreDbContext (core schema) ==="
+DBCONTEXT="CoreDbContext"
+# Run steps 2-6 with CoreDbContext...
+
+# 2. Then ExtensionsDbContext (client data)
+echo ""
+echo "=== Seeding ExtensionsDbContext (extensions schema) ==="
+DBCONTEXT="ExtensionsDbContext"
+# Run steps 2-6 with ExtensionsDbContext...
+```
+
+**Order matters:** Core MUST be seeded first (Extensions may reference Core data via foreign keys).
+
+---
+
+## OPTIONS:
+
+| Option | Description |
+|--------|-------------|
+| `--env {name}` | Use appsettings.{name}.json |
+| `--context {name}` | Specify DbContext |
+| `--method {name}` | Force seed method (hasdata, seeder-class, cli-argument) |
+
+---
+
 ## COMPLETION:
 
 Seed data applied. Use `/efcore db-status` to verify.

package/templates/skills/efcore/steps/db/step-status.md

@@ -18,6 +18,20 @@ Display comprehensive status of EF Core migrations and database connection.
 
 ## EXECUTION SEQUENCE:
 
+### 0. Validate Required Variables
+
+```bash
+# Validate required variables from step-00-init
+for VAR_NAME in DBCONTEXT DBCONTEXT_TYPE INFRA_PROJECT STARTUP_PROJECT SELECTED_ENV; do
+  eval VAR_VALUE=\$$VAR_NAME
+  if [ -z "$VAR_VALUE" ]; then
+    echo "ERROR: Required variable $VAR_NAME is not set"
+    echo "Run step-00-init first"
+    exit 1
+  fi
+done
+```
+
 ### 1. Display Configuration
 
 ```bash

package/templates/skills/efcore/steps/migration/step-01-check.md

@@ -16,6 +16,20 @@ Search for existing migrations for this branch and decide whether to recreate or
 
 ## EXECUTION SEQUENCE:
 
+### 0. Validate Required Variables
+
+```bash
+# Validate required variables from step-00-init
+for VAR_NAME in DBCONTEXT DBCONTEXT_TYPE MIGRATIONS_DIR INFRA_PROJECT STARTUP_PROJECT CURRENT_BRANCH BRANCH_TYPE; do
+  eval VAR_VALUE=\$$VAR_NAME
+  if [ -z "$VAR_VALUE" ]; then
+    echo "ERROR: Required variable $VAR_NAME is not set"
+    echo "Run step-00-init first"
+    exit 1
+  fi
+done
+```
+
 ### 1. Build Search Pattern
 
 ```bash
@@ -42,13 +56,19 @@ echo "  Pattern: *${BRANCH_SHORT}*"
 ### 2. Find Existing Migrations
 
 ```bash
-# Search for migrations that match this branch
-EXISTING_MIGRATIONS=$(find "$MIGRATIONS_DIR" -name "*.cs" 2>/dev/null | \
-  grep -v "Designer\|Snapshot" | \
+# Sanitize branch name: only allow alphanumeric, underscore (prevent regex/shell injection)
+BRANCH_SHORT_SAFE=$(echo "$BRANCH_SHORT" | sed 's/[^a-zA-Z0-9_]//g')
+if [ -z "$BRANCH_SHORT_SAFE" ]; then
+  echo "ERROR: Invalid branch name (no alphanumeric characters after sanitization)"
+  exit 1
+fi
+
+# Search for migrations matching this branch (-F = fixed-string, prevents regex injection)
+EXISTING_MIGRATIONS=$(find "$MIGRATIONS_DIR" -name "*.cs" ! -name "*Designer.cs" ! -name "*Snapshot.cs" -type f 2>/dev/null | \
   xargs -I{} basename {} | \
-  grep -i "$BRANCH_SHORT" || echo "")
+  grep -iF "$BRANCH_SHORT_SAFE" || echo "")
 
-EXISTING_COUNT=$(echo "$EXISTING_MIGRATIONS" | grep -c "." 2>/dev/null || echo "0")
+EXISTING_COUNT=$(echo "$EXISTING_MIGRATIONS" | grep -c "^[^ ]" 2>/dev/null || echo "0")
 
 echo ""
 if [ "$EXISTING_COUNT" -gt 0 ]; then
@@ -107,6 +127,12 @@ if [ "$ACTION" = "recreate" ]; then
     rm -f "$MIGRATIONS_DIR/${mig_name}.cs"
     rm -f "$MIGRATIONS_DIR/${mig_name}.Designer.cs"
 
+    # Verify deletion succeeded
+    if [ -f "$MIGRATIONS_DIR/${mig_name}.cs" ]; then
+      echo "  ERROR: Failed to delete ${mig_name}.cs"
+      exit 1
+    fi
+
     echo "  Removed: $mig_name"
   done
 

package/templates/skills/efcore/steps/migration/step-02-create.md

@@ -48,7 +48,23 @@ echo ""
 echo "Description: $DESCRIPTION"
 ```
 
-### 2. Call MCP for Migration Name (MANDATORY)
+### 2. Verify MCP Availability
+
+```bash
+# Check MCP cache before calling suggest_migration
+MCP_STATUS_FILE=".claude/mcp-status.json"
+
+if [ -f "$MCP_STATUS_FILE" ]; then
+  MCP_STATUS=$(cat "$MCP_STATUS_FILE" | grep -o '"status":"[^"]*"' | head -1 | cut -d'"' -f4)
+  if [ "$MCP_STATUS" = "error" ]; then
+    echo "ERROR: MCP server is unavailable (status: error)"
+    echo "Run: /mcp healthcheck to diagnose"
+    exit 1
+  fi
+fi
+```
+
+### 3. Call MCP for Migration Name (MANDATORY)
 
 ```javascript
 // DESCRIPTION = from user input (e.g., "Add User Roles")
@@ -68,7 +84,7 @@ MIGRATION_NAME = result.migrationName;
 - Hardcoding context as "core"
 - Using wrong version format
 
-### 3. Display Migration Name
+### 4. Display Migration Name
 
 ```bash
 echo ""
@@ -77,7 +93,7 @@ echo "Context: $DBCONTEXT"
 echo ""
 ```
 
-### 4. Create Migration
+### 5. Create Migration
 
 ```bash
 echo "Creating migration..."
@@ -91,7 +107,7 @@ dotnet ef migrations add "$MIGRATION_NAME" \
   --verbose
 ```
 
-### 5. Verify Creation
+### 6. Verify Creation
 
 ```bash
 # Check files were created

package/templates/skills/efcore/steps/rebase-snapshot/step-03-create.md

@@ -87,6 +87,66 @@ echo "  $MIGRATION_FILE"
 echo "  $DESIGNER_FILE"
 ```
 
+### 5. Inject SQL Objects (Functions, Views, SP)
+
+EF Core does NOT generate DDL for TVF, views, and stored procedures.
+SQL source scripts are in `Persistence/SqlObjects/` (Embedded Resources).
+After a rebase-snapshot, they must be re-injected into the consolidated migration.
+
+```bash
+# Check if SqlObjects folder exists with .sql files
+SQL_OBJECTS_DIR="$INFRA_PROJECT_DIR/Persistence/SqlObjects"
+SQL_FILES=$(find "$SQL_OBJECTS_DIR" -name "*.sql" 2>/dev/null | wc -l)
+
+if [ "$SQL_FILES" -gt 0 ]; then
+  echo ""
+  echo "Found $SQL_FILES SQL object(s) in SqlObjects/"
+  echo "Injecting SqlObjectHelper.ApplyAll(migrationBuilder) into migration..."
+
+  # Validate migration file path before sed operations
+  if [ ! -f "$MIGRATION_FILE" ]; then
+    echo "ERROR: Migration file not found: $MIGRATION_FILE"
+    exit 1
+  fi
+  if ! echo "$MIGRATION_FILE" | grep -qE '\.cs$'; then
+    echo "ERROR: Invalid migration file path (not .cs): $MIGRATION_FILE"
+    exit 1
+  fi
+
+  # Add using directive if not present
+  if ! grep -q "using SmartStack.Infrastructure.Persistence.SqlObjects;" "$MIGRATION_FILE"; then
+    sed -i '1s/^/using SmartStack.Infrastructure.Persistence.SqlObjects;\n/' "$MIGRATION_FILE"
+  fi
+
+  # Add SqlObjectHelper.ApplyAll at the end of Up() method
+  sed -i '/protected override void Up/,/^        }/ {
+    /^        }/ i\
+\            // Apply SQL objects (TVF, Views, SP) from embedded resources\
+\            SqlObjectHelper.ApplyAll(migrationBuilder);
+  }' "$MIGRATION_FILE"
+
+  # Verify injection succeeded (fallback to manual step if sed pattern didn't match)
+  if ! grep -q "SqlObjectHelper.ApplyAll" "$MIGRATION_FILE"; then
+    echo "WARNING: Automatic injection failed (indentation pattern may differ)"
+    echo ""
+    echo "MANUAL STEP REQUIRED: Add these lines inside the Up() method before the closing brace:"
+    echo '    using SmartStack.Infrastructure.Persistence.SqlObjects;'
+    echo '    ...'
+    echo '    SqlObjectHelper.ApplyAll(migrationBuilder);'
+    echo ""
+    echo "File: $MIGRATION_FILE"
+  else
+    echo "  SqlObjectHelper.ApplyAll(migrationBuilder) injected"
+  fi
+  find "$SQL_OBJECTS_DIR" -name "*.sql" -exec basename {} \; | while read f; do
+    echo "  - $f"
+  done
+else
+  echo ""
+  echo "No SQL objects found in SqlObjects/ - skipping injection"
+fi
+```
+
 ---
 
 ## STATE OUTPUT:

package/templates/skills/efcore/steps/shared/step-00-init.md

@@ -56,8 +56,10 @@ detect_dbcontext() {
     return
   fi
 
-  # Priority 2: Client with SmartStack NuGet → BOTH contexts (Core from NuGet + Extensions local)
-  if find . -name "*.csproj" -exec grep -l "SmartStack\." {} \; | grep -qv "SmartStack\."; then
+  # Priority 2: Client project with SmartStack NuGet → BOTH contexts
+  # Detect: csproj files that have a PackageReference to SmartStack (not ProjectReference)
+  # This identifies client projects created via `ss init` that consume SmartStack as NuGet
+  if find . -name "*.csproj" -exec grep -ql "PackageReference.*SmartStack" {} \; 2>/dev/null; then
     DBCONTEXT="CoreDbContext"
     DBCONTEXT_TYPE="both"
     SCHEMA="core"
@@ -197,20 +199,57 @@ determine_base_branch() {
 
 ```bash
 block_production() {
-  # Check for production indicators
-  if grep -q '"Production"' "$CONFIG_FILE" 2>/dev/null; then
-    echo "BLOCKED: Production environment detected"
+  # Check for production indicators (case-insensitive)
+  if grep -qi '"Production"' "$CONFIG_FILE" 2>/dev/null; then
+    echo "BLOCKED: Production environment detected in $CONFIG_FILE"
     exit 1
   fi
 
-  if [[ "$DATABASE_NAME" == *"prod"* ]] || [[ "$DATABASE_NAME" == *"production"* ]]; then
-    echo "BLOCKED: Production database detected"
+  # Case-insensitive database name check
+  DB_LOWER=$(echo "$DATABASE_NAME" | tr '[:upper:]' '[:lower:]')
+  if [[ "$DB_LOWER" == *"prod"* ]] || [[ "$DB_LOWER" == *"production"* ]]; then
+    echo "BLOCKED: Production database detected ($DATABASE_NAME)"
     exit 1
   fi
+
+  # Environment name check (case-insensitive)
+  ENV_LOWER=$(echo "$SELECTED_ENV" | tr '[:upper:]' '[:lower:]')
+  if [[ "$ENV_LOWER" == "production" ]] || [[ "$ENV_LOWER" == "prod" ]]; then
+    echo "BLOCKED: Production environment selected ($SELECTED_ENV)"
+    exit 1
+  fi
+}
+```
+
+### 7. Dual Context Helper
+
+```bash
+# Helper for steps that need to run for both contexts when RUN_BOTH=true
+# Usage: run_for_contexts "command_or_function"
+# Executes with CoreDbContext first, then ExtensionsDbContext
+# Maintains deploy order constraint: Core MUST run first
+
+run_for_contexts() {
+  if [ "$RUN_BOTH" = "true" ]; then
+    echo "=== Running for CoreDbContext (core schema) ==="
+    DBCONTEXT="CoreDbContext"
+    DBCONTEXT_TYPE="core"
+    SCHEMA="core"
+    eval "$1"
+
+    echo ""
+    echo "=== Running for ExtensionsDbContext (extensions schema) ==="
+    DBCONTEXT="ExtensionsDbContext"
+    DBCONTEXT_TYPE="extensions"
+    SCHEMA="extensions"
+    eval "$1"
+  else
+    eval "$1"
+  fi
 }
 ```
 
-### 7. Display Summary
+### 8. Display Summary
 
 ```
 EF CORE CONTEXT

package/templates/skills/efcore/steps/squash/step-03-create.md

@@ -133,9 +133,9 @@ echo "  Down methods: $DOWN_METHODS"
 
 ### 6. Inject SQL Objects (Functions, Views, SP)
 
-EF Core ne génère PAS de DDL pour les TVF, vues et procédures stockées.
-Les scripts SQL source sont dans `Persistence/SqlObjects/` (Embedded Resources).
-Après un squash, il faut les réinjecter dans la migration consolidée.
+EF Core does NOT generate DDL for TVF, views, and stored procedures.
+SQL source scripts are in `Persistence/SqlObjects/` (Embedded Resources).
+After a squash, they must be re-injected into the consolidated migration.
 
 ```bash
 # Check if SqlObjects folder exists with .sql files
@@ -147,6 +147,16 @@ if [ "$SQL_FILES" -gt 0 ]; then
   echo "Found $SQL_FILES SQL object(s) in SqlObjects/"
   echo "Injecting SqlObjectHelper.ApplyAll(migrationBuilder) into migration..."
 
+  # Validate migration file path before sed operations (prevent path injection)
+  if [ ! -f "$MIGRATION_FILE" ]; then
+    echo "ERROR: Migration file not found: $MIGRATION_FILE"
+    exit 1
+  fi
+  if ! echo "$MIGRATION_FILE" | grep -qE '\.cs$'; then
+    echo "ERROR: Invalid migration file path (not .cs): $MIGRATION_FILE"
+    exit 1
+  fi
+
   # Add using directive if not present
   if ! grep -q "using SmartStack.Infrastructure.Persistence.SqlObjects;" "$MIGRATION_FILE"; then
     sed -i '1s/^/using SmartStack.Infrastructure.Persistence.SqlObjects;\n/' "$MIGRATION_FILE"
@@ -160,9 +170,21 @@ if [ "$SQL_FILES" -gt 0 ]; then
 \            SqlObjectHelper.ApplyAll(migrationBuilder);
   }' "$MIGRATION_FILE"
 
-  echo "  ✅ SqlObjectHelper.ApplyAll(migrationBuilder) injected"
+  # Verify injection succeeded (fallback to manual step if sed pattern didn't match)
+  if ! grep -q "SqlObjectHelper.ApplyAll" "$MIGRATION_FILE"; then
+    echo "WARNING: Automatic injection failed (indentation pattern may differ)"
+    echo ""
+    echo "MANUAL STEP REQUIRED: Add these lines inside the Up() method before the closing brace:"
+    echo '    using SmartStack.Infrastructure.Persistence.SqlObjects;'
+    echo '    ...'
+    echo '    SqlObjectHelper.ApplyAll(migrationBuilder);'
+    echo ""
+    echo "File: $MIGRATION_FILE"
+  else
+    echo "  SqlObjectHelper.ApplyAll(migrationBuilder) injected"
+  fi
   find "$SQL_OBJECTS_DIR" -name "*.sql" -exec basename {} \; | while read f; do
-    echo "  📄 $f"
+    echo "  - $f"
   done
 else
   echo ""

package/templates/skills/gitflow/SKILL.md

@@ -65,13 +65,15 @@ Execute GitFlow workflows with automatic versioning, worktree management, and EF
 | Short | Long | Description |
 |-------|------|-------------|
 | `-A` | `--no-auto` | Disable auto mode |
+| `--ws` | `--workspace` | Batch init: initialize all repos in a workspace |
 </flags>
 
 <actions>
 **Primary actions:**
 | Action | Description | Step |
 |--------|-------------|------|
-| `init` | Initialize GitFlow config | step-init |
+| `init` | Initialize GitFlow config (orchestrates detect→clone→validate) | step-init |
+| `init --workspace` | Batch initialize all repos in a workspace | step-init |
 | `start` | Create new branch + worktree | step-start |
 | `commit` | Commit with EF Core validation | step-commit |
 | `sync` | Sync + rebase with remote | step-sync |
@@ -178,25 +180,30 @@ start ──► commit* ──► sync ──► pr ──► merge ──► fi
 **ROUTING LOGIC:**
 
 1. Parse flags and action from input
-2. Route to appropriate step or phase:
-
-| Input Pattern | Route To |
-|---------------|----------|
-| `init` | `steps/step-init.md` |
-| `start {type} {name}` | `steps/step-start.md` |
-| `-f {name}` | `steps/step-start.md` (type=feature) |
-| `-r {name}` | `steps/step-start.md` (type=release) |
-| `-h {name}` | `steps/step-start.md` (type=hotfix) |
-| `commit [msg]` | `steps/step-commit.md` |
-| `sync` | `steps/step-sync.md` |
-| `plan` | `steps/step-plan.md` |
-| `pr` | `steps/step-pr.md` |
-| `merge` | `steps/step-merge.md` |
-| `finish` | `steps/step-finish.md` |
-| `status` or `-s` | `phases/status.md` |
-| `abort` | `phases/abort.md` |
-| `cleanup` | `phases/cleanup.md` |
-| (no action, on feature/*) | `steps/step-commit.md` |
+2. Route to appropriate step or Task agent:
+
+| Input Pattern | Step File | Task Agent (`subagent_type`) |
+|---------------|-----------|----------------------------|
+| `init` | `steps/step-init.md` | `gitflow-init` |
+| `start`, `-f`, `-r`, `-h` | `steps/step-start.md` | `gitflow-start` |
+| `commit [msg]` | `steps/step-commit.md` | `gitflow-commit` |
+| `sync` | `steps/step-sync.md` | — |
+| `plan` | `steps/step-plan.md` | `gitflow-plan` |
+| `pr` | `steps/step-pr.md` | `gitflow-pr` |
+| `merge` | `steps/step-merge.md` | `gitflow-merge` |
+| `finish` | `steps/step-finish.md` | `gitflow-finish` |
+| `status`, `-s` | `phases/status.md` | `gitflow-status` |
+| `abort` | `phases/abort.md` | `gitflow-abort` |
+| `cleanup` | `phases/cleanup.md` | `gitflow-cleanup` |
+| (no action, on feature/*) | `steps/step-commit.md` | `gitflow-commit` |
+
+**Execution mode:**
+
+| Mode | How to route |
+|------|-------------|
+| **Single step** (no `-a`) | Read the step file and execute inline |
+| **Auto mode** (`-a`) | Use `Task` tool with the matching `subagent_type` for each step sequentially |
+| **Standalone phases** | Always delegate to Task agent (fast, isolated) |
 
 </entry_point>
 
@@ -253,12 +260,67 @@ start ──► commit* ──► sync ──► pr ──► merge ──► fi
 | release | as specified | 1.2.0 → 2.0.0 |
 </versioning>
 
+<task_agents>
+
+**Task agent delegation (Opus 4.6):**
+
+Each action has a matching Task agent that can execute independently. Use `Task` tool with the `subagent_type` parameter to delegate:
+
+| Agent | Model | Tools | Use for |
+|-------|-------|-------|---------|
+| `gitflow-commit` | haiku | Bash, Read, Glob, Grep | Fast commit + EF Core validation |
+| `gitflow-pr` | haiku | Bash, Glob | Fast PR creation |
+| `gitflow-status` | haiku | Bash, Read, Glob | Fast status check |
+| `gitflow-review` | haiku | Bash, Glob, Read | Fast PR review |
+| `gitflow-start` | sonnet | Bash, Read, Glob, Write | Branch + worktree creation |
+| `gitflow-merge` | sonnet | Bash, Read, Glob, Grep, Edit | Safe merge with validation |
+| `gitflow-finish` | sonnet | Bash, Read, Glob, Write | Tag + cleanup + merge-back |
+| `gitflow-plan` | sonnet | Bash, Read, Glob, Grep, Write | Integration planning |
+| `gitflow-exec` | sonnet | Bash, Read, Glob, Grep, Edit, Write | Plan execution |
+| `gitflow-init` | sonnet | Bash, Read, Write, Glob, AskUserQuestion | Project setup (orchestrator) |
+| `gitflow-init-detect` | haiku | Bash, Read | Environment detection (sub-agent) |
+| `gitflow-init-clone` | sonnet | Bash, Read, Write | Bare clone + worktrees (sub-agent) |
+| `gitflow-init-validate` | haiku | Bash, Read, Glob | Post-init verification + repair (sub-agent) |
+| `gitflow-cleanup` | sonnet | Bash, Read, Glob, Write | Orphan worktree audit |
+| `gitflow-abort` | sonnet | Bash, Read, Glob, Write | Rollback/recovery |
+
+**Init team delegation (orchestrated by `gitflow-init`):**
+
+| Step | Sub-agent | Model | Purpose |
+|------|-----------|-------|---------|
+| 1 | `gitflow-init-detect` | haiku | Platform, workspace, git state detection |
+| 2 | (orchestrator) | sonnet | AskUserQuestion for URL, path, name |
+| 3 | `gitflow-init-clone` | sonnet | Bare clone + worktree creation (zero `cd`, absolute paths) |
+| 4 | (orchestrator) | sonnet | Write config.json v2.1.0 |
+| 5 | `gitflow-init-validate` | haiku | Verify structure + auto-repair |
+
+**Parallel execution opportunities:**
+
+| Scenario | Parallel agents |
+|----------|----------------|
+| Status check | `gitflow-status` in background while user continues |
+| Pre-PR validation | Build check + migration check in parallel Bash calls |
+| Auto release | Sequential: start → commit → pr → (wait) → finish |
+| Workspace init | Sequential per repo, but detection is parallel |
+
+**Agent prompt template:**
+```
+Execute {action} for GitFlow.
+Working directory: {worktree_path}
+Branch: {branch_name} ({branch_type})
+Target: {base_branch}
+Provider: {git_provider}
+Version: {version_current}
+Auto mode: {auto_mode}
+```
+
+</task_agents>
+
 <execution_rules>
 
-- **Load one step at a time** - Only load the current step file
-- **ULTRA THINK** before each action
-- **Persist state variables** across all steps
-- **Follow next_step directive** at end of each step
+- **Single step mode**: Read the step file and execute inline
+- **Auto mode (`-a`)**: Delegate each step to its Task agent sequentially
+- **Standalone phases**: Always delegate to Task agent (fast, isolated)
 - **NEVER skip EF Core validation** - migrations are critical
 - **Safety > Correctness > Speed**
 
@@ -267,14 +329,14 @@ start ──► commit* ──► sync ──► pr ──► merge ──► fi
 | Mode | Behavior |
 |------|----------|
 | **Without `-a`** | Execute ONLY the requested step, then **STOP and wait for user** |
-| **With `-a`** | Execute ALL steps automatically (start → commit → pr → merge → finish) |
+| **With `-a`** | Execute ALL steps automatically via Task agent delegation |
 
 **Examples:**
 ```bash
-/gitflow -r 1.20.0      # Creates branch + bump version → STOPS (user runs /gitflow pr next)
-/gitflow -r -a 1.20.0   # Full automatic: branch → bump → PR → merge → tag → cleanup
-/gitflow -f my-feature  # Creates branch → STOPS (user codes, then runs /gitflow commit)
-/gitflow -f -a feature  # Full automatic: branch → commit → PR → merge → finish
+/gitflow -r 1.20.0      # Reads step-start.md, executes inline → STOPS
+/gitflow -r -a 1.20.0   # Delegates to gitflow-start → gitflow-pr → gitflow-finish
+/gitflow -f my-feature  # Reads step-start.md, executes inline → STOPS
+/gitflow commit          # Reads step-commit.md, executes inline → STOPS
 ```
 
 **NEVER chain steps automatically without `-a` flag. The user decides the pace.**