@atlashub/smartstack-cli 3.51.0 → 3.53.0

package/package.json

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

package/templates/agents/gitflow/init.md

@@ -10,12 +10,17 @@ tools: Bash, Read, Write, Glob, AskUserQuestion
 
 You initialize a GitFlow project by orchestrating 3 specialized sub-agents.
 
+**IMPORTANT: User questions (root folder, project name, worktree mode) are normally
+handled by the main conversation BEFORE this agent is spawned. If you receive
+pre-confirmed values in your prompt, use them directly. If values are NOT provided,
+you MUST call AskUserQuestion for each missing value before proceeding.**
+
 ## ARCHITECTURE
 
 ```
 gitflow-init (you - orchestrator)
   ├── Task(gitflow-init-detect)   → Environment report
-  ├── AskUserQuestion             → User confirms URL, path, name, worktree mode
+  ├── AskUserQuestion             → ONLY if values not pre-confirmed by caller
   ├── Task(gitflow-init-clone)    → Create structure (skip if disabled)
   ├── Write config.json           → v2.1.0 with platform & workspace
   └── Task(gitflow-init-validate) → Verify & repair (skip if disabled)
@@ -95,188 +100,104 @@ Parse the report to extract:
 
 ---
 
-## STEP 2: ASK USER (4 MANDATORY QUESTIONS)
-
-⛔ EXECUTION RULES FOR STEP 2:
-- Each question = ONE separate AskUserQuestion call
-- NEVER combine multiple questions into a single AskUserQuestion
-- NEVER skip a question, even if a default seems obvious
-- ALL 4 variables must be set by explicit user response before proceeding
-
-> **Reconfigure mode:** When `EXISTING_GITFLOW=true` and user chose "Reconfigure", show existing values as "(Current)" recommended options in each question. This avoids forcing the user to re-enter everything.
+## STEP 2: ASK USER — MANDATORY INTERACTIVE QUESTIONS
+
+╔══════════════════════════════════════════════════════════════════════════╗
+║  MANDATORY TOOL CALL REQUIREMENT                                        ║
+║                                                                          ║
+║  You MUST call the AskUserQuestion tool AT LEAST 3 TIMES in this step.  ║
+║  (4 times if URL was not provided in the command.)                       ║
+║                                                                          ║
+║  Each call = ONE question. Wait for the user's response before asking   ║
+║  the next question.                                                      ║
+║                                                                          ║
+║  You are FORBIDDEN from:                                                 ║
+║  - Deriving values from the URL or environment instead of asking        ║
+║  - Deciding what the user "would probably choose"                        ║
+║  - Proceeding to step 3 without having received user responses          ║
+║  - Using detected/inferred values as final values without user confirm  ║
+║                                                                          ║
+║  Auto-detected values from step 1 are SUGGESTIONS for the options,      ║
+║  NOT answers. The user MUST confirm or override each one.               ║
+╚══════════════════════════════════════════════════════════════════════════╝
+
+> **Reconfigure mode:** When `EXISTING_GITFLOW=true` and user chose "Reconfigure", show existing values as "(Current)" recommended options in each question.
 
 ### 2a. Repository URL
 
-**If user provided a URL in the command (starts with `https://` or `git@`), use it directly.**
+**If user provided a URL in the command (starts with `https://` or `git@`), use it directly. Skip to 2b.**
 
