@atlashub/smartstack-cli 4.81.0 → 5.0.0

package/templates/skills/gitflow/references/commit-migration-validation.md

@@ -1,53 +0,0 @@
-# Migration File Validation
-
-## Detect EF Core Migrations
-
-```bash
-# Find migration files in changes
-MIGRATIONS=$(echo "$STAGED $MODIFIED $UNTRACKED" | tr ' ' '\n' | grep -E "Migrations/.*\.cs$")
-HAS_MIGRATIONS=$([ -n "$MIGRATIONS" ] && echo "true" || echo "false")
-
-if [ "$HAS_MIGRATIONS" = "true" ]; then
-  # Check for the 3 required files
-  MIGRATION_NAME=$(echo "$MIGRATIONS" | grep -v "Designer\|Snapshot" | head -1 | sed 's/.*\///' | sed 's/\.cs$//')
-
-  HAS_MAIN=$(echo "$MIGRATIONS" | grep -c "${MIGRATION_NAME}.cs")
-  HAS_DESIGNER=$(echo "$MIGRATIONS" | grep -c "${MIGRATION_NAME}.Designer.cs")
-  HAS_SNAPSHOT=$(echo "$MIGRATIONS" | grep -c "ModelSnapshot.cs")
-
-  [ "$HAS_MAIN" -eq 0 ] || [ "$HAS_DESIGNER" -eq 0 ] || [ "$HAS_SNAPSHOT" -eq 0 ] && {
-    echo "❌ INCOMPLETE MIGRATION"
-    echo "Required: Migration.cs + Designer.cs + ModelSnapshot.cs"
-    echo "Found: Main=$HAS_MAIN, Designer=$HAS_DESIGNER, Snapshot=$HAS_SNAPSHOT"
-    STOP
-  }
-fi
-```
-
-## Check Destructive Operations (BLOCKING)
-
-```bash
-if [ "$HAS_MIGRATIONS" = "true" ]; then
-  DESTRUCTIVE=$(grep -l "DropTable\|DropColumn\|DeleteData" $MIGRATIONS 2>/dev/null)
-
-  [ -n "$DESTRUCTIVE" ] && {
-    echo "⚠️ DESTRUCTIVE OPERATIONS DETECTED"
-    grep -n "DropTable\|DropColumn\|DeleteData" $DESTRUCTIVE
-
-    # Require explicit confirmation
-    AskUserQuestion:
-      header: "Confirm"
-      question: "Destructive migration detected. Continue?"
-      options:
-        - label: "Yes, I understand the risks"
-        - label: "No, let me review"
-
-    # Log to audit trail
-    echo "$(date) - DESTRUCTIVE: $DESTRUCTIVE - User: $USER" >> .claude/gitflow/logs/audit.log
-  }
-fi
-```
-
-## SQL Objects Note
-
-SQL objects (TVFs, views, stored procedures) are applied **automatically at application startup** via `SqlObjectHelper.ApplyAllAsync()`. No injection into migrations is needed. Migrations no longer need to contain `SqlObjectHelper.ApplyAll(migrationBuilder)` calls.

package/templates/skills/gitflow/references/finish-cleanup.md

