@atlashub/smartstack-cli 1.20.0 → 1.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, APEX, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",

package/templates/skills/gitflow/SKILL.md

@@ -9,34 +9,27 @@ Execute GitFlow workflows with automatic versioning, worktree management, and EF
 </objective>
 
 <quick_start>
-**Start a feature:**
+**Manual workflow (step-by-step, recommended):**
 ```bash
-/gitflow start feature user-auth
-/gitflow -f user-auth              # Shorthand
+/gitflow -f user-auth     # Start feature → STOPS
+# ... code ...
+/gitflow commit           # Commit → STOPS
+/gitflow pr               # Create PR → STOPS (wait review)
+/gitflow merge            # Merge → STOPS
+/gitflow finish           # Cleanup → DONE
 ```
 
-**Commit with EF Core validation:**
+**Automatic workflow (all-in-one):**
 ```bash
-/gitflow commit                    # Interactive
-/gitflow -a commit "Add login"     # Auto mode
-```
-
-**Create PR and merge:**
-```bash
-/gitflow pr                        # Create PR
-/gitflow merge                     # Merge after approval
-```
-
-**Complete workflow (feature):**
-```bash
-/gitflow -a -f my-feature          # Auto + feature mode
+/gitflow -a -f my-feature   # Full auto: all steps
+/gitflow -a -r 1.20.0       # Full auto: release
 ```
 
 **Flags:**
-- `-a` (auto): Skip confirmations
-- `-f` (feature): Feature workflow
-- `-r` (release): Release workflow
-- `-h` (hotfix): Hotfix workflow
+- `-a` (auto): **Execute ALL steps automatically** (without = one step then stop)
+- `-f` (feature): Feature workflow (target: develop)
+- `-r` (release): Release workflow (target: main)
+- `-h` (hotfix): Hotfix workflow (target: main)
 - `-s` (status): Show status only
 </quick_start>
 
@@ -53,11 +46,13 @@ Execute GitFlow workflows with automatic versioning, worktree management, and EF
 **Behavior flags:**
 | Short | Long | Description |
 |-------|------|-------------|
-| `-a` | `--auto` | Autonomous mode: skip confirmations |
+| `-a` | `--auto` | **Full automatic mode**: execute ALL steps without stopping |
 | `-s` | `--status` | Status mode: show state only, no actions |
 | `-v` | `--verbose` | Verbose output |
 | `--dry-run` | | Preview actions without executing |
 
+**⚠️ CRITICAL: Without `-a`, each command executes ONLY its own step then STOPS.**
+
 **Disable flags:**
 | Short | Long | Description |
 |-------|------|-------------|
@@ -87,48 +82,42 @@ Execute GitFlow workflows with automatic versioning, worktree management, and EF
 
 <examples>
 ```bash
-# Initialize GitFlow
-/gitflow init
-
-# Start feature with worktree
-/gitflow start feature payment-integration
-/gitflow -f payment-integration    # Shorthand
-
-# Start release
-/gitflow start release 2.0.0
-/gitflow -r 2.0.0                  # Shorthand
-
-# Start hotfix
-/gitflow start hotfix critical-fix
-/gitflow -h critical-fix           # Shorthand
-
-# Commit (with EF Core validation)
-/gitflow commit
-/gitflow -a commit "Fix bug"       # Auto mode
-
-# Sync with remote
-/gitflow sync
-
-# Create PR
-/gitflow pr
-
-# Merge after review
-/gitflow merge
-
-# Finalize branch
-/gitflow finish
-
-# Status check
-/gitflow status
-/gitflow -s                        # Shorthand
-
-# Abort/rollback
-/gitflow abort
-/gitflow abort --checkpoint        # Restore from checkpoint
-
-# Cleanup worktrees
-/gitflow cleanup
-/gitflow cleanup --dry-run         # Preview only
+# ══════════════════════════════════════════════════════════════
+# STEP-BY-STEP MODE (default - recommended)
+# Each command executes ONE step, then waits for user
+# ══════════════════════════════════════════════════════════════
+
+# Feature workflow (manual steps)
+/gitflow -f my-feature    # 1. Creates branch → STOPS
+# ... user codes ...
+/gitflow commit           # 2. Commits changes → STOPS
+/gitflow pr               # 3. Creates PR → STOPS (wait for review)
+/gitflow merge            # 4. Merges PR → STOPS
+/gitflow finish           # 5. Cleanup → DONE
+
+# Release workflow (manual steps)
+/gitflow -r 1.20.0        # 1. Creates branch + bump version → STOPS
+/gitflow pr               # 2. Creates PR to main → STOPS (wait for review)
+/gitflow merge            # 3. Merges PR → STOPS
+/gitflow finish           # 4. Tag + merge-back + cleanup → DONE
+
+# ══════════════════════════════════════════════════════════════
+# AUTOMATIC MODE (-a flag)
+# Executes ALL steps without stopping
+# ══════════════════════════════════════════════════════════════
+
+/gitflow -a -f my-feature  # Full auto: branch → commit → pr → merge → finish
+/gitflow -a -r 1.20.0      # Full auto: branch → bump → pr → merge → tag → cleanup
+/gitflow -a -h fix-bug     # Full auto: hotfix complete cycle
+
+# ══════════════════════════════════════════════════════════════
+# UTILITY COMMANDS
+# ══════════════════════════════════════════════════════════════
+
+/gitflow status           # Show current state
+/gitflow -s               # Shorthand for status
+/gitflow abort            # Rollback current operation
+/gitflow cleanup          # Audit and remove orphan worktrees
 ```
 </examples>
 
@@ -264,6 +253,24 @@ start ──► commit* ──► sync ──► pr ──► merge ──► fi
 - **Follow next_step directive** at end of each step
 - **NEVER skip EF Core validation** - migrations are critical
 - **Safety > Correctness > Speed**
+
+**⚠️ CRITICAL - STEP EXECUTION POLICY:**
+
+| 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) |
+
+**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
+```
+
+**NEVER chain steps automatically without `-a` flag. The user decides the pace.**
+
 </execution_rules>
 
 <success_criteria>