-Otherwise ask:
-
-**Fresh init (no existing config):**
-```json
-{
-  "questions": [{
-    "question": "Repository URL? (detected: {DETECTED_URL})",
-    "header": "Repository",
-    "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"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+Otherwise, CALL the AskUserQuestion tool NOW with:
+- header: "Repository"
+- question: "Repository URL? (detected: {DETECTED_URL})"
+- options: Use detected URL (Recommended) / Enter GitHub URL / Enter Azure DevOps URL / Local only
+- **If user selects a custom option, CALL AskUserQuestion again for the actual URL.**
+- Store the result as `{REPO_URL}`.
 
-**Reconfigure mode (existing config):**
-```json
-{
-  "questions": [{
-    "question": "Repository URL? (current: {EXISTING_URL})",
-    "header": "Repository",
-    "options": [
-      {"label": "Keep current (Recommended)", "description": "{EXISTING_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"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+### 2b. Root Folder — CALL AskUserQuestion NOW
 
-**If user selects a custom option, ask follow-up for the actual URL.**
+DO NOT SKIP THIS. DO NOT auto-derive from the URL.
 
-### 2b. Root Folder
+CALL the AskUserQuestion tool with:
+- header: "Location"
+- question: "Root folder for this project? (worktrees will be created here)"
+- options: Use parent folder (Recommended): "{PARENT_DIR}/" / Use current folder: "{CURRENT_DIR}/" / Custom path
+- In reconfigure mode: add "Keep current" option with `{EXISTING_ROOT}`
+- **If user selects "Custom path", CALL AskUserQuestion again for the actual path.**
 
-**CRITICAL for WSL: Normalize the path for the current platform.**
+WAIT for the user's response. Store as `{PROJECT_BASE}`.
 
-**Fresh init:**
-```json
-{
-  "questions": [{
-    "question": "Root folder for this project? (worktrees will be created here)",
-    "header": "Location",
-    "options": [
-      {"label": "Use parent folder (Recommended)", "description": "{PARENT_DIR}/ - consistent with {SIBLING_COUNT} sibling project(s)"},
-      {"label": "Use current folder", "description": "{CURRENT_DIR}/ - will create subfolders here"},
-      {"label": "Custom path", "description": "Specify a different location"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+After getting the response, normalize the path:
+- On WSL: translate Windows paths to /mnt/ format
+- On Windows: ensure forward slashes
 
-**Reconfigure mode:**
-```json
-{
-  "questions": [{
-    "question": "Root folder? (current: {EXISTING_ROOT})",
-    "header": "Location",
-    "options": [
-      {"label": "Keep current (Recommended)", "description": "{EXISTING_ROOT}"},
-      {"label": "Use parent folder", "description": "{PARENT_DIR}/"},
-      {"label": "Custom path", "description": "Specify a different location"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+### 2c. Project Name — CALL AskUserQuestion NOW
 
-**After getting the path, normalize it:**
-```bash
-# On WSL: translate Windows paths to /mnt/ format
-# On Windows: ensure forward slashes
-# Store the platform-normalized path as PROJECT_BASE
-```
+DO NOT SKIP THIS. DO NOT auto-derive from the URL.
 
-### 2c. Project Name
+CALL the AskUserQuestion tool with:
+- header: "Project"
+- question: "Project name? (detected: {DETECTED_NAME})"
+- options: Use detected name (Recommended): "{DETECTED_NAME}" / Custom name
+- In reconfigure mode: add "Keep current" option with `{EXISTING_NAME}`
+- **If user selects "Custom name", CALL AskUserQuestion again for the actual name.**
 
-**Fresh init:**
-```json
-{
-  "questions": [{
-    "question": "Project name? (detected: {DETECTED_NAME})",
-    "header": "Project",
-    "options": [
-      {"label": "Use detected name (Recommended)", "description": "{DETECTED_NAME}"},
-      {"label": "Custom name", "description": "Specify a different project name"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+WAIT for the user's response. Store as `{PROJECT_NAME}`.
 
-**Reconfigure mode:**
-```json
-{
-  "questions": [{
-    "question": "Project name? (current: {EXISTING_NAME})",
-    "header": "Project",
-    "options": [
-      {"label": "Keep current (Recommended)", "description": "{EXISTING_NAME}"},
-      {"label": "Custom name", "description": "Specify a different project name"}
-    ],
-    "multiSelect": false
-  }]
-}
-```
+Then normalize name into variants (PascalCase.Dot, PascalCase, kebab-case, snake_case, Display Name).
 
-Normalize name into variants (PascalCase.Dot, PascalCase, kebab-case, snake_case, Display Name).
+### 2d. Worktree Mode — CALL AskUserQuestion NOW
 
-### 2d. Worktree Mode
+DO NOT SKIP THIS. This question has been skipped in past sessions causing incorrect defaults.
 
-⛔ MANDATORY — this question is FREQUENTLY SKIPPED by accident. ALWAYS ask it.
+CALL the AskUserQuestion tool with:
+- header: "Worktrees"
+- question: "How should worktrees be organized?"
+- options: Organized (Recommended): "01-Main, 02-Develop, ..." / Simple: "main/, develop/, ..." / Disabled: "No worktrees, use git checkout"
+- In reconfigure mode: add "Keep current: {EXISTING_MODE}" option
 
-**Fresh init:**
-```json
-{
-  "questions": [{
-    "question": "How should worktrees be organized?",
-    "header": "Worktrees",
-    "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
-  }]
-}
-```
+WAIT for the user's response. Store as `{WORKTREE_MODE}` ("organized", "simple", or "disabled").
 
-**Reconfigure mode:**
-```json
-{
-  "questions": [{
-    "question": "How should worktrees be organized? (current: {EXISTING_MODE})",
-    "header": "Worktrees",
-    "options": [
-      {"label": "Keep current: {EXISTING_MODE} (Recommended)", "description": "No change to worktree structure"},
-      {"label": "Organized", "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
-  }]
-}
-```
+---
 
-Store the result as `{WORKTREE_MODE}` ("organized", "simple", or "disabled").
+## GATE CHECK — SELF-VERIFICATION BEFORE STEP 3
 
----
+Before proceeding, verify your tool call history for this step:
 
-## GATE CHECK: Verify all 4 questions were answered
+**Count your AskUserQuestion calls in step 2. The minimum is:**
+- 3 calls if URL was provided in the command (2b + 2c + 2d)
+- 4 calls if URL was NOT provided (2a + 2b + 2c + 2d)
 
-⛔ BLOCKING — Do NOT proceed to step 3 until ALL variables are confirmed:
+**If your count is less than the minimum, STOP. You have skipped a question. Go back and ask it.**
 
-| Variable | Required | Source |
-|----------|----------|--------|
-| {REPO_URL} | ✅ | From command arg OR question 2a |
-| {PROJECT_BASE} | ✅ | From question 2b |
-| {PROJECT_NAME} | ✅ | From question 2c |
-| {WORKTREE_MODE} | ✅ | From question 2d — MUST be "organized", "simple", or "disabled" |
+All 4 variables MUST have been confirmed by the user (not auto-derived):
 
-If {WORKTREE_MODE} is not set, GO BACK and ask question 2d NOW.
+| Variable | Required | How to verify |
+|----------|----------|---------------|
+| {REPO_URL} | ✅ | From command arg OR user answered question 2a |
+| {PROJECT_BASE} | ✅ | User answered question 2b (NEVER auto-derived) |
+| {PROJECT_NAME} | ✅ | User answered question 2c (NEVER auto-derived) |
+| {WORKTREE_MODE} | ✅ | User answered question 2d (NEVER defaulted to "organized") |
 
 ---
 

package/templates/skills/gitflow/SKILL.md

@@ -185,7 +185,7 @@ start ──► commit* ──► sync ──► pr ──► merge ──► fi
 
 | Input Pattern | Step File | Task Agent (`subagent_type`) |
 |---------------|-----------|----------------------------|
-| `init` | `steps/step-init.md` | `gitflow-init` |
+| `init` | `steps/step-init.md` | **ALWAYS INLINE** (see below) |
 | `start`, `-f`, `-r`, `-h` | `steps/step-start.md` | `gitflow-start` |
 | `commit [msg]` | `steps/step-commit.md` | `gitflow-commit` |
 | `sync` | `steps/step-sync.md` | — |
@@ -206,6 +206,16 @@ start ──► commit* ──► sync ──► pr ──► merge ──► fi
 | **Auto mode** (`-a`) | Use `Task` tool with the matching `subagent_type` for each step sequentially |
 | **Standalone phases** | Always delegate to Task agent (fast, isolated) |
 
+**⚠️ SPECIAL RULE FOR `init`:**
+`init` is **ALWAYS executed inline** — NEVER delegate to a Task agent.
+Read `steps/step-init.md` and execute it directly in the main conversation.
+This is mandatory because `init` requires AskUserQuestion calls that MUST
+happen in the main conversation (sub-agents skip questions).
+After the user answers all questions, delegate heavy work to:
+- `Task(gitflow-init-detect)` for environment detection
+- `Task(gitflow-init-clone)` for structure creation
+- `Task(gitflow-init-validate)` for post-init verification
+
 </entry_point>
 
 <step_files>

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

@@ -1,10 +1,15 @@
 # MANDATORY User Questions for Init
 
-All questions must be asked in order. See step-init.md for context on when each is asked.
+╔══════════════════════════════════════════════════════════════════════════╗
+║  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
 
-**⛔ ALWAYS ask, even if URL was detected:**
+**CALL AskUserQuestion with these parameters (skip only if URL provided in command args):**
 
 ```yaml
 AskUserQuestion:
@@ -44,7 +49,7 @@ The user will type the actual URL via "Other". Then:
 
 ## Question 2: Root Folder
 
-**⛔ ALWAYS ask where to create THIS project's structure:**
+**CALL AskUserQuestion NOW — do NOT auto-derive from URL:**
 
 **If sibling projects exist, show where it fits:**
 
@@ -108,7 +113,7 @@ The user will type the actual path via "Other". Validate the path exists or can
 
 ## Question 3: Project Name
 
-**⛔ ALWAYS ask to confirm project name:**
+**CALL AskUserQuestion NOW — do NOT auto-derive from URL:**
 
 ```yaml
 AskUserQuestion:
@@ -170,8 +175,8 @@ AskUserQuestion:
 
 ## Question 5: Worktree Mode
 
-⛔ CRITICAL — This question is the MOST FREQUENTLY SKIPPED.
-It MUST be asked as a SEPARATE AskUserQuestion call. NEVER default silently.
+CALL AskUserQuestion NOW. This is the MOST FREQUENTLY SKIPPED question.
+Do NOT default to "organized". The user MUST explicitly choose.
 
 ```yaml
 AskUserQuestion:

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

@@ -10,129 +10,106 @@ next_step: null
 
 Set up GitFlow configuration with bare repository, worktrees, and branches.
 
-**ULTRA THINK before creating configuration.**
-
----
-
-## MANDATORY QUESTIONS
-
-**⛔ ALWAYS ask these 4 questions, even if values can be auto-detected.**
-**⛔ ALWAYS detect workspace context (step 2) to show sibling projects.**
-
-| Question | Variable | Auto-detect from |
-|----------|----------|------------------|
-| Repository URL | `{REPO_URL}` | `git remote get-url origin` |
-| Root folder | `{ROOT_FOLDER}` | Parent of current directory |
-| Project name | `{PROJECT_NAME}` | Repo name from URL or folder |
-| Worktree mode | `{WORKTREE_MODE}` | Default: organized |
-
-**Multi-project principle:** Each repository has its OWN independent GitFlow config. Step 2 scans for sibling projects to provide context, not to share configuration.
-
-**⛔ FOLLOW-UP RULE:** When a user selects a "Custom..." option (custom name, custom path, custom URL), that selection is just a CHOICE, not the actual value. You MUST immediately ask a follow-up question to capture the actual value. Never proceed with a blank or default value.
+**This step runs INLINE in the main conversation. All AskUserQuestion calls
+happen here (NOT in a sub-agent). Only clone/validate are delegated.**
 
 ---
 
 ## EXECUTION SEQUENCE:
 
-### 1. Detect Environment (for defaults only)
-
-See [references/init-environment-detection.md](../references/init-environment-detection.md) for:
-- Platform detection (WSL/Windows/macOS/Linux)
-- Git provider detection
-- Auto-detect defaults (URL, folder, project name)
-
-### 2. Detect Workspace (multi-project context)
-
-See [references/init-workspace-detection.md](../references/init-workspace-detection.md) for:
-- Sibling project scanning
-- Workspace context display
-- Per-repository GitFlow principle
+### 1. Detect Environment (delegate to sub-agent)
 
-### 3. Question: Existing Configuration
+Spawn `Task(gitflow-init-detect)` (haiku) to detect platform, git state, workspace siblings, provider.
+Parse the report to extract: PLATFORM, SHELL_TYPE, DETECTED_URL, DETECTED_NAME, GIT_PROVIDER, SIBLING_COUNT.
 
-**⛔ Only if `ALREADY_INITIALIZED` = true.** Otherwise skip to step 4.
+### 2. Check Existing Configuration
 
-See [references/init-questions.md](../references/init-questions.md) → **Question 4** for options (Reconfigure / Repair / View only / Cancel).
+If `.claude/gitflow/config.json` exists, ask user: Reconfigure / Repair / View / Cancel.
+If Cancel or View → EXIT. If Repair → delegate to `Task(gitflow-init-validate)` → EXIT.
 
-### 4. Question: Repository URL
+### 3. Question: Repository URL
 
-**⛔ MUST ASK — even if URL was auto-detected.**
+If URL was provided in command args (starts with `https://` or `git@`), use it directly → skip to step 4.
 
-See [references/init-questions.md](../references/init-questions.md) → **Question 1** for format and follow-up rules.
+Otherwise, call AskUserQuestion:
+- header: "Repository"
+- question: "Repository URL? (detected: {DETECTED_URL})"
+- options: Use detected URL (Recommended) / Enter GitHub URL / Enter Azure DevOps URL / Local only
+- If user selects custom option → ask follow-up for actual URL
 
-### 5. Question: Root Folder
+Store as `{REPO_URL}`.
 
-**⛔ MUST ASK — even if parent folder was auto-detected.**
+### 4. Question: Root Folder
 
-See [references/init-questions.md](../references/init-questions.md) → **Question 2** for format and follow-up rules.
+Call AskUserQuestion:
+- header: "Location"
+- question: "Root folder for this project? (worktrees will be created here)"
+- options:
+  - "Use parent folder (Recommended)" — "{PARENT_DIR}/ - consistent with {SIBLING_COUNT} sibling project(s)"
+  - "Use current folder" — "{CURRENT_DIR}/"
+  - "Custom path" — "Specify a different location"
+- If user selects "Custom path" → ask follow-up for actual path
 
-### 6. Question: Project Name
+Store as `{PROJECT_BASE}`. Normalize for platform (WSL: /mnt/ format, Windows: forward slashes).
 
-**⛔ MUST ASK — even if name was auto-detected.**
+### 5. Question: Project Name
 
-See [references/init-questions.md](../references/init-questions.md) → **Question 3** for format and follow-up rules.
+Call AskUserQuestion:
+- header: "Project"
+- question: "Project name? (detected: {DETECTED_NAME})"
+- options:
+  - "Use detected name (Recommended)" — "{DETECTED_NAME}"
+  - "Custom name" — "Specify a different project name"
+- If user selects "Custom name" → ask follow-up for actual name
 
-### 6b. Normalize Project Name (INTELLIGENT)
+Store as `{PROJECT_NAME}`.
 
-**⛔ ALWAYS normalize, even if user chose the detected name.**
+Then normalize into variants: PascalCase.Dot, PascalCase, kebab-case, snake_case, Display Name.
+See [references/init-name-normalization.md](../references/init-name-normalization.md).
 
-See [references/init-name-normalization.md](../references/init-name-normalization.md) for the full 5-step process:
-1. Parse input into words (split on separators + camelCase)
-2. Language detection and spell check (ask user if typos found)
-3. Generate all name variants (PascalCase.Dot, PascalCase, kebab-case, snake_case)
-4. Ask user to choose PRIMARY format
-5. Store all derived names in `PROJECT_VARIANTS`
+### 6. Question: Worktree Mode
 
-### 7. Question: Worktree Mode
+Call AskUserQuestion:
+- header: "Worktrees"
+- question: "How should worktrees be organized?"
+- options:
+  - "Organized (Recommended)" — "Numbered folders: 01-Main/, 02-Develop/, features/, releases/, hotfixes/"
+  - "Simple" — "Plain folders: main/, develop/, features/, releases/, hotfixes/"
+  - "Disabled" — "No worktrees, use git checkout (not recommended)"
 
-**⛔ MUST ASK — this determines the directory structure (step 8).**
+Store as `{WORKTREE_MODE}` ("organized", "simple", or "disabled").
 
-⛔ BLOCKING: If you reach step 8 without having asked the worktree mode question
-and received an explicit user answer, STOP and ask it NOW.
+### 7. Confirm all values
 
-See [references/init-questions.md](../references/init-questions.md) → **Question 5** for options:
-- **Organized** (recommended): `01-Main/`, `02-Develop/`, `features/`, `releases/`, `hotfixes/`
-- **Simple**: `main/`, `develop/`, `features/`, `releases/`, `hotfixes/`
-- **Disabled**: No worktrees, use `git checkout`
-
-
-### 8. Create Directory Structure
-
-See [references/init-structure-creation.md](../references/init-structure-creation.md) for:
-- Path normalization for WSL
-- Complete directory structure creation with absolute paths
-- Bare repository setup
-- Worktree creation (organized and simple modes)
-- GitFlow config directory creation
-
-### 9. Detect Version
-
-**⛔ MUST run BEFORE creating config.json (step 10) — the detected `{VERSION}` is needed in the config template.**
-
-See [references/init-version-detection.md](../references/init-version-detection.md) for:
-- Version detection with priority (csproj, package.json, tags, etc.)
-- Platform-agnostic path handling
-- Fallback: `0.0.0` if no version source found
-
-**⛔ WARNING:** Do NOT confuse the config schema version (`"version": "2.1.0"` at line 1 of config.json) with the project version (`"versioning.current": "{VERSION}"`). They are completely different values.
+Display a summary to the user before proceeding:
+```
+Ready to initialize:
+  URL:      {REPO_URL}
+  Folder:   {PROJECT_BASE}
+  Name:     {PROJECT_NAME}
+  Mode:     {WORKTREE_MODE}
+```
 
-### 10. Create Configuration
+### 8. Create Directory Structure (delegate to sub-agent)
 
-**Write `.claude/gitflow/config.json` in develop worktree using the `{VERSION}` detected in step 9.**
+**Skip if `{WORKTREE_MODE}` is "disabled".**
 
-See [references/init-config-template.md](../references/init-config-template.md) for:
-- Full config.json v2.1.0 template (platform, workspace, repository, git, worktrees, versioning, efcore, workflow, language)
-- Path storage convention (`normalize_path_for_storage()` format)
+Spawn `Task(gitflow-init-clone)` (sonnet) with the user-confirmed values:
+- REPO_URL, PROJECT_BASE, PROJECT_NAME, WORKTREE_MODE, PLATFORM
 
-**⛔ IMPORTANT:** Store paths using Windows-style format (`D:/path/to/folder`). The `read_gitflow_config()` in `_shared.md` translates to platform format at read time.
+See [references/init-structure-creation.md](../references/init-structure-creation.md) for details.
 
-### 10b. Post-Init Validation
+### 9. Detect Version + Create Configuration
 
-**⛔ MANDATORY: Verify the structure was created correctly.**
+Detect version (csproj > package.json > tags > fallback `0.0.0`).
+Write `.claude/gitflow/config.json` in develop worktree.
+See [references/init-config-template.md](../references/init-config-template.md) for template.
+Store paths as `D:/path/to/folder` format.
 
-See [references/init-config-template.md](../references/init-config-template.md) — Section "Post-Init Validation" for the full bash validation script.
+### 10. Post-Init Validation (delegate to sub-agent)
 
-Checks: .bare/HEAD, worktree branches (main/develop), features/releases/hotfixes dirs, .claude/gitflow/ dir.
+Spawn `Task(gitflow-init-validate)` (haiku) to verify structure.
+Checks: .bare/HEAD, worktree branches, directories, config file.
 
 ### 11. Summary
 
@@ -200,7 +177,7 @@ Before completing init, verify:
 
 ## SUCCESS CRITERIA:
 
-- ✅ All 4 mandatory questions asked (URL, folder, name, worktree mode)
+- ✅ AskUserQuestion called for root folder, project name, AND worktree mode
 - ✅ Complete folder structure created
 - ✅ Both main and develop worktrees functional
 - ✅ Configuration file created