@@ -1,55 +0,0 @@
-# Worktree and Branch Cleanup
-
-## Clean Up Worktree
-
-```bash
-# Repair cross-platform worktree paths before cleanup (WSL ↔ Windows)
-detect_platform
-repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
-
-# Find worktree for this branch (use --porcelain for reliable parsing)
-WORKTREE_PATH=$(git worktree list --porcelain | grep -B2 "branch refs/heads/$BRANCH" | grep "^worktree " | sed 's/^worktree //')
-
-if [ -n "$WORKTREE_PATH" ] && [ -d "$WORKTREE_PATH" ]; then
-  echo "Removing worktree: $WORKTREE_PATH"
-
-  # Make sure we're not in the worktree directory
-  cd "$GF_DEVELOP_PATH" 2>/dev/null || cd "$(git rev-parse --show-toplevel)"
-
-  git worktree remove "$WORKTREE_PATH" --force 2>/dev/null || {
-    rm -rf "$WORKTREE_PATH"
-  }
-
-  git worktree prune
-  echo "✅ Worktree removed"
-fi
-```
-
-## Delete Remote and Local Branches
-
-```bash
-# Check if remote branch still exists
-REMOTE_EXISTS=$(git branch -r --list "origin/$BRANCH")
-
-if [ -n "$REMOTE_EXISTS" ]; then
-  echo "Deleting remote branch: $BRANCH"
-  git push origin --delete "$BRANCH" 2>/dev/null || {
-    echo "⚠️ Could not delete remote branch (may already be deleted by PR)"
-  }
-fi
-
-# Delete local branch
-git branch -D "$BRANCH" 2>/dev/null || echo "Local branch already deleted"
-```
-
-## Archive Plan
-
-```bash
-PLAN_FILE=$(ls .claude/gitflow/plans/*${BRANCH_NAME}*.md 2>/dev/null | head -1)
-
-if [ -f "$PLAN_FILE" ]; then
-  ARCHIVE_NAME="${PLAN_FILE%.md}_DONE_$(date +%Y%m%d-%H%M%S).md"
-  mv "$PLAN_FILE" "$ARCHIVE_NAME"
-  echo "✅ Plan archived: $ARCHIVE_NAME"
-fi
-```

package/templates/skills/gitflow/references/finish-version-bumping.md

@@ -1,45 +0,0 @@
-# Version Bumping After Release/Hotfix
-
-## Determine Next Version
-
-```bash
-MAJOR=$(echo $VERSION | cut -d'.' -f1)
-MINOR=$(echo $VERSION | cut -d'.' -f2)
-PATCH=$(echo $VERSION | cut -d'.' -f3)
-
-if [ "$BRANCH_TYPE" = "release" ]; then
-  # Release: increment minor, reset patch
-  NEXT_VERSION="$MAJOR.$((MINOR + 1)).0"
-else
-  # Hotfix: increment patch (patch was already bumped for the tag, bump again for next dev)
-  NEXT_VERSION="$MAJOR.$MINOR.$((PATCH + 2))"
-fi
-```
-
-## Update Configuration and Source Files
-
-```bash
-# Update config (using resolved config path)
-sed -i "s/\"current\": \".*\"/\"current\": \"$NEXT_VERSION\"/" "$GF_CONFIG_FILE"
-
-# Update source files
-# csproj, package.json, etc.
-
-git add -A
-git commit -m "chore: bump version to $NEXT_VERSION for development"
-git push origin $GF_DEVELOP_BRANCH
-
-# CRITICAL: Verify push and update tracking refs
-git fetch origin $GF_DEVELOP_BRANCH:refs/remotes/origin/$GF_DEVELOP_BRANCH --force --quiet
-LOCAL_SHA=$(git rev-parse HEAD)
-REMOTE_SHA=$(git rev-parse origin/$GF_DEVELOP_BRANCH)
-if [ "$LOCAL_SHA" = "$REMOTE_SHA" ]; then
-  echo "✅ Push verified - local/remote in sync"
-else
-  echo "⚠️ Push verification FAILED"
-  echo "  Local:  $LOCAL_SHA"
-  echo "  Remote: $REMOTE_SHA"
-fi
-
-echo "✅ Version bumped to $NEXT_VERSION"
-```

package/templates/skills/gitflow/references/init-config-template.md

