@atlashub/smartstack-cli 3.37.0 → 3.39.0

package/package.json

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

package/scripts/extract-api-endpoints.ts

@@ -21,7 +21,7 @@ interface DocApiEndpoint {
 
 interface PermissionConstant {
   constantPath: string; // e.g., "Permissions.Admin.Users.View"
-  value: string;        // e.g., "platform.administration.users.read"
+  value: string;        // e.g., "administration.users.read"
 }
 
 /**
@@ -61,7 +61,7 @@ async function findControllerFile(appPath: string, module: string): Promise<stri
 
 /**
  * Extract NavRoute attribute value
- * Example: [NavRoute("platform.administration.users")] → "platform.administration.users"
+ * Example: [NavRoute("administration.users")] → "administration.users"
  */
 function extractNavRoute(content: string): string | null {
   const navRouteRegex = /\[NavRoute\("([^"]+)"\)\]/;
@@ -146,7 +146,7 @@ async function loadPermissionConstants(appPath: string): Promise<Map<string, str
   const map = new Map<string, string>();
 
   // Parse permission constant definitions
-  // Example: public const string View = "platform.administration.users.read";
+  // Example: public const string View = "administration.users.read";
   const lines = content.split('\n');
   let currentNamespace = '';
 
@@ -194,7 +194,7 @@ function resolvePermission(
   }
 
   // Fallback: infer from constant name
-  // Permissions.Admin.Users.View → platform.administration.users.read
+  // Permissions.Admin.Users.View → administration.users.read
   const parts = constantPath.split('.');
   if (parts.length >= 3) {
     const action = parts[parts.length - 1].toLowerCase();
@@ -236,7 +236,7 @@ async function extractEndpoints(
   }
 
   // Build base API path from navRoute
-  // "platform.administration.users" → "/api/platform/administration/users"
+  // "administration.users" → "/api/administration/users"
   const basePath = `/api/${navRoute.replace(/\./g, '/')}`;
 
   // Parse line by line to find endpoint methods

package/scripts/generate-doc-with-mock-ui.ts

@@ -8,7 +8,6 @@
  * Usage:
  *   node generate-doc-with-mock-ui.ts \
  *     --module users \
- *     --context platform \
  *     --application administration \
  *     --app-path "D:/01 - projets/SmartStack.app/02-Develop"
  *
@@ -22,7 +21,6 @@ import { execSync } from 'child_process';
 
 interface ModuleInfo {
   module: string;        // e.g., "users"
-  context: string;       // e.g., "platform"
   application: string;   // e.g., "administration"
   appPath: string;
 }
@@ -59,16 +57,15 @@ function parseArgs(): ModuleInfo {
   };
 
   const module = getArg('--module');
-  const context = getArg('--context');
   const application = getArg('--application');
   const appPath = getArg('--app-path');
 
-  if (!module || !context || !application || !appPath) {
-    console.error('Usage: node generate-doc-with-mock-ui.ts --module <name> --context <ctx> --application <app> --app-path <path>');
+  if (!module || !application || !appPath) {
+    console.error('Usage: node generate-doc-with-mock-ui.ts --module <name> --application <app> --app-path <path>');
     process.exit(1);
   }
 
-  return { module, context, application, appPath };
+  return { module, application, appPath };
 }
 
 /**
@@ -102,8 +99,8 @@ async function findEntityFile(appPath: string, module: string): Promise<string |
 /**
  * Find React page file
  */
-async function findPageFile(appPath: string, module: string, context: string, application: string): Promise<string | null> {
-  const pagesPath = path.join(appPath, `web/smartstack-web/src/pages/${context}/${application}/${module}`);
+async function findPageFile(appPath: string, module: string, application: string): Promise<string | null> {
+  const pagesPath = path.join(appPath, `web/smartstack-web/src/pages/${application}/${module}`);
   const pattern = `${capitalize(module)}Page.tsx`;
 
   const fullPath = path.join(pagesPath, pattern);
@@ -523,7 +520,7 @@ function generateDocumentationTSX(
   businessRules: any[],
   pageStructure: PageStructure
 ): string {
-  const { module, context, application } = moduleInfo;
+  const { module, application } = moduleInfo;
   const ModuleName = capitalize(module);
 
   // Generate mock data
@@ -575,8 +572,6 @@ export function ${ModuleName}DocPage() {
         <span>/</span>
         <Link to="/system/docs/user" className="hover:text-[var(--color-primary-600)]">User</Link>
         <span>/</span>
-        <Link to="/system/docs/user/${context}" className="hover:text-[var(--color-primary-600)]">${capitalize(context)}</Link>
-        <span>/</span>
         <span>${ModuleName}</span>
       </div>
 
@@ -612,8 +607,6 @@ export function ${ModuleName}DocPage() {
         <div className="mb-4">
           <div className="text-sm font-medium mb-2">Navigation</div>
           <div className="flex items-center gap-2 text-sm bg-[var(--bg-secondary)] p-3 rounded-lg">
-            <span className="px-2 py-1 bg-[var(--bg-primary)] rounded">${capitalize(context)}</span>
-            <ArrowRight className="w-4 h-4 text-[var(--text-tertiary)]" />
             <span className="px-2 py-1 bg-[var(--bg-primary)] rounded">${capitalize(application)}</span>
             <ArrowRight className="w-4 h-4 text-[var(--text-tertiary)]" />
             <span className="px-2 py-1 bg-[var(--color-primary-600)] text-white rounded">${ModuleName}</span>
@@ -623,7 +616,7 @@ export function ${ModuleName}DocPage() {
         <div className="mb-4">
           <div className="text-sm font-medium mb-2">URL</div>
           <code className="block p-3 bg-[var(--bg-secondary)] rounded-lg text-sm font-mono">
-            /${context}/${application}/${module}
+            /${application}/${module}
           </code>
         </div>
       </section>
@@ -732,9 +725,9 @@ function singularize(str: string): string {
  */
 async function main() {
   const moduleInfo = parseArgs();
-  const { module, context, application, appPath } = moduleInfo;
+  const { module, application, appPath } = moduleInfo;
 
-  console.error(`\n🚀 Generating documentation for: ${context}/${application}/${module}\n`);
+  console.error(`\n🚀 Generating documentation for: ${application}/${module}\n`);
 
   // 1. Find entity file
   console.error('📁 Finding entity file...');
@@ -752,7 +745,7 @@ async function main() {
 
   // 3. Find page file
   console.error('\n📄 Finding React page...');
-  const pagePath = await findPageFile(appPath, module, context, application);
+  const pagePath = await findPageFile(appPath, module, application);
   if (pagePath) {
     console.error(`✅ Found: ${pagePath}`);
   } else {

package/templates/agents/ba-reader.md

@@ -123,13 +123,13 @@ Get a compact summary of all completed (specified) modules, for use as context w
 ### Customers (FEAT-011)
 Entities: Customer, Address, Contact
 BRs: BR-VAL-001 (email unique), BR-WF-001 (activation flow)
-Permissions: business.sales.customers.{read|create|update|delete}
+Permissions: sales.customers.{read|create|update|delete}
 FKs exposed: Customer.Id, Address.Id
 
 ### Products (FEAT-012)
 Entities: Product, Category, PriceHistory
 BRs: BR-VAL-002 (SKU format), BR-CALC-001 (price calculation)
-Permissions: business.sales.products.{read|create|update}
+Permissions: sales.products.{read|create|update}
 FKs exposed: Product.Id, Category.Id
 ```
 
@@ -289,11 +289,11 @@ Generate compact context for use by other skills and agents.
 - Interaction
 
 ## Permissions (5)
-- business.crm.contacts.create
-- business.crm.contacts.read
-- business.crm.contacts.update
-- business.crm.contacts.delete
-- business.crm.contacts.export
+- crm.contacts.create
+- crm.contacts.read
+- crm.contacts.update
+- crm.contacts.delete
+- crm.contacts.export
 
 ## Business Rules (4)
 - BR-VAL-001: Email must be unique
@@ -340,7 +340,7 @@ When encountering ID references, resolve them:
 **Format resolved references as inline citations:**
 - "UC-001 (Create new contact)"
 - "[BR-SEC-015: Sensitive data encryption required]"
-- "business.crm.contacts.create (used in UC-001, UC-003)"
+- "crm.contacts.create (used in UC-001, UC-003)"
 
 ## Error Handling
 
@@ -366,7 +366,7 @@ This agent provides context for:
 ```
 User: "What permissions does FEAT-042 need?"
 → Operation: answerQuestion(FEAT-042, "What permissions does this feature need?")
-→ Output: List of business.crm.contacts.* permissions with use case mapping
+→ Output: List of crm.contacts.* permissions with use case mapping
 
 User: "Find all features that use the Contact entity"
 → Operation: searchAcrossFeatures("Contact")

package/templates/agents/ba-writer.md

@@ -14,8 +14,8 @@ Write and update feature.json files for project-level (multi-app), application-l
 
 **Directory structure (3-tier hierarchy):**
 - Project-level (multi-app only): `docs/business-analyse/v{X.Y}/feature.json`
-- Application-level: `docs/{context}/{app}/business-analyse/v{X.Y}/feature.json`
-- Module-level: `docs/{context}/{app}/{module}/business-analyse/v{X.Y}/feature.json`
+- Application-level: `docs/{app}/business-analyse/v{X.Y}/feature.json`
+- Module-level: `docs/{app}/{module}/business-analyse/v{X.Y}/feature.json`
 
 > **Backward compatibility:** If only 1 application, the project level is NOT created. The application-level feature.json remains the master.
 
@@ -29,7 +29,6 @@ Create an initial feature.json with metadata and draft status.
 - scope: "project", "application", or "module" (default: "module")
 - Optional: applicationRef (FEAT-NNN of master, required when scope = "module" in app mode)
 - Optional: projectRef (PROJ-NNN of project master, required when scope = "application" in project mode)
-- Optional: context (default: "business", allows "platform" or "personal" in project mode)
 - Optional: initialSections for pre-populated content
 
 **Process:**
@@ -37,8 +36,8 @@ Create an initial feature.json with metadata and draft status.
 2. Increment FEAT-NNN (or PROJ-NNN) identifier
 3. Create directory structure based on scope:
    - If scope = "project": `docs/business-analyse/v1.0/`
-   - If scope = "application": `docs/{context}/{app}/business-analyse/v1.0/`
-   - If scope = "module": `docs/{context}/{app}/{module}/business-analyse/v1.0/`
+   - If scope = "application": `docs/{app}/business-analyse/v1.0/`
+   - If scope = "module": `docs/{app}/{module}/business-analyse/v1.0/`
 4. Generate initial feature.json with:
    - **`$schema`**: relative path to the deployed schema file (MANDATORY — see $schema rules below)
    - id: FEAT-NNN (from config)
@@ -104,7 +103,7 @@ Update the applications array and dependency graph in a project-level feature.js
 
 **Input:**
 - projectId: PROJ-NNN of the project feature.json
-- applications: array of application objects (code, name, context, tablePrefix, icon, description, applicationRoles[], scope, dependencies[], estimatedComplexity)
+- applications: array of application objects (code, name, tablePrefix, icon, description, applicationRoles[], scope, dependencies[], estimatedComplexity)
 - applicationDependencyGraph: object with edges[], topologicalOrder[], layers[]
 
 **Process:**
@@ -432,7 +431,7 @@ Perform these structural checks before every write:
 - BR IDs: must match `BR-(VAL|CALC|WF|SEC|DATA)-[A-Z]{2,4}-\d{3}` (e.g., BR-SEC-RM-042) — module prefix MANDATORY in multi-module mode
 - UC IDs: must match `UC-[A-Z]{2,4}-\d{3}` (e.g., UC-RM-007) — module prefix MANDATORY in multi-module mode
 - FR IDs: must match `FR-[A-Z]{2,4}-\d{3}` (e.g., FR-RM-012) — module prefix MANDATORY in multi-module mode
-- Permission paths: must match `business\.{app}\.{module}\.{resource}\.{action}` (e.g., business.crm.contacts.read)
+- Permission paths: must match `{app}\.{module}\.{resource}\.{action}` (e.g., crm.contacts.read)
 
 **Metadata:**
 - id, version, status, scope are required
@@ -442,7 +441,7 @@ Perform these structural checks before every write:
 
 **Cross-references:**
 - All BR-XXX, UC-XXX, FR-XXX referenced must be defined in their respective sections
-- Permission paths must use full format with 5 segments: `business.{app}.{module}.{resource}.{action}`
+- Permission paths must use full format with 4 segments: `{app}.{module}.{resource}.{action}`
 
 **Application-scope specific:**
 - `modules[]` must exist and be non-empty after decomposition
@@ -593,19 +592,17 @@ docs/business-analyse/
   v1.0/
     feature.json                          ← PROJECT (multi-app master, only if 2+ apps)
 
-docs/{context}/{app}/business-analyse/
+docs/{app}/business-analyse/
   v1.0/
     feature.json                          ← APPLICATION (master)
 
-docs/{context}/{app}/{module}/business-analyse/
+docs/{app}/{module}/business-analyse/
   v1.0/
     feature.json                          ← MODULE (detailed)
   v1.1/
     feature.json
 ```
 
-> **{context}** = "business" (default) | "platform" | "personal" — determined per application in project mode.
-
 Versions are stored as separate files in versioned directories. Always store feature.json at the root of each version folder.
 
 ## Config Management
@@ -762,15 +759,15 @@ If a module feature.json exceeds 500KB despite incremental operations:
 ## $schema Reference Rules (MANDATORY)
 
 > **Every feature.json MUST include a `$schema` field** pointing to the deployed schema file via relative path.
-> Schemas are deployed by step-00-init to: `docs/business/{app}/business-analyse/schemas/`
+> Schemas are deployed by step-00-init to: `docs/{app}/business-analyse/schemas/`
 
 **$schema paths by scope:**
 
 | Scope | Feature.json location | $schema value |
 |-------|----------------------|---------------|
 | project | `docs/business-analyse/v1.0/feature.json` | `"../schemas/project-schema.json"` |
-| application | `docs/{context}/{app}/business-analyse/v1.0/feature.json` | `"../schemas/application-schema.json"` |
-| module | `docs/{context}/{app}/{module}/business-analyse/v1.0/feature.json` | `"../../../business-analyse/schemas/feature-schema.json"` |
+| application | `docs/{app}/business-analyse/v1.0/feature.json` | `"../schemas/application-schema.json"` |
+| module | `docs/{app}/{module}/business-analyse/v1.0/feature.json` | `"../../../business-analyse/schemas/feature-schema.json"` |
 
 **Rules:**
 - `$schema` is ALWAYS the FIRST field in feature.json (before `id`)

package/templates/agents/code-reviewer.md

@@ -2,7 +2,7 @@
 name: code-reviewer
 description: Expert code reviewer for PR analysis. Use when reviewing code changes for security, logic, clean code, or feature-specific behavior. Accepts focus area and file list. Returns structured findings table.
 tools: Read, Grep, Glob, Skill
-model: haiku
+model: sonnet
 ---
 
 <role>

package/templates/agents/docs-context-reader.md

@@ -66,7 +66,7 @@ For each module found, extract:
 - Feature status (draft/analysed/specified/approved/handed-off)
 - Use Case IDs (UC-001, UC-002...)
 - Business Rule IDs (BR-001, BR-002...)
-- Permission paths (business.app.module.action)
+- Permission paths (app.module.action)
 - Last update dates (from metadata.updatedAt)
 - Validation decision (APPROVED/REJECTED/pending)
 - Version (from folder name v1.0, v1.1, etc.)

package/templates/agents/efcore/scan.md

@@ -45,7 +45,9 @@ FOR each branch in active_worktrees:
 ## Fallback Commands (if MCP unavailable)
 
 ```bash
-# List worktrees
+# List worktrees (run preflight_git_check first for cross-platform compatibility)
+detect_platform
+repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
 git worktree list
 
 # ModelSnapshot hash

package/templates/agents/gitflow/commit.md

@@ -14,6 +14,80 @@ Commit with EF Core migration validation. Executes directly, displays only the r
 
 ## EXECUTION SEQUENCE
 
+### 0. Pre-flight: Worktree Accessibility
+
+```bash
+# Quick check: can git resolve the repo?
+git rev-parse --git-dir >/dev/null 2>&1
+if [ $? -ne 0 ]; then
+  # Worktree .git file likely has cross-platform absolute path
+  # Find .bare directory by walking up
+  BARE_DIR=""
+  DIR="$(pwd)"
+  while [ "$DIR" != "/" ]; do
+    [ -d "$DIR/.bare" ] && { BARE_DIR="$DIR/.bare"; break; }
+    DIR=$(dirname "$DIR")
+  done
+
+  if [ -n "$BARE_DIR" ] && [ -f .git ]; then
+    echo "Repairing worktree paths (cross-platform fix)..."
+
+    # Detect platform
+    GF_PLATFORM="linux"
+    [ -f /proc/version ] && grep -qi "microsoft\|wsl" /proc/version 2>/dev/null && GF_PLATFORM="wsl"
+
+    # Repair all worktrees: convert absolute paths to relative paths
+    WORKTREES_DIR="$BARE_DIR/worktrees"
+    for wt_dir in "$WORKTREES_DIR"/*/; do
+      [ ! -d "$wt_dir" ] && continue
+      wt_name=$(basename "$wt_dir")
+      gitdir_file="$wt_dir/gitdir"
+      [ ! -f "$gitdir_file" ] && continue
+
+      stored_path=$(cat "$gitdir_file" | tr -d '\n\r')
+
+      # Determine if path is absolute and resolve to current platform
+      resolved_path="$stored_path"
+      is_abs=false
+      if [[ "$stored_path" =~ ^[A-Za-z]:[\\/] ]]; then
+        is_abs=true
+        if [ "$GF_PLATFORM" = "wsl" ]; then
+          drive=$(echo "${stored_path:0:1}" | tr '[:upper:]' '[:lower:]')
+          rest="${stored_path:2}"; rest="${rest//\\//}"
+          resolved_path="/mnt/$drive$rest"
+        fi
+      elif [[ "$stored_path" =~ ^/ ]]; then
+        is_abs=true
+      fi
+      [ "$is_abs" = "false" ] && continue  # Already relative, skip
+
+      wt_real_dir=$(dirname "$resolved_path")
+      [ ! -d "$wt_real_dir" ] && continue
+
+      bare_wt_abs=$(realpath -m "$wt_dir")
+      wt_abs=$(realpath -m "$wt_real_dir")
+
+      # Fix gitdir backlink to relative
+      rel_gitdir=$(realpath -m --relative-to="$bare_wt_abs" "$wt_abs/.git")
+      [ "$stored_path" != "$rel_gitdir" ] && printf '%s\n' "$rel_gitdir" > "$gitdir_file"
+
+      # Fix worktree .git pseudo-file to relative
+      if [ -f "$wt_real_dir/.git" ]; then
+        git_content=$(cat "$wt_real_dir/.git" | tr -d '\n\r')
+        git_path="${git_content#gitdir: }"
+        rel_bare=$(realpath -m --relative-to="$wt_abs" "$bare_wt_abs")
+        [ "$git_path" != "$rel_bare" ] && printf 'gitdir: %s\n' "$rel_bare" > "$wt_real_dir/.git"
+      fi
+    done
+
+    # Verify repair
+    git rev-parse --git-dir >/dev/null 2>&1 && echo "Worktree paths repaired successfully" || { echo "BLOCKED: worktree repair failed"; exit 1; }
+  else
+    echo "BLOCKED: not a git repository and no .bare found"; exit 1
+  fi
+fi
+```
+
 ### 1. Guards
 
 ```bash

package/templates/agents/gitflow/finish.md

@@ -31,8 +31,11 @@ fi
 BRANCH=${1:-$(git rev-parse --abbrev-ref HEAD)}
 BRANCH_TYPE=$(echo $BRANCH | cut -d'/' -f1)
 
-# Worktree detection: if in a worktree, navigate to main repo
-# Normalize path for cross-platform compatibility (WSL ↔ Windows)
+# Worktree detection: repair cross-platform paths first (WSL ↔ Windows)
+# Source: _shared.md DETECT_PLATFORM + REPAIR_WORKTREE_PATHS
+detect_platform
+repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
+
 WORKTREE_PATH=$(git worktree list --porcelain | grep -B2 "branch refs/heads/$BRANCH" | grep "^worktree " | sed 's/^worktree //')
 WORKTREE_PATH=$(normalize_path_for_platform "$WORKTREE_PATH")
 ```

package/templates/agents/gitflow/init-clone.md

@@ -96,7 +96,7 @@ if [ ! -d "$PROJECT_BASE/develop" ]; then
 fi
 ```
 
-### 5b. Fix Cross-Platform Worktree Paths
+### 5b. Convert Worktree Paths to Relative (Cross-Platform)
 
 ```bash
 PROJECT_BASE="{PROJECT_BASE}"
@@ -104,8 +104,8 @@ PROJECT_BASE="{PROJECT_BASE}"
 # Detect current platform (needed for path normalization)
 detect_platform
 
-# Repair any cross-platform paths written by git worktree add
-# (e.g., WSL paths /mnt/d/... when running on Windows, or vice versa)
+# Convert absolute paths written by git worktree add to relative paths
+# Relative paths work on both Windows and WSL without needing repair when switching
 repair_worktree_paths "$PROJECT_BASE/.bare"
 ```
 

package/templates/agents/gitflow/init-validate.md

@@ -136,7 +136,8 @@ done
 
 ### 2b. Worktree Path Integrity (Cross-Platform)
 
-Repair worktree metadata files that contain paths from a different platform (e.g., WSL paths `/mnt/d/...` on Windows or Windows paths `D:/...` on WSL).
+Convert worktree metadata paths to relative format for cross-platform compatibility.
+Relative paths work on both Windows (VS Code) and WSL without needing repair when switching.
 
 ```bash
 PROJECT_BASE="{PROJECT_BASE}"
@@ -144,7 +145,7 @@ PROJECT_BASE="{PROJECT_BASE}"
 # Source platform detection and path functions from _shared.md
 detect_platform
 
-# Repair cross-platform paths in .bare/worktrees/*/gitdir and worktree/.git files
+# Convert absolute paths to relative in .bare/worktrees/*/gitdir and worktree/.git files
 repair_worktree_paths "$PROJECT_BASE/.bare"
 ```
 

package/templates/agents/gitflow/merge.md

@@ -19,15 +19,16 @@ Safe PR merge with review checklist. Supports GitHub and Azure DevOps.
 CONFIG_FILE=""
 if [ -f ".claude/gitflow/config.json" ]; then
   CONFIG_FILE=".claude/gitflow/config.json"
-elif [ -f ".gitflow/config.json" ]; then
-  CONFIG_FILE=".gitflow/config.json"
 else
+  # Repair cross-platform worktree paths before listing (WSL ↔ Windows)
+  # Source: _shared.md DETECT_PLATFORM + REPAIR_WORKTREE_PATHS
+  detect_platform
+  repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
+
   # Try develop worktree
   DEVELOP_PATH=$(git worktree list --porcelain 2>/dev/null | grep -A1 "branch refs/heads/develop" | grep "^worktree " | sed 's/^worktree //')
   if [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.claude/gitflow/config.json" ]; then
     CONFIG_FILE="$DEVELOP_PATH/.claude/gitflow/config.json"
-  elif [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.gitflow/config.json" ]; then
-    CONFIG_FILE="$DEVELOP_PATH/.gitflow/config.json"
   fi
 fi
 

package/templates/agents/gitflow/pr.md

@@ -21,15 +21,16 @@ Create PR with auto-generated description, Azure DevOps and GitHub support.
 CONFIG_FILE=""
 if [ -f ".claude/gitflow/config.json" ]; then
   CONFIG_FILE=".claude/gitflow/config.json"
-elif [ -f ".gitflow/config.json" ]; then
-  CONFIG_FILE=".gitflow/config.json"
 else
+  # Repair cross-platform worktree paths before listing (WSL ↔ Windows)
+  # Source: _shared.md DETECT_PLATFORM + REPAIR_WORKTREE_PATHS
+  detect_platform
+  repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
+
   # Try develop worktree
   DEVELOP_PATH=$(git worktree list --porcelain 2>/dev/null | grep -A1 "branch refs/heads/develop" | grep "^worktree " | sed 's/^worktree //')
   if [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.claude/gitflow/config.json" ]; then
     CONFIG_FILE="$DEVELOP_PATH/.claude/gitflow/config.json"
-  elif [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.gitflow/config.json" ]; then
-    CONFIG_FILE="$DEVELOP_PATH/.gitflow/config.json"
   fi
 fi
 

package/templates/agents/gitflow/start.md

@@ -45,13 +45,45 @@ FULL_BRANCH="${type}/${BRANCH_NAME}"
 
 ### 4. Create Branch + Worktree
 
-```bash
-# Worktree paths from config or convention:
-# feature → ../features/{name}
-# release → ../releases/v{version}
-# hotfix  → ../hotfixes/{name}
+> **FORBIDDEN — Numbered directories:**
+> - `03-Release`, `04-Feature`, `05-Hotfix` — NEVER create these
+> - Only `01-Main` and `02-Develop` are numbered (permanent worktrees created at init)
+> - Features go in `{root}/features/{name}`, releases in `{root}/releases/v{version}`, hotfixes in `{root}/hotfixes/{name}`
+> - The path MUST come from `config.json → worktrees.structure.{features|releases|hotfixes}`
 
+```bash
+# 1. Read config (MANDATORY — paths come from here, NEVER improvised)
+read_gitflow_config || { echo "ERROR: No config. Run /gitflow init"; exit 1; }
+
+# 2. Resolve path from CONFIG (NEVER improvise numbered directories)
+case "$branch_type" in
+  feature) WORKTREE_PATH="$GF_FEATURES_PATH/$BRANCH_NAME" ;;
+  release) WORKTREE_PATH="$GF_RELEASES_PATH/v$VERSION" ;;
+  hotfix)  WORKTREE_PATH="$GF_HOTFIXES_PATH/$BRANCH_NAME" ;;
+esac
+
+# 3. Create worktree
+mkdir -p "$(dirname "$WORKTREE_PATH")"
 git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
+
+# 4. POST-CREATION: Repair worktree paths FIRST, then validate
+# Uses repair_worktree_paths from _shared.md REPAIR_WORKTREE_PATHS section
+BARE_DIR=$(git rev-parse --git-common-dir 2>/dev/null)
+[ -n "$BARE_DIR" ] && repair_worktree_paths "$BARE_DIR"
+
+CREATED_PATH=$(git worktree list | grep "$FULL_BRANCH" | awk '{print $1}')
+BASENAME=$(basename "$CREATED_PATH")
+if [[ "$BASENAME" =~ ^[0-9]{2}- ]] && [[ "$BASENAME" != "01-Main" ]] && [[ "$BASENAME" != "02-Develop" ]]; then
+  echo "BLOCKING ERROR: Worktree created with numbered prefix: $CREATED_PATH"
+  echo "Expected path: $WORKTREE_PATH"
+  git worktree remove "$CREATED_PATH" --force
+  git branch -D "$FULL_BRANCH" 2>/dev/null
+  echo "Removed invalid worktree. Recreating at correct path..."
+  git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
+  # Repair again after recreation
+  BARE_DIR=$(git rev-parse --git-common-dir 2>/dev/null)
+  [ -n "$BARE_DIR" ] && repair_worktree_paths "$BARE_DIR"
+fi
 ```
 
 ### 5. Push Branch to Remote (AUTOMATIC)

package/templates/hooks/hooks.json

@@ -29,6 +29,17 @@
         ]
       }
     ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_HOOKS_DIR}/wsl-dotnet-cleanup.sh"
+          }
+        ]
+      }
+    ],
     "Stop": [
       {
         "hooks": [

package/templates/hooks/wsl-dotnet-cleanup.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+# WSL Dotnet Cleanup - PostToolUse Hook
+# Removes literal "bin\Debug" folders created by Roslyn BuildHost on WSL
+# Roslyn uses Windows path separators, creating "bin\Debug" as a single folder name
+# instead of the proper bin/Debug/ directory structure.
+
+set -euo pipefail
+
+HOOK_INPUT=$(cat)
+
+# Quick exit: only care about Bash tool calls containing "dotnet" (~1ms)
+case "$HOOK_INPUT" in
+  *dotnet*) ;; # proceed to cleanup
+  *) exit 0 ;; # fast exit
+esac
+
+# Find and remove corrupted bin\Debug folders (literal backslash in name)
+# bin?Debug matches "bin\Debug" where ? is the literal backslash character
+for d in src/*/bin?Debug bin?Debug; do
+  [ -d "$d" ] && rm -rf "$d"
+done
+
+exit 0