@atlashub/smartstack-cli 4.18.0 → 4.20.0

package/templates/skills/business-analyse/steps/step-05-deploy.md

@@ -0,0 +1,220 @@
+---
+name: step-05-deploy
+description: Deploy interactive HTML document from analysis data
+model: sonnet
+next_step: steps/step-06-review.md
+---
+
+> **Context files:** `_shared.md` | `references/html-data-mapping.md`
+
+# Step 5: Deploy - Interactive HTML Document
+
+## MANDATORY EXECUTION RULES
+
+- **ALWAYS** verify PRD exists before proceeding (`.ralph/prd-{module}.json`)
+- **ALWAYS** pre-populate HTML with FEATURE_DATA + EMBEDDED_ARTIFACTS (no empty templates)
+- **FEATURE_DATA.moduleSpecs** must have ONE entry per module (empty = BROKEN)
+- **FEATURE_DATA.cadrage.scope** uses HTML keys (vital/important/optional/excluded)
+- **ALWAYS** deploy SINGLE interactive HTML (multi-app or single-app per config)
+
+## YOUR TASK
+
+Deploy the single interactive HTML document pre-populated with all analysis data across all modules and applications. PRD and handoff data must already exist (generated by `/derive-prd`).
+
+---
+
+## EXECUTION SEQUENCE
+
+### 1. Verify PRD Exists
+
+For each module, verify PRD file exists:
+
+```
+FOR each module in modules:
+  prdPath = ".ralph/prd-{moduleCode}.json"
+  IF NOT exists(prdPath):
+    BLOCKING ERROR: "PRD not found: {prdPath} — Run /derive-prd first"
+    STOP
+  IF fileSize(prdPath) < 100:
+    BLOCKING ERROR: "PRD file too small: {prdPath} — Run /derive-prd to regenerate"
+    STOP
+```
+
+Verify consolidation status:
+
+```
+IF workflow.mode === "project":
+  projectFeature = ba-reader.findProjectFeature()
+  FOR each app in projectFeature.applications:
+    appFeature = ba-reader.findFeature(app.featureJsonPath)
+    IF appFeature.status !== "consolidated":
+      BLOCKING ERROR: "Application {app.code} not consolidated"
+ELSE:
+  feature = ba-reader.findFeature({feature_id})
+  IF feature.status !== "consolidated":
+    BLOCKING ERROR: "Feature status: {feature.status}, expected consolidated"
+```
+
+Display:
+```
+PRD verified: {module_count} modules
+  .ralph/prd-{module1}.json ({size} bytes)
+  .ralph/prd-{module2}.json ({size} bytes)
+→ Proceeding to HTML generation...
+```
+
+---
+
+### 2. Build FEATURE_DATA Object
+
+Read from index.json (master module JSON files):
+
+For EACH module:
+- Read complete index.json for each module
+- Map to FEATURE_DATA structure per `references/html-data-mapping.md`
+
+**FEATURE_DATA structure:**
+- metadata (analysisMode="interactive", workflowMode, versions, timestamps)
+- cadrage (scope using HTML keys: vital/important/optional/excluded; objectives, constraints, assumptions)
+- modules[] (all modules with all fields from index.json)
+- moduleSpecs{} (one entry PER module with analysis, specification sections from index.json)
+- consolidation (cross-module interactions)
+- handoff (complexity, filesToCreate summary, totalFiles, totalTasks)
+
+**Critical requirements:**
+- moduleSpecs MUST have ONE entry per module (empty = BUG)
+- cadrage.scope converts: mustHave->vital, shouldHave->important, couldHave->optional, outOfScope->excluded
+- metadata.analysisMode from master.metadata.analysisMode (always "interactive")
+- PROJECT MODE: include applications[], consolidation.crossApplicationInteractions
+
+---
+
+### 3. Build EMBEDDED_ARTIFACTS Object
+
+Collect from FEATURE_DATA:
+- **wireframes**: Per-module ASCII + SVG (if generated) — fields: format, content, svgContent
+- **e2eFlows**: E2E diagrams from consolidated.e2eFlows
+- **dependencyGraph**: From dependencyGraph section
+
+**Field name mapping (CRITICAL):**
+- wireframes use: `format`, `content`, `svgContent` (NOT mockupFormat/mockup)
+
+---
+
+### 4. Generate SVG Wireframes (Parallel, Optional)
+
+> **After EMBEDDED_ARTIFACTS built but BEFORE HTML write.**
+> This step is NEVER blocking — ASCII-only wireframes acceptable.
+> **Reference:** Read `references/wireframe-svg-style-guide.md` for full agent prompt template
+
+1. Collect all wireframes where `mockup` exists and `svgContent` is null
+2. Spawn parallel Task(sonnet) agents — ONE per wireframe
+3. Validate results: strip markdown fences, verify SVG syntax
+4. Inject valid SVGs into `EMBEDDED_ARTIFACTS.wireframes[moduleCode][index].svgContent`
+5. Display: "SVG wireframe generation: {successCount}/{total} generated, {failCount} fallback (ASCII)"
+
+---
+
+### 5. Replace Placeholders & Write HTML
+
+1. Read HTML template from skill: `html/ba-interactive.html`
+2. Serialize FEATURE_DATA and EMBEDDED_ARTIFACTS as JSON (2-space indent)
+3. Replace 8 placeholders:
+   - `{{FEATURE_DATA}}` — Full FEATURE_DATA JSON object
+   - `{{EMBEDDED_ARTIFACTS}}` — Wireframes, E2E, dependency graph
+   - `{{APPLICATION_NAME}}` — From master.metadata.application
+   - Others per template
+
+4. **Output path:**
+   - Multi-app (project mode): `docs/business-analyse/v{version}/ba-interactive.html`
+   - Single-app: `docs/{app}/business-analyse/v{version}/ba-interactive.html`
+
+5. Write to file
+
+---
+
+### 6. Verify Deployment
+
+**POST-CHECK (BLOCKING):**
+
+1. **File size > 100KB** (indicates pre-populated)
+   ```
+   if [ $(stat --format=%s ba-interactive.html) -lt 100000 ]; then
+     BLOCKING_ERROR("ba-interactive.html not pre-populated")
+   fi
+   ```
+
+2. **moduleSpecs present in HTML** (must be serialized)
+   ```
+   if ! grep -q '"moduleSpecs"' ba-interactive.html; then
+     BLOCKING_ERROR("moduleSpecs not found — FEATURE_DATA not serialized")
+   fi
+   ```
+
+3. **cadrage.scope uses HTML keys** (vital/important/optional/excluded)
+   ```
+   if grep -q '"mustHave"' ba-interactive.html; then
+     BLOCKING_ERROR("cadrage.scope still has JSON keys")
+   fi
+   ```
+
+4. **Wireframe field names correct** (format/content, NOT mockupFormat/mockup)
+   ```
+   if grep -q '"mockupFormat"' ba-interactive.html; then
+     BLOCKING_ERROR("Wireframes use 'mockupFormat' — must be 'format'")
+   fi
+   ```
+
+5. **All modules have specs AND wireframes**
+   ```
+   FOR each module in FEATURE_DATA.modules:
+     IF FEATURE_DATA.moduleSpecs[module.code] undefined:
+       BLOCKING_ERROR("Module not in moduleSpecs")
+     IF EMBEDDED_ARTIFACTS.wireframes[module.code] undefined:
+       BLOCKING_ERROR("Module not in wireframes")
+   ```
+
+---
+
+### 7. Display Completion Summary
+
+```
+══════════════════════════════════════════════════════════════
+  [OK] HTML DEPLOY COMPLETE — {application_name}
+══════════════════════════════════════════════════════════════
+
+Modules: {count} ({names})
+
+[DIR] Artifact generated:
+  ba-interactive.html — Interactive document
+     Path: {output_path}
+     Pre-populated: {module_count} modules, {total_uc} use cases,
+       {total_br} business rules, {total_wireframes} wireframes
+
+[NEXT] Review & Validation:
+  1. Open ba-interactive.html in browser
+  2. Review all modules, use cases, business rules
+  3. Validate wireframes and permissions
+  4. If OK: /derive-prd then /ralph-loop to begin development
+  5. If changes needed: /business-analyse to iterate
+
+══════════════════════════════════════════════════════════════
+```
+
+---
+
+## SELF-VERIFICATION (BEFORE COMPLETION)
+
+1. `ba-interactive.html` exists and >100KB
+2. FEATURE_DATA.moduleSpecs has entries for ALL modules
+3. cadrage.scope uses HTML keys (vital/important/optional/excluded)
+4. Wireframes use format/content fields (not mockupFormat/mockup)
+5. POST-CHECK verification all passed
+
+**IF any check fails -> generate missing artifact before completing.**
+
+---
+
+## NEXT STEP
+
+Load: `steps/step-06-review.md`