@@ -1,143 +0,0 @@
-# GitFlow Config Template (v2.1.0)
-
-## Configuration JSON
-
-Write `.claude/gitflow/config.json` in develop worktree.
-
-**IMPORTANT:** Store paths using `normalize_path_for_storage()` format (Windows-style: `D:/path/to/folder`). The `read_gitflow_config()` in `_shared.md` translates them to platform format at read time.
-
-```json
-{
-  "version": "2.1.0",
-  "platform": {
-    "detected": "{GF_PLATFORM}",
-    "shell": "{GF_SHELL}",
-    "detectedAt": "{ISO_DATE}"
-  },
-  "workspace": {
-    "path": "{WORKSPACE_DIR_STORAGE_FORMAT}",
-    "name": ""
-  },
-  "repository": {
-    "name": "{PROJECT_NAME}",
-    "rootFolder": "{ROOT_FOLDER_STORAGE_FORMAT}",
-    "nameVariants": {
-      "pascalCaseDot": "{PascalCase.Dot}",
-      "pascalCase": "{PascalCase}",
-      "kebabCase": "{kebab-case}",
-      "snakeCase": "{snake_case}",
-      "displayName": "{Display Name}"
-    },
-    "defaultBranch": "main",
-    "remoteUrl": "{REPO_URL}"
-  },
-  "git": {
-    "provider": "{GIT_PROVIDER}",
-    "branches": {
-      "main": "main",
-      "develop": "develop"
-    },
-    "prefixes": {
-      "feature": "feature/",
-      "release": "release/",
-      "hotfix": "hotfix/"
-    }
-  },
-  "worktrees": {
-    "enabled": true,
-    "mode": "{WORKTREE_MODE}",
-    "structure": {
-      "main": "{ROOT_FOLDER_STORAGE_FORMAT}/{MAIN_DIR}",
-      "develop": "{ROOT_FOLDER_STORAGE_FORMAT}/{DEVELOP_DIR}",
-      "features": "{ROOT_FOLDER_STORAGE_FORMAT}/features",
-      "releases": "{ROOT_FOLDER_STORAGE_FORMAT}/releases",
-      "hotfixes": "{ROOT_FOLDER_STORAGE_FORMAT}/hotfixes"
-    }
-  },
-  "versioning": {
-    "strategy": "semver",
-    "current": "{VERSION}",
-    "tagPrefix": "v",
-    "sources": ["csproj", "package.json", "VERSION"]
-  },
-  "efcore": {
-    "enabled": true,
-    "validateOnCommit": true,
-    "blockDestructive": true,
-    "migrationNaming": "{context}_v{version}_{sequence}_{Description}"
-  },
-  "workflow": {
-    "push": { "afterCommit": "worktree" },
-    "pr": { "autoLabels": true, "requireReview": true }
-  },
-  "language": { "code": "{GF_LANG}" }
-}
-```
-
-**Worktree mode directories:**
-
-| Mode | `{MAIN_DIR}` | `{DEVELOP_DIR}` |
-|------|-------------|-----------------|
-| organized | `01-Main` | `02-Develop` |
-| simple | `main` | `develop` |
-| disabled | N/A | N/A (no worktrees, `enabled: false`) |
-
-## Path Storage Convention
-
-- `{ROOT_FOLDER_STORAGE_FORMAT}` = result of `normalize_path_for_storage("{ROOT_FOLDER}")`
-- On WSL: `/mnt/d/projects/MyApp` -> stored as `D:/projects/MyApp`
-- On Windows: `D:\projects\MyApp` -> stored as `D:/projects/MyApp`
-- On Linux/macOS: `/home/user/projects/MyApp` -> stored as-is
-
-## Post-Init Validation
-
-```bash
-PROJECT_BASE="{ROOT_FOLDER}"
-MAIN_DIR=$([ "$WORKTREE_MODE" = "organized" ] && echo "01-Main" || echo "main")
-DEVELOP_DIR=$([ "$WORKTREE_MODE" = "organized" ] && echo "02-Develop" || echo "develop")
-ERRORS=0
-
-# Verify bare repo
-[ -f "$PROJECT_BASE/.bare/HEAD" ] && echo "OK .bare/HEAD" || { echo "FAIL .bare/HEAD missing"; ERRORS=$((ERRORS+1)); }
-
-# Verify worktrees on correct branches
-MAIN_BRANCH=$(git -C "$PROJECT_BASE/$MAIN_DIR" branch --show-current 2>/dev/null)
-[ "$MAIN_BRANCH" = "main" ] && echo "OK $MAIN_DIR on main" || { echo "FAIL $MAIN_DIR on '$MAIN_BRANCH'"; ERRORS=$((ERRORS+1)); }
-
-DEVELOP_BRANCH=$(git -C "$PROJECT_BASE/$DEVELOP_DIR" branch --show-current 2>/dev/null)
-[ "$DEVELOP_BRANCH" = "develop" ] && echo "OK $DEVELOP_DIR on develop" || { echo "FAIL $DEVELOP_DIR on '$DEVELOP_BRANCH'"; ERRORS=$((ERRORS+1)); }
-
-# Verify directories
-for subdir in features releases hotfixes; do
-  [ -d "$PROJECT_BASE/$subdir" ] && echo "OK $subdir/" || { echo "FAIL $subdir/ missing"; ERRORS=$((ERRORS+1)); }
-done
-
-# Verify config directory
-[ -d "$PROJECT_BASE/$DEVELOP_DIR/.claude/gitflow" ] && echo "OK .claude/gitflow/" || { echo "FAIL .claude/gitflow/ missing"; ERRORS=$((ERRORS+1)); }
-
-echo ""
-[ "$ERRORS" -eq 0 ] && echo "VALIDATION: ALL CHECKS PASSED" || echo "VALIDATION: $ERRORS error(s) detected"
-```
-
-## Workspace Mode (`--workspace`)
-
-When called with `init --workspace`, batch-initialize all repos in a workspace.
-
-### Workspace Execution Sequence:
-
-1. **Ask workspace directory** (AskUserQuestion: parent folder or custom path)
-2. **Detect or ask for repos** (scan workspace for git repos or enter URLs)
-3. **Create `.smartstack-workspace.json`:**
-```json
-{
-  "version": "1.0.0",
-  "name": "{WORKSPACE_NAME}",
-  "createdAt": "{ISO_DATE}",
-  "updatedAt": "{ISO_DATE}",
-  "platform": { "detected": "{GF_PLATFORM}", "shell": "{GF_SHELL}" },
-  "repositories": [],
-  "defaults": { "provider": "{GIT_PROVIDER}", "worktreeMode": "organized", "language": "en" }
-}
-```
-4. **Loop: For each repo, run Steps 1-10b with workspace defaults pre-populated.**
-5. **Display global summary** with all repos initialized.

