@atlashub/smartstack-cli 1.34.0 → 1.36.0

package/templates/skills/documentation/SKILL.md

@@ -8,14 +8,17 @@ description: |
   - User wants to document a module, table, tool, or test
   - After implementing a feature to generate its documentation
   Types: user module, developer tools, database ERD, testing tools
+argument-hint: "<module-name> [--type user|developer|database|testing|update]"
 ---
 
-# Skill Documentation SmartStack
-
-> **Note:** This skill works in synergy with the `/documentation:module` command.
+<objective>
+Generate and maintain technical documentation integrated into SmartStack web app.
+Works in synergy with the `/documentation:module` command.
 
 **Reference:** [_shared.md](../_shared.md) for architecture, i18n
+</objective>
 
+<quick_start>
 ## WHEN THIS SKILL ACTIVATES
 
 Claude automatically invokes this skill when it detects:
@@ -27,9 +30,33 @@ Claude automatically invokes this skill when it detects:
 | After implementation | "The feature is done, generate the doc" |
 | Structure question | "How is the documentation organized?" |
 | Keywords | "ERD", "schema", "diagram", "document" |
+| **Update request** | "Update the doc", "refresh documentation", "doc is outdated" |
+| **Drift detected** | "The SLA documentation is stale" |
+</quick_start>
 
----
+<parameters>
+## DOCUMENTATION TYPES
+
+| Type | Description | Output |
+|------|-------------|--------|
+| `user` | User module (data-driven) | `docs/business/{app}/{module}/frd-data.ts` + `index.tsx` |
+| `developer` | Development tool guide | `docs/developer/tools/{Tool}Page.tsx` |
+| `database` | Schema with ERD diagram | `docs/developer/database/{Schema}SchemaPage.tsx` |
+| `testing` | Testing tool | `docs/developer/testing/{Tool}TestingPage.tsx` |
+| `update` | Update existing documentation | Updates `frd-data.ts` + i18n FR |
+
+### Available Developer tools
+
+| Category | Tools |
+|----------|-------|
+| Local Environment | Docker Compose, MailDev, VS Code, Environment variables |
+| API Testing | Postman, REST Client, Swagger/OpenAPI |
+| E2E Testing | Microsoft Playwright, Inspector, Trace Viewer |
+| Load Testing | NBomber (.NET), k6, Azure Load Testing |
+| Security Testing | OWASP ZAP, Security Code Scan, Snyk, OWASP ASVS |
+</parameters>
 
+<workflow>
 ## AUTOMATIC WORKFLOW
 
 ### STEP 1: TYPE DETECTION
@@ -53,40 +80,35 @@ Identify the specific name:
 
 ### STEP 3: EXECUTION
 
-Follow the workflow of the `/documentation:module` command:
+**For NEW documentation (type = user|developer|database|testing):**
 