package/templates/skills/business-analyse/steps/step-06-review.md

@@ -19,17 +19,15 @@ Apply corrections exported from the interactive HTML review (`ba-review.json`) t
 ## Flow
 
 1. Read and validate ba-review.json
-2. Read existing master feature.json
+2. Read existing master index.json and version directory
 3. Create new version
 4. Apply cadrage corrections (reverse mapping)
 5. Apply module corrections
 6. Apply consolidation corrections
 7. Preserve review comments
-8. Regenerate PRD
-9. Regenerate progress.txt
-10. Update manifest
-11. Regenerate HTML
-12. Display completion summary
+8. Regenerate HTML
+9. Update manifest
+10. Display completion summary
 
 ---
 
@@ -55,13 +53,14 @@ source_version: _reviewMeta.sourceVersion
 change_summary: _reviewMeta.changeSummary
 ```
 
-## Step 2: Read Existing Master Feature.json
+## Step 2: Read Existing Master Index.json
 
 ```
-1. Locate master feature.json from docs_dir
+1. Locate master index.json from docs_dir (e.g., docs/{app}/business-analyse/v{X.Y}/index.json)
 2. Read and parse
-3. Verify metadata.application matches _reviewMeta.sourceApplicationId
-4. Store as existing_master
+3. Verify metadata.applicationId matches _reviewMeta.sourceApplicationId
+4. Store as existing_master_index
+5. Read all thematic files referenced in index.json (cadrage.json, entities.json, rules.json, etc.)
 ```
 
 ## Step 3: Create New Version
@@ -81,17 +80,17 @@ Call ba-writer.createVersion(existing_master.id, "Review corrections applied fro
 ```yaml
 new_version: string (e.g., "1.1" or "2.0")
 new_docs_dir: path to new version directory