package/templates/skills/gitflow/references/init-environment-detection.md

@@ -1,41 +0,0 @@
-# Environment Detection
-
-## Platform and Git Detection
-
-```bash
-# PLATFORM DETECTION (required for correct path handling on WSL/Windows/macOS/Linux)
-if [ -f /proc/version ] && grep -qi "microsoft\|wsl" /proc/version 2>/dev/null; then
-  GF_PLATFORM="wsl"; GF_SHELL="bash"
-elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "mingw"* ]] || [[ "$OSTYPE" == "cygwin" ]]; then
-  GF_PLATFORM="windows"; GF_SHELL="gitbash"
-elif [[ -n "$WINDIR" ]] || [[ -n "$SystemRoot" ]]; then
-  GF_PLATFORM="windows"; GF_SHELL="powershell"
-elif [[ "$OSTYPE" == "darwin"* ]]; then
-  GF_PLATFORM="macos"; GF_SHELL="zsh"
-elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
-  GF_PLATFORM="linux"; GF_SHELL="bash"
-else
-  GF_PLATFORM="unknown"; GF_SHELL="bash"
-fi
-echo "Platform: $GF_PLATFORM ($GF_SHELL)"
-
-# Check if we're in a git repository
-IS_GIT_REPO=$(git rev-parse --git-dir 2>/dev/null && echo "true" || echo "false")
-
-# Auto-detect values for defaults (will be confirmed by user)
-DETECTED_URL=$(git remote get-url origin 2>/dev/null || echo "")
-DETECTED_FOLDER=$(dirname "$(pwd)")
-DETECTED_NAME=$(basename -s .git "$DETECTED_URL" 2>/dev/null || basename "$(pwd)")
-
-# Detect git provider
-if [[ "$DETECTED_URL" == *"github.com"* ]]; then
-  GIT_PROVIDER="github"
-elif [[ "$DETECTED_URL" == *"dev.azure.com"* ]]; then
-  GIT_PROVIDER="azuredevops"
-else
-  GIT_PROVIDER="unknown"
-fi
-
-# Check if already initialized
-ALREADY_INITIALIZED=$([ -f ".claude/gitflow/config.json" ] && echo "true" || echo "false")
-```