-```
-TYPE = detected type (user|developer|database|testing)
-TARGET = extracted target
+Follow the data-driven workflow from [templates.md](templates.md):
 
-→ Execute the complete /documentation:module workflow
+```
+1. Read source data (FRD, BRD, code patterns)
+2. Generate frd-data.ts (data file, ~50 lines)
+3. Generate index.tsx (page wrapper, ~10 lines)
+4. Generate i18n FR file (source language only)
+5. Update docs-manifest.json
+6. Update App.tsx routing and parent indexes
 ```
 
----
-
-## QUICK REFERENCE
-
-### Documentation types
-
-| Type | Description | Output |
-|------|-------------|--------|
-| `user` | User module with UI mockups | `docs/user/{context}/{Module}DocPage.tsx` |
-| `developer` | Development tool guide | `docs/developer/tools/{Tool}Page.tsx` |
-| `database` | Schema with ERD diagram | `docs/developer/database/{Schema}SchemaPage.tsx` |
-| `testing` | Testing tool | `docs/developer/testing/{Tool}TestingPage.tsx` |
-
-### Available Developer tools
+**For UPDATE documentation (type = update):**
 
-| Category | Tools |
-|----------|-------|
-| Local Environment | Docker Compose, MailDev, VS Code, Environment variables |
-| API Testing | Postman, REST Client, Swagger/OpenAPI |
-| E2E Testing | Microsoft Playwright, Inspector, Trace Viewer |
-| Load Testing | NBomber (.NET), k6, Azure Load Testing |
-| Security Testing | OWASP ZAP, Security Code Scan, Snyk, OWASP ASVS |
+```
+1. Read docs-manifest.json → find target module
+2. Invoke docs-context-reader agent → get current doc state
+3. Identify code changes since last doc update (git diff)
+4. Map changes to documentation sections (see data-schema.md)
+5. Update frd-data.ts with new/modified data
+6. Update i18n FR file if labels changed
+7. Update docs-manifest.json timestamps
+```
 
----
+> **i18n simplifié:** Seul FR (source) est généré. EN/IT/DE sont déférés à un pipeline de traduction séparé.
+</workflow>
 
+<execution_rules>
 ## ABSOLUTE RULES
 
 1. **NEVER** hardcoded text → `useTranslation('docs')`
@@ -95,6 +117,17 @@ TARGET = extracted target
 4. **ALWAYS** confirm before creating
 5. **ALWAYS** update App.tsx and parent indexes
 6. **ALWAYS** add module in `UserIndexPage.tsx` (IF type == `user`)
+</execution_rules>
+
+---
+
+<success_criteria>
+- Documentation page renders correctly in React app
+- i18n files created for all 4 languages (FR, EN, IT, DE)
+- Route registered in App.tsx
+- docs-manifest.json updated
+- Module appears in UserIndexPage (if type = user)
+</success_criteria>
 
 ---
 
@@ -131,4 +164,8 @@ TARGET = extracted target
 ## ASSOCIATED FILES
 
 - **React Templates:** [templates.md](templates.md)
+- **Data Schema:** [data-schema.md](data-schema.md)
+- **FrdDocRenderer:** `web/smartstack-web/src/components/docs/FrdDocRenderer.tsx`
+- **Types:** `web/smartstack-web/src/components/docs/types.ts`
+- **Manifest Schema:** `_resources/docs-manifest-schema.md`
 - **Complete Command:** `.claude/commands/documentation-module.md`

package/templates/skills/documentation/data-schema.md

@@ -0,0 +1,198 @@
+# Documentation Data Schema
+
+## Purpose
+
+This file describes how to generate `frd-data.ts` files for the `FrdDocRenderer` shared component.
+Instead of generating full TSX components (~250 lines) per module, generate only the data (~50 lines).
+
+## FrdData Interface Reference
+
+The full TypeScript interface is in `web/smartstack-web/src/components/docs/types.ts`.
+
+## Data Extraction Mapping
+
+### From FRD (3-functional-specification.md)
+
+| FRD Section | FrdData Field | Extraction |
+|-------------|---------------|------------|
+| Section 1: Overview | `overview.objective` | Functional objective text |
+| Section 1: Overview | `overview.problem` | Problem statement |
+| Section 1: Overview | `overview.solution` | Solution statement |
+| Section 2: Use Cases | `useCases[]` | UC-XXX entries (id, name, actor, description, permission, priority) |
+| Section 3: Functional Requirements | `features[]` | FR-XXX entries grouped as features |
+| Section 5: Permission Matrix | `permissions[]` | Role-permission entries |
+| Section 6: Gherkin Scenarios | (used for test data, not doc) | - |
+| Section 7: Validations | `businessRules[]` | BR-XXX from BRD cross-referenced |
+
+### From BRD (2-business-requirements.md)
+
+| BRD Section | FrdData Field | Extraction |
+|-------------|---------------|------------|
+| Section 2: Business Objectives | `overview.stats` | Count objectives |
+| Section 3: Business Rules | `businessRules[]` | BR-XXX entries (id, name, category, statement) |
+| Section 6: Integrations | `technicalRef` | Integration notes |
+
+### From Handoff (4-development-handoff.md)
+
+| Handoff Section | FrdData Field | Extraction |
+|-----------------|---------------|------------|
+| Section 3: Files to Create | `technicalRef.entityNames` | Entity names |
+| Section 6: API Endpoints | `apiEndpoints[]` | Endpoint entries |
+| Section 1: Quick Context | `technicalRef.permissionBase` | Permission base path |
+| Section 1: Quick Context | `technicalRef.controllerRoute` | Controller route |
+
+### Generated/Inferred Fields
+
+| Field | Source |
+|-------|--------|
+| `featureId` | From 00-context.md state |
+| `moduleName` | From 00-context.md state |
+| `applicationName` | From 00-context.md state |
+| `version` | "1.0" (initial) |
+| `benefits[]` | Inferred from BRD objectives or i18n |
+| `beforeAfter` | Inferred from discovery problem/solution |
+| `steps[]` | Inferred from use cases main scenario |
+| `faq[]` | Inferred from discovery open questions |
+| `screenshots` | Convention: `/assets/docs/{module}/step-{N}.png` |
+
+## Generated File Structure
+
+### frd-data.ts (per module, ~50-80 lines)
+
+```typescript
+// web/smartstack-web/src/pages/docs/business/{app}/{module}/frd-data.ts
+import type { FrdData } from '@/components/docs';
+
+export const frdData: FrdData = {
+  featureId: 'FEAT-001',
+  moduleName: 'Sla',
+  applicationName: 'Support',
+  version: '1.0',
+
+  overview: {
+    objective: 'docs.support.sla.overview.objective',
+    problem: 'docs.support.sla.overview.problem',
+    solution: 'docs.support.sla.overview.solution',
+    stats: { useCases: 4, businessRules: 6, permissions: 5, endpoints: 5 },
+  },
+
+  useCases: [
+    { id: 'UC-001', name: 'Create SLA', actor: 'Admin', description: '...', permission: 'business.support.sla.create', priority: 'Must' },
+    // ...
+  ],
+
+  benefits: [
+    { icon: 'time', titleKey: 'docs.support.sla.benefits.time.title', value: '-70%', descriptionKey: 'docs.support.sla.benefits.time.description' },
+    { icon: 'quality', titleKey: 'docs.support.sla.benefits.quality.title', value: '+95%', descriptionKey: 'docs.support.sla.benefits.quality.description' },
+    { icon: 'roi', titleKey: 'docs.support.sla.benefits.roi.title', value: '3x', descriptionKey: 'docs.support.sla.benefits.roi.description' },
+  ],
+
+  beforeAfter: {
+    beforeItems: ['Manual SLA tracking', 'No escalation alerts', 'No compliance visibility', 'Scattered data'],
+    afterItems: ['Automated SLA monitoring', 'Real-time escalation', 'Compliance dashboard', 'Centralized metrics'],
+  },
+
+  features: [
+    { id: 'F-001', title: 'SLA Configuration', description: '...', example: '...' },
+    // ...
+  ],
+
+  steps: [
+    { number: 1, title: 'Navigate to SLA module', description: '...', screenshotKey: 'step1' },
+    { number: 2, title: 'Create SLA policy', description: '...', screenshotKey: 'step2' },
+    // ...
+  ],
+
+  faq: [
+    { questionKey: 'docs.support.sla.faq.1.question', answerKey: 'docs.support.sla.faq.1.answer' },
+    // ...
+  ],
+
+  businessRules: [
+    { id: 'BR-001', name: 'SLA Time Calculation', category: 'Calculation', statement: '...' },
+    // ...
+  ],
+
+  permissions: [
+    { path: 'business.support.sla.read', description: 'View SLA policies', roles: ['Admin', 'Manager', 'User', 'ReadOnly'] },
+    { path: 'business.support.sla.create', description: 'Create SLA policies', roles: ['Admin', 'Manager'] },
+    // ...
+  ],
+
+  apiEndpoints: [
+    { method: 'GET', path: '/api/business/sla', handler: 'GetAllSlaQuery', permission: '.read' },
+    { method: 'POST', path: '/api/business/sla', handler: 'CreateSlaCommand', permission: '.create' },
+    // ...
+  ],
+
+  screenshots: {
+    step1: '/assets/docs/sla/step-1.png',
+    step2: '/assets/docs/sla/step-2.png',
+  },
+
+  technicalRef: {
+    permissionBase: 'business.support.sla',
+    controllerRoute: 'business.support.sla',
+    entityNames: ['Sla', 'SlaPolicy', 'SlaEscalation'],
+  },
+};
+```
+
+### Page wrapper (per module, ~10 lines)
+
+```typescript
+// web/smartstack-web/src/pages/docs/business/{app}/{module}/index.tsx
+import { FrdDocRenderer } from '@/components/docs';
+import { frdData } from './frd-data';
+
+export default function {Module}DocPage() {
+  return (
+    <FrdDocRenderer
+      data={frdData}
+      backPath="/docs/business/{app}"
+      backLabel="nav.backToApp"
+    />
+  );
+}
+```
+
+### i18n file (FR source, ~30 lines)
+
+```json
+// web/smartstack-web/src/i18n/locales/fr/docs-{app}-{module}.json
+{
+  "support": {
+    "sla": {
+      "overview": {
+        "objective": "Gestion des niveaux de service (SLA)",
+        "problem": "Les engagements de service ne sont pas suivis, les escalades sont manuelles",
+        "solution": "Monitoring automatique des SLA avec alertes et escalades configurables"
+      },
+      "benefits": {
+        "time": { "title": "Temps économisé", "description": "Réduction de 70% du temps de suivi manuel" },
+        "quality": { "title": "Fiabilité", "description": "95% des SLA respectés grâce au monitoring" },
+        "roi": { "title": "ROI", "description": "Retour sur investissement en 3 mois" }
+      },
+      "faq": {
+        "1": {
+          "question": "Dois-je configurer chaque SLA manuellement ?",
+          "answer": "Non, des templates prédéfinis sont disponibles pour les cas courants."
+        }
+      }
+    }
+  }
+}
+```
+
+> **Note:** Seul FR est généré. EN/IT/DE sont marqués comme "deferred" et générés par un pipeline de traduction séparé.
+
+## Screenshot Convention
+
+| Key | Path | Description |
+|-----|------|-------------|
+| `step{N}` | `/assets/docs/{module}/step-{N}.png` | Step-by-step guide screenshots |
+| `overview` | `/assets/docs/{module}/overview.png` | Module overview screenshot |
+| `dashboard` | `/assets/docs/{module}/dashboard.png` | Dashboard view |
+
+Screenshots are added manually or via Playwright E2E tests.
+The `FrdDocRenderer` shows a "Screenshot à venir" placeholder when the image file is not found.

package/templates/skills/documentation/templates.md

@@ -22,7 +22,36 @@ Chaque documentation de module DOIT inclure ces sections dans cet ordre:
 
 ---
 
-## Template User Module (Business-First)
+## Data-Driven Approach (Recommended)
+
+> **Principe:** Au lieu de générer un composant TSX complet (~250 lignes) par module,
+> générer uniquement un fichier de DONNÉES (`frd-data.ts`, ~50 lignes) + un wrapper minimal.
+> Le rendu est assuré par le composant partagé `FrdDocRenderer` dans `web/.../components/docs/`.
+
+### Fichiers à générer par module
+
+**1. Data file** (`frd-data.ts`) : Voir [data-schema.md](data-schema.md) pour le mapping complet.
+
+**2. Page wrapper** (`index.tsx`, ~10 lignes) :
+```tsx
+import { FrdDocRenderer } from '@/components/docs';
+import { frdData } from './frd-data';
+
+export default function {ModuleName}DocPage() {
+  return <FrdDocRenderer data={frdData} backPath="/docs/business/{app}" />;
+}
+```
+
+**3. i18n FR uniquement** : Générer la langue source (FR). EN/IT/DE sont déférés.
+
+> **Screenshots:** Chemins conventionnels `/assets/docs/{module}/step-{N}.png`.
+> Le renderer affiche un placeholder "Screenshot à venir" si l'image n'existe pas.
+
+---
+
+## Legacy: Template TSX Complet (référence)
+
+> **Déprécié:** Conservé pour référence. Utilisez l'approche data-driven ci-dessus.
 
 ```tsx
 // web/smartstack-web/src/pages/docs/user/{ModuleName}DocPage.tsx

