@atlashub/smartstack-cli 1.20.0 → 1.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "1.20.0",
+  "version": "1.22.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>

package/templates/skills/gitflow/steps/step-init.md

@@ -19,6 +19,9 @@ Set up GitFlow configuration, create main/develop branches, and configure worktr
 ### 1. Detect Environment
 
 ```bash
+# Check if we're in a git repository
+IS_GIT_REPO=$(git rev-parse --git-dir 2>/dev/null && echo "true" || echo "false")
+
 # Check if already initialized
 [ -f ".claude/gitflow/config.json" ] && {
   echo "GitFlow already initialized"
@@ -35,6 +38,15 @@ else
   GIT_PROVIDER="unknown"
 fi
 
+# Auto-detect project name from remote URL or folder name
+if [[ -n "$REMOTE_URL" ]]; then
+  # Extract repo name from URL (works for github and azure devops)
+  PROJECT_NAME=$(basename -s .git "$REMOTE_URL")
+else
+  # Use current folder name
+  PROJECT_NAME=$(basename "$(pwd)")
+fi
+
 # Detect existing branches
 HAS_MAIN=$(git branch -r --list "origin/main" | wc -l)
 HAS_DEVELOP=$(git branch -r --list "origin/develop" | wc -l)
@@ -42,6 +54,36 @@ HAS_DEVELOP=$(git branch -r --list "origin/develop" | wc -l)
 
 ### 2. Configuration Questions
 
+**If NOT in a git repository (`IS_GIT_REPO` = false):**
+
+```yaml
+AskUserQuestion:
+  - header: "Folder"
+    question: "Where should the project be initialized?"
+    options:
+      - label: "Current directory (Recommended)"
+        description: "Initialize GitFlow in {pwd}"
+      - label: "Create new folder"
+        description: "Create a new folder and initialize there"
+      - label: "Choose existing folder"
+        description: "Navigate to an existing folder"
+```
+
+**Always ask (Custom Setup only, or if auto-detected name is wrong):**
+
+```yaml
+AskUserQuestion:
+  - header: "Project"
+    question: "What is the project name? (detected: {PROJECT_NAME})"
+    options:
+      - label: "Use detected name (Recommended)"
+        description: "Use '{PROJECT_NAME}' as project name"
+      - label: "Enter custom name"
+        description: "Specify a different project name"
+```
+
+**Setup mode:**
+
 ```yaml
 AskUserQuestion:
   - header: "Mode"
@@ -65,6 +107,31 @@ AskUserQuestion:
         description: "No worktrees, use git checkout"
 ```
 
+**Question flow logic:**
+- Quick Setup: Skip project name question (use auto-detected)
+- Custom Setup: Ask all questions including project name
+- Not in git repo: Ask folder question first, then `git init`
+
+### 2.5 Initialize Git Repository (if needed)
+
+**If `IS_GIT_REPO` = false:**
+
+```bash
+# Navigate to chosen folder if user selected "Create new folder" or "Choose existing folder"
+[ -n "$TARGET_FOLDER" ] && {
+  mkdir -p "$TARGET_FOLDER"
+  cd "$TARGET_FOLDER"
+}
+
+# Initialize git repository
+git init
+
+# Update PROJECT_NAME if user provided custom name
+[ -n "$CUSTOM_PROJECT_NAME" ] && PROJECT_NAME="$CUSTOM_PROJECT_NAME"
+
+echo "Git repository initialized in $(pwd)"
+```
+
 ### 3. Create Branches (if needed)
 
 ```bash
@@ -106,7 +173,7 @@ esac
 {
   "version": "2.0.0",
   "repository": {
-    "name": "{repo_name}",
+    "name": "{PROJECT_NAME}",
     "defaultBranch": "main",
     "remoteUrl": "{remote_url}"
   },
@@ -176,7 +243,7 @@ VERSION=$(grep -oP '<Version>\K[^<]+' *.csproj 2>/dev/null | head -1)
 ╔══════════════════════════════════════════════════════════════════╗
 ║                    GITFLOW INITIALIZED                            ║
 ╠══════════════════════════════════════════════════════════════════╣
-║  Repository: {repo_name}                                          ║
+║  Project:    {PROJECT_NAME}                                       ║
 ║  Provider:   {github|azuredevops}                                 ║
 ║  Version:    {X.Y.Z}                                              ║
 ╠══════════════════════════════════════════════════════════════════╣