package/templates/skills/gitflow/references/init-name-normalization.md

@@ -1,118 +0,0 @@
-# Project Name Normalization (INTELLIGENT)
-
-**ALWAYS normalize, even if user chose the detected name.**
-
-## Step 1: Parse input into words
-
-Split the raw input on any separator: spaces, hyphens, underscores, dots, camelCase boundaries.
-
-**⛔ Compound proper nouns:** Some camelCase words are actually single brand/product names that must NOT be split. Before splitting on camelCase boundaries, check if the full word is a known compound:
-
-| Word | Type | Parsed as |
-|------|------|-----------|
-| `SmartStack` | Brand name | `["SmartStack"]` (1 word) |
-| `JavaScript` | Language | `["JavaScript"]` (1 word) |
-| `TypeScript` | Language | `["TypeScript"]` (1 word) |
-| `DevOps` | Proper noun | `["DevOps"]` (1 word) |
-| `GitHub` | Brand name | `["GitHub"]` (1 word) |
-| `InfraAzure` | Normal camelCase | `["Infra", "Azure"]` (2 words) |
-
-**Rule:** If the full word (before splitting) is recognized as a brand, product, or proper noun, treat it as ONE word. Only split unknown camelCase words.
-
-**Example:** `SmartStack.infra-azure` → `["SmartStack", "infra", "azure"]` → kebab: `smartstack-infra-azure`
-
-| Raw input | Parsed words |
-|-----------|-------------|
-| `mon super projet` | `["mon", "super", "projet"]` |
-| `gestion-des-stocks` | `["gestion", "des", "stocks"]` |
-| `my_awesome_app` | `["my", "awesome", "app"]` |
-| `SmartStack.App` | `["SmartStack", "App"]` |
-| `userManagement` | `["user", "Management"]` |
-
-## Step 2: Language detection and spell check
-
-For EACH word, you MUST:
-1. **Detect the language** (French, English, or technical/proper noun)
-2. **Check spelling** - flag obvious typos
-3. **Suggest corrections** if misspelled
-
-| Word | Language | Spelling | Suggestion |
-|------|----------|----------|------------|
-| `gestion` | FR | OK | - |
-| `gestoin` | FR | typo | -> `gestion` |
-| `managment` | EN | typo | -> `management` |
-| `SmartStack` | Proper noun | OK | - |
-| `auth` | EN (abbreviation) | OK | - |
-
-**If typos detected**, ask the user BEFORE generating variants:
-
-```yaml
-AskUserQuestion:
-  - header: "Spelling"
-    question: "Corrections detected. Accept?"
-    options:
-      - label: "Accept corrections (Recommended)"
-        description: "'gestoin' -> 'gestion', 'managment' -> 'management'"
-      - label: "Keep original"
-        description: "Use the name as typed"
-    multiSelect: false
-```
-
-## Step 3: Generate all name variants
-
-From the cleaned words, generate ALL variants:
-
-| Variant | Format | Best for |
-|---------|--------|----------|
-| PascalCase.Dot | `Gestion.Des.Stocks` | .NET namespace, C# project, folder name |
-| PascalCase | `GestionDesStocks` | Class name, assembly name |
-| kebab-case | `gestion-des-stocks` | Git repo, npm package, URL slug |
-| snake_case | `gestion_des_stocks` | Database, Python, file system |
-
-## Step 4: Ask user to choose the PRIMARY format
-
-```yaml
-AskUserQuestion:
-  - header: "Format"
-    question: "Which format for the project name?"
-    options:
-      - label: "PascalCase.Dot (Recommended)"
-        description: "{PascalCase.Dot variant} - .NET convention"
-      - label: "PascalCase"
-        description: "{PascalCase variant} - single word"
-      - label: "kebab-case"
-        description: "{kebab-case variant} - git/npm convention"
-      - label: "snake_case"
-        description: "{snake_case variant} - database/python convention"
-    multiSelect: false
-```
-
-## Step 5: Store all derived names
-
-Regardless of the chosen primary format, ALL variants are generated and stored:
-
-```json
-{
-  "PROJECT_NAME": "{chosen format}",
-  "PROJECT_VARIANTS": {
-    "pascalCaseDot": "Gestion.Des.Stocks",
-    "pascalCase": "GestionDesStocks",
-    "kebabCase": "gestion-des-stocks",
-    "snakeCase": "gestion_des_stocks",
-    "displayName": "Gestion Des Stocks",
-    "words": ["gestion", "des", "stocks"],
-    "language": "fr"
-  }
-}
-```
-
-## Real-world examples
-
-| User types | PascalCase.Dot | kebab-case | PascalCase |
-|-----------|---------------|------------|------------|
-| `SmartStack.App` | `SmartStack.App` | `smartstack-app` | `SmartStackApp` |
-| `gestion-des-stocks` | `Gestion.Des.Stocks` | `gestion-des-stocks` | `GestionDesStocks` |
-| `Mon Projet V2` | `Mon.Projet.V2` | `mon-projet-v2` | `MonProjetV2` |
-| `user auth module` | `User.Auth.Module` | `user-auth-module` | `UserAuthModule` |
-| `PROJET TEST` | `Projet.Test` | `projet-test` | `ProjetTest` |
-| `e-commerce platform` | `ECommerce.Platform` | `e-commerce-platform` | `ECommercePlatform` |