-new_master_path: path to new master feature.json
+new_version_dir: path to new version directory (contains index.json + thematic files)
 ```
 
 ## Step 4: Apply Cadrage Corrections
 
 > **Reference:** `references/review-data-mapping.md` for exact field mapping
 
-Read the new master feature.json and apply reverse mapping from review data:
+Read the new version's cadrage.json and apply reverse mapping from review data:
 
 ```
-1. Scope mapping (review → feature.json):
+1. Scope mapping (review → cadrage.json):
    - cadrage.scope.vital[] → cadrage.globalScope.mustHave[]
    - cadrage.scope.important[] → cadrage.globalScope.shouldHave[]
    - cadrage.scope.optional[] → cadrage.globalScope.couldHave[]
@@ -119,33 +118,34 @@ Read the new master feature.json and apply reverse mapping from review data:
 5. Acceptance criteria:
    - cadrage.success.definition → cadrage.acceptanceCriteria[] (split by newline, generate AC-NNN IDs)
 
-Call ba-writer.enrichSection(new_master.id, "cadrage", updated_cadrage)
+Update cadrage.json with corrected data and update its hash in index.json
 ```
 
 ## Step 5: Apply Module Corrections
 
 ```
 FOR EACH moduleCode in review_data.moduleSpecifications:
-  1. Check if module exists in current master.modules[]
+  1. Check if module exists in current index.json.modules[]
      - If NEW module (in change_summary.modulesAdded):
-       a. Add to master.modules[] with metadata from review
-       b. Create module directory and feature.json via ba-writer.create(scope:"module")
+       a. Add to index.json.modules[] with metadata from review
+       b. Create module directory and entities.json, rules.json, usecases.json, etc. via ba-writer
      - If REMOVED module (in change_summary.modulesRemoved):
-       a. Mark module status as "removed" in master (do NOT delete files)
+       a. Mark module status as "removed" in index.json (do NOT delete files)
      - If EXISTING module:
-       a. Read module feature.json
+       a. Update module's thematic files
 
   2. Reverse-map module specification data:
-     - review.useCases[] → specification.useCases[]
+     - review.useCases[] → usecases.json.useCases[]
        (name→name, actor→primaryActor, steps→mainScenario (split by \n), alternative→alternativeScenarios)