package/templates/skills/gitflow/_shared.md

@@ -45,12 +45,113 @@ normalize_branch_name() {
 
 ---
 
+## RESOLVE_CONFIG_PATH
+
+Resolves the config.json path regardless of current working directory.
+Searches in: pwd, develop worktree, then git root.
+
+```bash
+resolve_gitflow_config_path() {
+  # 1. Try current directory
+  [ -f ".claude/gitflow/config.json" ] && { echo ".claude/gitflow/config.json"; return 0; }
+
+  # 2. Try to find develop worktree from git worktree list
+  local DEVELOP_PATH
+  DEVELOP_PATH=$(git worktree list --porcelain 2>/dev/null | grep -A1 "branch refs/heads/develop" | grep "^worktree " | sed 's/^worktree //')
+  [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.claude/gitflow/config.json" ] && {
+    echo "$DEVELOP_PATH/.claude/gitflow/config.json"
+    return 0
+  }
+
+  # 3. Try git toplevel
+  local GIT_ROOT
+  GIT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
+  [ -n "$GIT_ROOT" ] && [ -f "$GIT_ROOT/.claude/gitflow/config.json" ] && {
+    echo "$GIT_ROOT/.claude/gitflow/config.json"
+    return 0
+  }
+
+  return 1
+}
+```
+
+---
+
+## READ_GITFLOW_CONFIG
+
+Reads GitFlow configuration from config.json. Exposes all variables needed by steps and phases.
+
+```bash
+read_gitflow_config() {
+  local CONFIG_FILE
+  CONFIG_FILE=$(resolve_gitflow_config_path) || {
+    echo "❌ GitFlow config not found. Run /gitflow init first."
+    return 1
+  }
+
+  # Repository
+  GF_PROJECT_NAME=$(grep -oP '"name":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_ROOT_FOLDER=$(grep -oP '"rootFolder":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_REMOTE_URL=$(grep -oP '"remoteUrl":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+
+  # Git provider and branches
+  GF_PROVIDER=$(grep -oP '"provider":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_MAIN_BRANCH=$(grep -oP '"main":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_DEVELOP_BRANCH=$(grep -oP '"develop":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+
+  # Prefixes
+  GF_FEATURE_PREFIX=$(grep -oP '"feature":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_RELEASE_PREFIX=$(grep -oP '"release":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_HOTFIX_PREFIX=$(grep -oP '"hotfix":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+
+  # Worktrees
+  GF_WORKTREE_MODE=$(grep -oP '"mode":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_MAIN_PATH=$(grep -A1 '"structure"' "$CONFIG_FILE" | grep -oP '"main":\s*"\K[^"]+' | head -1)
+  GF_DEVELOP_PATH=$(grep -A2 '"structure"' "$CONFIG_FILE" | grep -oP '"develop":\s*"\K[^"]+' | head -1)
+  GF_FEATURES_PATH=$(grep -oP '"features":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_RELEASES_PATH=$(grep -oP '"releases":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_HOTFIXES_PATH=$(grep -oP '"hotfixes":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+
+  # Language
+  GF_LANG=$(grep -oP '"code":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+
+  # Versioning
+  GF_VERSION=$(grep -oP '"current":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+  GF_TAG_PREFIX=$(grep -oP '"tagPrefix":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+
+  # Defaults for missing values
+  GF_LANG=${GF_LANG:-en}
+  GF_WORKTREE_MODE=${GF_WORKTREE_MODE:-organized}
+  GF_MAIN_BRANCH=${GF_MAIN_BRANCH:-main}
+  GF_DEVELOP_BRANCH=${GF_DEVELOP_BRANCH:-develop}
+  GF_FEATURE_PREFIX=${GF_FEATURE_PREFIX:-feature/}
+  GF_RELEASE_PREFIX=${GF_RELEASE_PREFIX:-release/}
+  GF_HOTFIX_PREFIX=${GF_HOTFIX_PREFIX:-hotfix/}
+  GF_TAG_PREFIX=${GF_TAG_PREFIX:-v}
+  GF_VERSION=${GF_VERSION:-0.1.0}
+
+  # Export config file path for steps that need to update it
+  GF_CONFIG_FILE="$CONFIG_FILE"
+}
+```
+
+---
+
 ## DETECT_WORKTREE_MODE
 
-Detects worktree mode (organized, adjacent, none).
+Detects worktree mode. Reads config first, falls back to filesystem detection.
 
 ```bash
 detect_worktree_mode() {
+  # 1. Try config first (authoritative)
+  local CONFIG_FILE
+  CONFIG_FILE=$(resolve_gitflow_config_path 2>/dev/null)
+  if [ -n "$CONFIG_FILE" ] && [ -f "$CONFIG_FILE" ]; then
+    WORKTREE_MODE=$(grep -oP '"mode":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
+    [ -n "$WORKTREE_MODE" ] && return 0
+  fi
+
+  # 2. Fallback: filesystem detection
   if [ -d "../features" ] && [ -d "../releases" ] && [ -d "../hotfixes" ]; then
     WORKTREE_MODE="organized"
   elif [ -d "../01-Main" ] && [ -d "../02-Develop" ]; then
@@ -58,9 +159,7 @@ detect_worktree_mode() {
   elif [ -d "../worktrees" ]; then
     WORKTREE_MODE="adjacent"
   else
-    CONFIG_FILE=".claude/gitflow/config.json"
-    [ -f "$CONFIG_FILE" ] && WORKTREE_MODE=$(grep -oP '"mode":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
-    WORKTREE_MODE=${WORKTREE_MODE:-adjacent}
+    WORKTREE_MODE="organized"
   fi
 }
 ```
@@ -69,26 +168,30 @@ detect_worktree_mode() {
 
 ## CLEANUP_WORKTREE
 
-Cleans up a worktree for a given branch.
+Cleans up a worktree for a given branch. Uses config paths when available.
 
 ```bash
 cleanup_worktree_for_branch() {
-  local BRANCH=$1 WORKTREE_BASE="../worktrees" WORKTREE_PATH=""
-
-  case "$BRANCH" in
-    feature/*) WORKTREE_PATH="$WORKTREE_BASE/features/${BRANCH#feature/}" ;;
-    release/*) WORKTREE_PATH="$WORKTREE_BASE/releases/${BRANCH#release/}" ;;
-    hotfix/*)  WORKTREE_PATH="$WORKTREE_BASE/hotfixes/${BRANCH#hotfix/}" ;;
-  esac
-
-  # Organized mode
-  [ -d "../features" ] && case "$BRANCH" in
-    feature/*) WORKTREE_PATH="../features/${BRANCH#feature/}" ;;
-    release/*) WORKTREE_PATH="../releases/${BRANCH#release/}" ;;
-    hotfix/*)  WORKTREE_PATH="../hotfixes/${BRANCH#hotfix/}" ;;
-  esac
-
-  [ -d "$WORKTREE_PATH" ] && {
+  local BRANCH=$1 WORKTREE_PATH=""
+
+  # Try config-based paths first (absolute, reliable)
+  read_gitflow_config 2>/dev/null
+  if [ -n "$GF_FEATURES_PATH" ]; then
+    case "$BRANCH" in
+      feature/*) WORKTREE_PATH="$GF_FEATURES_PATH/${BRANCH#feature/}" ;;
+      release/*) WORKTREE_PATH="$GF_RELEASES_PATH/${BRANCH#release/}" ;;
+      hotfix/*)  WORKTREE_PATH="$GF_HOTFIXES_PATH/${BRANCH#hotfix/}" ;;
+    esac
+  else
+    # Fallback: relative paths
+    case "$BRANCH" in
+      feature/*) WORKTREE_PATH="../features/${BRANCH#feature/}" ;;
+      release/*) WORKTREE_PATH="../releases/${BRANCH#release/}" ;;
+      hotfix/*)  WORKTREE_PATH="../hotfixes/${BRANCH#hotfix/}" ;;
+    esac
+  fi
+
+  [ -n "$WORKTREE_PATH" ] && [ -d "$WORKTREE_PATH" ] && {
     git worktree remove "$WORKTREE_PATH" --force 2>/dev/null || rm -rf "$WORKTREE_PATH"
     git worktree prune
     echo "✓ Worktree cleaned: $WORKTREE_PATH"
@@ -116,47 +219,79 @@ sync_with_remote() {
 
 ---
 
-## READ_GITFLOW_CONFIG
-
-Reads GitFlow configuration.
-
-```bash
-read_gitflow_config() {
-  local CONFIG_FILE=".claude/gitflow/config.json"
-  [ ! -f "$CONFIG_FILE" ] && return 1
-
-  # Exported variables
-  GF_LANG=$(grep -oP '"code":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
-  GF_WORKTREE_MODE=$(grep -oP '"mode":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
-  GF_MAIN_BRANCH=$(grep -oP '"main":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
-  GF_DEVELOP_BRANCH=$(grep -oP '"develop":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
-
-  GF_LANG=${GF_LANG:-en}
-  GF_WORKTREE_MODE=${GF_WORKTREE_MODE:-adjacent}
-  GF_MAIN_BRANCH=${GF_MAIN_BRANCH:-main}
-  GF_DEVELOP_BRANCH=${GF_DEVELOP_BRANCH:-develop}
-}
-```
-
----
-
 ## CONFIG_TEMPLATE
 
-GitFlow configuration JSON template (minimal version).
+GitFlow configuration JSON template v2.0.0 (aligned with `templates/config.json`).
 
 ```json
 {
-  "version": "1.3.0",
-  "branches": { "main": "main", "develop": "develop" },
-  "prefixes": { "feature": "feature/", "release": "release/", "hotfix": "hotfix/" },
-  "worktrees": { "mode": "organized" },
-  "language": { "code": "en" }
+  "version": "2.0.0",
+  "repository": {
+    "name": "",
+    "rootFolder": "",
+    "nameVariants": {
+      "pascalCaseDot": "",
+      "pascalCase": "",
+      "kebabCase": "",
+      "snakeCase": "",
+      "displayName": ""
+    },
+    "defaultBranch": "main",
+    "remoteUrl": ""
+  },
+  "git": {
+    "provider": "",
+    "branches": {
+      "main": "main",
+      "develop": "develop"
+    },
+    "prefixes": {
+      "feature": "feature/",
+      "release": "release/",
+      "hotfix": "hotfix/"
+    }
+  },
+  "worktrees": {
+    "enabled": true,
+    "mode": "organized",
+    "structure": {
+      "main": "",
+      "develop": "",
+      "features": "",
+      "releases": "",
+      "hotfixes": ""
+    }
+  },
+  "versioning": {
+    "strategy": "semver",
+    "current": "0.1.0",
+    "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": "en"
+  }
 }
 ```
 
 **worktrees.mode options:**
-- `organized`: `../features/`, `../releases/`, `../hotfixes/`
-- `adjacent`: `../worktrees/{type}/`
+- `organized`: Uses absolute paths from config (`structure.features`, etc.)
+- `adjacent`: `{rootFolder}/worktrees/{type}/`
 - `disabled`: No worktrees
 
 ---