package/templates/skills/gitflow/references/init-questions.md

@@ -1,193 +0,0 @@
-# MANDATORY User Questions for Init
-
-╔══════════════════════════════════════════════════════════════════════════╗
-║  Every question below REQUIRES a call to the AskUserQuestion tool.      ║
-║  The YAML blocks are the EXACT parameters to pass to the tool.         ║
-║  NEVER substitute a tool call with auto-derived values.                ║
-║  NEVER combine questions — one AskUserQuestion call per question.      ║
-╚══════════════════════════════════════════════════════════════════════════╝
-
-## Question 1: Repository URL
-
-**CALL AskUserQuestion with these parameters (skip only if URL provided in command args):**
-
-```yaml
-AskUserQuestion:
-  - header: "Repository"
-    question: "Repository URL? (detected: {DETECTED_URL})"
-    options:
-      - label: "Use detected URL (Recommended)"
-        description: "{DETECTED_URL}"
-      - label: "Enter GitHub URL"
-        description: "https://github.com/org/repo.git"
-      - label: "Enter Azure DevOps URL"
-        description: "https://dev.azure.com/org/project/_git/repo"
-      - label: "Local only (no remote)"
-        description: "Initialize without remote (limited features)"
-    multiSelect: false
-```
-
-**⛔ FOLLOW-UP: If user selects "Enter GitHub URL" or "Enter Azure DevOps URL":**
-
-The selected option is just a choice, NOT the actual URL. You MUST ask a follow-up question:
-
-```yaml
-AskUserQuestion:
-  - header: "URL"
-    question: "Enter the repository URL:"
-    options:
-      - label: "https://github.com/org/repo.git"
-        description: "Example GitHub format"
-      - label: "https://dev.azure.com/org/project/_git/repo"
-        description: "Example Azure DevOps format"
-    multiSelect: false
-```
-
-The user will type the actual URL via "Other". Then:
-- Validate format
-- Update `{REPO_URL}` and `{GIT_PROVIDER}`
-
-## Question 2: Root Folder
-
-**CALL AskUserQuestion NOW — do NOT auto-derive from URL:**
-
-**If sibling projects exist, show where it fits:**
-
-```
-{WORKSPACE_DIR}/
-├── SmartStack.app/    ✅ (gitflow)
-├── SmartStack.mcp/    ✅ (gitflow)
-├── SmartStack.cli/    ✅ (gitflow)
-└── NewProject/        ← THIS PROJECT
-    ├── .bare/
-    ├── 01-Main/
-    ├── 02-Develop/
-    ├── features/
-    ├── releases/
-    └── hotfixes/
-```
-
-```yaml
-AskUserQuestion:
-  - header: "Location"
-    question: "Root folder for THIS project? (worktrees will be created here)"
-    options:
-      - label: "Use parent folder (Recommended)"
-        description: "{DETECTED_FOLDER}/ - consistent with {#SIBLING_PROJECTS} sibling project(s)"
-      - label: "Use current folder"
-        description: "$(pwd)/ - Will create subfolders here"
-      - label: "Custom path"
-        description: "Specify a different location"
-    multiSelect: false
-```
-
-**⛔ FOLLOW-UP: If user selects "Custom path":**
-
-You MUST ask a follow-up question to get the actual path:
-
-```yaml
-AskUserQuestion:
-  - header: "Path"
-    question: "Enter the full path for the project root folder:"
-    options:
-      - label: "{DETECTED_FOLDER}/"
-        description: "Parent of current directory"
-      - label: "{WORKSPACE_DIR}/"
-        description: "Workspace root"
-    multiSelect: false
-```
-
-The user will type the actual path via "Other". Validate the path exists or can be created.
-
-**Explain the structure that will be created for this project:**
-
-```
-{ROOT_FOLDER}/
-├── .bare/                 # Git bare repository (this repo only)
-├── 01-Main/               # Worktree: main branch
-├── 02-Develop/            # Worktree: develop branch
-├── features/              # Feature branch worktrees
-├── releases/              # Release branch worktrees
-└── hotfixes/              # Hotfix branch worktrees
-```
-
-## Question 3: Project Name
-
-**CALL AskUserQuestion NOW — do NOT auto-derive from URL:**
-
-```yaml
-AskUserQuestion:
-  - header: "Project"
-    question: "Project name? (detected: {DETECTED_NAME})"
-    options:
-      - label: "Use detected name (Recommended)"
-        description: "Project: {DETECTED_NAME}"
-      - label: "Custom name"
-        description: "Specify a different project name"
-    multiSelect: false
-```
-
-**⛔ FOLLOW-UP: If user selects "Custom name":**
-
-You MUST ask a follow-up question to get the actual name:
-
-```yaml
-AskUserQuestion:
-  - header: "Name"
-    question: "Enter the project name:"
-    options:
-      - label: "{DETECTED_NAME}"
-        description: "Detected from repository"
-      - label: "{DETECTED_NAME}-v2"
-        description: "Variant of detected name"
-    multiSelect: false
-```
-
-The user will type the actual name via "Other". Use this raw input for step 6b (normalization).
-
-## Question 4: Existing Configuration
-
-**If `ALREADY_INITIALIZED` = true:**
-
-Display current configuration and ask what to do:
-
-```yaml
-AskUserQuestion:
-  - header: "Existing"
-    question: "GitFlow is already initialized. Current config will be shown. What do you want to do?"
-    options:
-      - label: "Reconfigure (Recommended)"
-        description: "Review and update all settings"
-      - label: "Repair"
-        description: "Fix missing directories only"
-      - label: "View only"
-        description: "Display current config and exit"
-      - label: "Cancel"
-        description: "Exit without changes"
-    multiSelect: false
-```
-
-**Handle choices:**
-- **Reconfigure**: Continue to step 4 (will ask all questions again)
-- **Repair**: Check directories, fix missing ones, exit
-- **View only**: Display config, exit
-- **Cancel**: Exit immediately
-
-## Question 5: Worktree Mode
-
-CALL AskUserQuestion NOW. This is the MOST FREQUENTLY SKIPPED question.
-Do NOT default to "organized". The user MUST explicitly choose.
-
-```yaml
-AskUserQuestion:
-  - header: "Worktrees"
-    question: "How should worktrees be organized?"
-    options:
-      - label: "Organized (Recommended)"
-        description: "01-Main, 02-Develop, features/, releases/, hotfixes/"
-      - label: "Simple"
-        description: "main/, develop/, features/, releases/, hotfixes/"
-      - label: "Disabled"
-        description: "No worktrees, use git checkout (not recommended)"
-    multiSelect: false
-```