-     - review.businessRules[] → analysis.businessRules[]
+     - review.businessRules[] → rules.json.businessRules[]
        (name→name, category→category, statement→statement, example→examples[])
-     - review.entities[] → analysis.entities[]
+     - review.entities[] → entities.json.entities[]
        (name→name, description→description, attributes→attributes, relationships→relationships)
-     - review.permissions[] → specification.permissionMatrix
+     - review.permissions[] → permissions.json.permissionMatrix
        (reverse "Role|Action" format → {permissions[], roleAssignments[]})
 
-  3. Write updated module feature.json via ba-writer.enrichSection()
+  3. Update each module's thematic files via ba-writer.enrichSection()
+  4. Update hashes in index.json for modified files
 ```
 
 ## Step 6: Apply Consolidation Corrections
@@ -153,19 +153,19 @@ FOR EACH moduleCode in review_data.moduleSpecifications:
 ```
 IF review_data.consolidation exists:
   1. Reverse-map interactions:
-     - consolidation.interactions[] → consolidation.crossModuleInteractions[]
+     - consolidation.interactions[] → consolidation.json.crossModuleInteractions[]
        (from→fromModule, to→toModule, description→description)
 
   2. Reverse-map E2E flows:
-     - consolidation.e2eFlows[] → consolidation.e2eFlows[]
+     - consolidation.e2eFlows[] → consolidation.json.e2eFlows[]
        (name→name, steps→steps, actors preserved)
 
-  Call ba-writer.enrichSection(new_master.id, "consolidation", updated_consolidation)
+  3. Update consolidation.json and update hash in index.json
 ```
 
 ## Step 7: Preserve Review Comments
 
-Store all review feedback in a new `review` section of the master feature.json:
+Store all review feedback in a new review.json file:
 
 ```
 review_section = {
@@ -177,58 +177,41 @@ review_section = {
   changeSummary: change_summary
 }
 
-Call ba-writer.enrichSection(new_master.id, "review", review_section)
+Create review.json with review_section and update hash in index.json
 ```
 
-## Step 8: Regenerate PRD
-
-```
-FOR EACH module in master.modules[] WHERE status != "removed":
-  Run: ss derive-prd --application {new_master_path} --module {moduleCode}
-  Verify: .ralph/prd-{moduleCode}.json exists and has filesToCreate
-```
-
-> `ss derive-prd` is a deterministic CLI command (no LLM), safe for regeneration.
-
-## Step 9: Regenerate progress.txt
-
-```
-Write .ralph/progress.txt with:
-- Link to new master feature.json
-- Link to each module feature.json
-- Link to ba-interactive.html (new version)
-- Summary of review changes applied
-```
-
-## Step 10: Update Manifest
-
-```
-1. Read docs/index.json
-2. Find entry for this application
-3. Update version, lastModified, status
-4. If entry doesn't exist, create it
-5. Write docs/index.json
-```
-
-## Step 11: Regenerate Interactive HTML
+## Step 8: Regenerate Interactive HTML
 
 > **Reference:** `references/html-data-mapping.md` for FEATURE_DATA and EMBEDDED_ARTIFACTS mapping
 
 ```
 1. Read ba-interactive.html template from skill templates
-2. Build FEATURE_DATA from NEW master + module feature.json files
+2. Build FEATURE_DATA from NEW version:
+   - Read index.json for metadata
+   - Read cadrage.json for cadrage section
+   - Read entities.json, rules.json, usecases.json, etc.
    (follow exact mapping from html-data-mapping.md)
-3. Build EMBEDDED_ARTIFACTS from NEW module feature.json files
+3. Build EMBEDDED_ARTIFACTS from thematic files
    (wireframes, e2eFlows, dependencyGraph)
 4. Replace placeholders:
    - {{FEATURE_DATA}} → serialized FEATURE_DATA JSON
    - {{EMBEDDED_ARTIFACTS}} → serialized EMBEDDED_ARTIFACTS JSON
    - {{APPLICATION_NAME}} → application_name
    - {{APPLICATION_ID}} → feature_id
-5. Write to new version directory: {new_docs_dir}/ba-interactive.html
+5. Write to new version directory: {new_version_dir}/ba-interactive.html
+```
+
+## Step 9: Update Manifest
+
+```
+1. Read docs/index.json
+2. Find entry for this application
+3. Update version, lastModified, status
+4. If entry doesn't exist, create it
+5. Write docs/index.json
 ```
 
-## Step 12: Display Completion Summary
+## Step 10: Display Completion Summary
 
 ```
 ═══════════════════════════════════════════════════════════════
@@ -254,10 +237,9 @@ Changes applied:
 Artifacts regenerated:
 | Artifact             | Path                                 |
 |----------------------|--------------------------------------|
-| Master feature.json  | {new_master_path}                    |
-| ba-interactive.html  | {new_docs_dir}/ba-interactive.html   |
-| PRD files            | .ralph/prd-*.json                    |
-| progress.txt         | .ralph/progress.txt                  |
+| Master index.json    | {new_version_dir}/index.json         |
+| ba-interactive.html  | {new_version_dir}/ba-interactive.html|
+| Thematic files       | {new_version_dir}/*.json             |
 | Manifest             | docs/index.json                      |
 
 NEXT STEPS:
@@ -274,5 +256,5 @@ NEXT STEPS:
 | ba-review.json malformed | Display structure errors, STOP |
 | Source version mismatch | Warn but continue (corrections may still apply) |
 | Module not found for update | Skip module, warn user |
-| PRD generation fails | Warn but continue (can be re-run manually) |
+| HTML generation fails | Warn but continue (can be re-run manually) |
 | Manifest update fails | Warn but continue |

package/templates/skills/business-analyse/templates/tpl-frd.md

@@ -1,7 +1,7 @@
 # Template Functional Requirements Document
 
 > **Usage:** Template for 3-functional-specification.md
-> **Loaded in:** step-03a1-setup.md
+> **Loaded in:** step-03-specify.md
 
 ---
 

package/templates/skills/business-analyse/templates/tpl-handoff.md

@@ -1,7 +1,7 @@
 # Template Development Handoff
 
-> **Usage:** Template for step-04-handoff.md
-> **Data source:** feature.json (sections: metadata, analysis, specification, handoff)
+> **Usage:** Template for step-05-deploy.md
+> **Data source:** index.json (sections: metadata, analysis, specification, handoff)
 
 ---
 
@@ -10,8 +10,8 @@
 
 > **Module:** {application}/{module}
 > **Version:** {version}
-> **Validated Specs:** feature.json (validation.decision = APPROVED)
-> **Source:** `docs/{app}/{module}/business-analyse/v{version}/feature.json`
+> **Validated Specs:** index.json (validation.decision = APPROVED)
+> **Source:** `docs/{app}/{module}/business-analyse/v{version}/index.json`
 > **Implementation:** `/ralph-loop`
 
 ## DEVELOPER INSTRUCTIONS
@@ -39,6 +39,8 @@ This document is a self-contained prompt for Claude Code.
 | Table Prefix | `{prefix}_` |
 | Complexity | {feature.handoff.complexity} |
 
+> **Source:** Read from index.json
+
 ## 2. [EXPLORE] EXISTING PATTERNS
 
 BEFORE coding, explore these files to understand the patterns:
@@ -66,7 +68,7 @@ FRONTEND:
 
 ## 3. FILES TO CREATE
 
-> **Source:** `feature.handoff.filesToCreate[]` in feature.json
+> **Source:** `index.json.handoff.filesToCreate[]`
 
 ### 3.1 Backend
 
@@ -83,18 +85,18 @@ FRONTEND:
 
 ### 3.2 SeedData Core (CRITICAL -- without these, module is invisible and returns 403)
 
-> **Source:** `feature.json.specification.seedDataCore` (generated in step-02)
+> **Source:** `index.json.specification.seedDataCore` (generated in step-03)
 > **5 core files + NavigationSectionSeedData when sections are defined** for every new module.
 > Derive content EXACTLY from `specification.seedDataCore` sections (navigationModules, navigationSections, navigationTranslations, permissions, rolePermissions, permissionConstants).
 
-| # | File | Layer | Content |
-|---|------|-------|---------|
-| 1 | `NavigationModuleConfiguration.cs` | Infrastructure (HasData) | Module entry in `nav_Modules` |
-| 2 | `NavigationSectionSeedData.cs` | Infrastructure (HasData) | Section entries (list, dashboard, etc.) with full absolute routes. **MANDATORY when sections defined.** |
-| 3 | `NavigationTranslationConfiguration.cs` | Infrastructure (HasData) | 4 translations (fr, en, it, de) per nav entity |
-| 4 | `PermissionConfiguration.cs` | Infrastructure (HasData) | Wildcard + CRUD permissions in `nav_Permissions` |
-| 5 | `Permissions.cs` | Application (code) | Compile-time constants for `[RequirePermission]` |
-| 6 | `RolePermissionConfiguration.cs` | Infrastructure (HasData) | Role->Permission for {App} Admin, {App} Manager, {App} Contributor, {App} Viewer |
+| # | File | Layer | Content | Source |
+|---|------|-------|---------|--------|
+| 1 | `NavigationModuleConfiguration.cs` | Infrastructure (HasData) | Module entry in `nav_Modules` | index.json.specification.seedDataCore.navigationModules |
+| 2 | `NavigationSectionSeedData.cs` | Infrastructure (HasData) | Section entries (list, dashboard, etc.) with full absolute routes. **MANDATORY when sections defined.** | index.json.specification.seedDataCore.navigationSections |
+| 3 | `NavigationTranslationConfiguration.cs` | Infrastructure (HasData) | 4 translations (fr, en, it, de) per nav entity | index.json.specification.seedDataCore.navigationTranslations |
+| 4 | `PermissionConfiguration.cs` | Infrastructure (HasData) | Wildcard + CRUD permissions in `nav_Permissions` | index.json.specification.seedDataCore.permissions |
+| 5 | `Permissions.cs` | Application (code) | Compile-time constants for `[RequirePermission]` | index.json.specification.seedDataCore.permissionConstants |
+| 6 | `RolePermissionConfiguration.cs` | Infrastructure (HasData) | Role->Permission for {App} Admin, {App} Manager, {App} Contributor, {App} Viewer | index.json.specification.seedDataCore.rolePermissions |
 
 ### 3.3 Frontend
 
@@ -107,7 +109,7 @@ FRONTEND:
 
 ## 4. DETAILED SPECIFICATIONS
 
-> **Source:** Read from feature.json sections: `analysis.entities[]`, `specification.apiEndpoints[]`, `analysis.businessRules[]`, `specification.navigation`, `specification.permissionMatrix`
+> **Source:** Read from index.json sections: `analysis.entities[]`, `specification.apiEndpoints[]`, `analysis.businessRules[]`, `specification.sections[]`, `specification.permissionMatrix`
 
 ### 4.1 Entity
 
@@ -132,10 +134,11 @@ From: `feature.handoff.brToCodeMapping[]`
 
 ### 4.4 SeedData Specifications
 
-From: `feature.specification.seedDataCore` (5 core files), `feature.specification.navigation` and `feature.specification.permissionMatrix`
+From: `index.json.specification.seedDataCore` and `index.json.specification.permissionMatrix`
 
-> **IMPORTANT :** Les données des 5 fichiers SeedData Core doivent être dérivées de `specification.seedDataCore` :
+> **IMPORTANT :** Les données des 6 fichiers SeedData Core doivent être dérivées de `index.json.specification.seedDataCore` :
 > - `navigationModules` → NavigationModuleConfiguration.cs
+> - `navigationSections` → NavigationSectionSeedData.cs
 > - `navigationTranslations` → NavigationTranslationConfiguration.cs
 > - `permissions` → PermissionConfiguration.cs (module-level: `{app}.{module}.{action}`, section-level: `{app}.{module}.{section}.{action}`)
 > - `rolePermissions` → RolePermissionConfiguration.cs

package/templates/skills/business-analyse/templates/tpl-launch-displays.md

@@ -1,6 +1,6 @@
 # Skill Launch Display Templates (templates/tpl-launch-displays.md)
 
-> **Used by:** step-05b-deploy (Completion Summary)
+> **Used by:** step-05-deploy (Completion Summary)
 > **Purpose:** User-facing display templates for BA completion
 > **Note:** No emojis - uses text markers per Claude Code conventions
 
@@ -23,7 +23,7 @@ Complexity: {complexity}
 Effort:    {total_days} days ({total_hours} hours)
 
 [DIR] Artefacts générés:
-  ✓ feature.json (master + per-module) - spécification complète
+  ✓ index.json (master + per-module) - spécification complète
   ✓ .ralph/prd.json or .ralph/prd-{module}.json - task breakdown
   ✓ .ralph/progress.txt - tracker de progression
   ✓ ba-interactive.html - document de revue interactif

package/templates/skills/business-analyse/templates-react.md

@@ -51,7 +51,7 @@ import {
   Database
 } from 'lucide-react';
 
-// Types for documentation data
+// Types for documentation data (loaded from index.json)
 interface UseCase {
   id: string;
   name: string;
@@ -83,7 +83,7 @@ interface DocData {
   permissions: Permission[];
 }
 
-// Data loaded from feature.json (to be generated dynamically)
+// Data loaded from index.json (to be generated dynamically)
 const docData: DocData = {
   featureId: 'FEAT-XXX',
   moduleName: '{ModuleName}',

package/templates/skills/derive-prd/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: derive-prd
+description: "Transform consolidated business analysis into handoff data (8 categories) and PRD files for /ralph-loop consumption."
+model: sonnet
+user_invocable: true
+---
+
+# /derive-prd — v1
+
+## Purpose
+
+Bridge between `/business-analyse` (understand) and `/ralph-loop` (execute).
+Transforms consolidated BA data into structured handoff and PRD files.
+
+```
+/business-analyse  →  /derive-prd  →  /ralph-loop
+   (comprendre)        (planifier)      (executer)
+```
+
+## Architecture
+
+**3 steps** — "Validate, Transform, Export"
+
+| Step | File | Model | Role |
+|------|------|-------|------|
+| 00 | `step-00-validate.md` | Sonnet | Detect input, validate BA readiness, AC gate |
+| 01 | `step-01-transform.md` | Sonnet | Build handoff data per module (8 categories) |
+| 02 | `step-02-export.md` | Sonnet | Generate PRD files, verify, output progress |
+
+## Input
+
+- Consolidated BA feature (`status = "consolidated"`)
+- Source: `docs/{app}/{module}/business-analyse/v{X.Y}/index.json`
+- Usage: `--feature <path>` or auto-detection from `docs/`
+
+## Output
+
+| Artifact | Path | Description |
+|----------|------|-------------|
+| Handoff data | Written to module `handoff.json` via ba-writer | 8-category file mapping + BR-to-code + API summary |
+| PRD files | `.ralph/prd-{moduleCode}.json` | Deterministic extraction via `ss derive-prd` |
+| Progress tracker | `.ralph/progress.txt` | Task breakdown per module |
+| Module queue | `.ralph/modules-queue.json` | Topological order (if 2+ modules) |
+| BA manifest | `docs/index.json` | Updated with "handed-off" status |
+
+## Handoff Categories (8)
+
+| Category | Source | Key rules |
+|----------|--------|-----------|
+| **domain** | `analysis.entities[]` | Entities, ValueObjects, Enums |
+| **application** | `analysis.useCases[]` | Services, DTOs, Validators |
+| **infrastructure** | `analysis.entities[]` | EF Configurations, DbSet |
+| **api** | `specification.apiEndpoints[]` | Controllers (exact copy) |
+| **frontend** | `specification.uiWireframes[]` | Pages, Components, Hooks |
+| **seedData** | `specification.seedDataCore` | CORE + business |
+| **tests** | All layers | Unit, Integration, Security tests |
+| **documentation** | All layers | Technical docs, user guides, API specs |
+
+## Agents
+
+| Agent | Role | Operations |
+|-------|------|------------|
+| `ba-writer` | Write handoff data | enrichModuleHandoff() |
+| `ba-reader` | Read feature data | findFeature, readSection, getModuleStatus |
+
+## References
+
+| File | Content |
+|------|---------|
+| `references/prd-generation.md` | PRD v3.0 structure & validation rules |
+| `references/handoff-mappings.md` | BR-to-code & API summary mapping |
+| `references/handoff-seeddata-generation.md` | SeedData core generation reference |
+| `references/handoff-file-templates.md` | Handoff file structure (8 categories) |
+| `references/acceptance-criteria.md` | Module acceptance criteria (AC-01 to AC-17) |
+| `references/entity-domain-mapping.md` | Entity BA to Domain file mapping |
+| `references/readiness-scoring.md` | Readiness scoring algorithm |
+
+## Schema
+
+| File | Content |
+|------|---------|
+| `schemas/handoff-schema.json` | Handoff data schema (8 categories) |
+
+## Templates
+
+| File | Content |
+|------|---------|
+| `templates/tpl-progress.md` | Progress tracker template |
+
+## Entry Point
+
+**FIRST ACTION:** Load `steps/step-00-validate.md`