@atlashub/smartstack-cli 2.2.0 → 2.3.0

package/templates/skills/business-analyse/steps/step-04-handoff.md

@@ -139,179 +139,231 @@ User selects which agent to use in next step.
 
 ## 4. Map Specification to Files
 
-### 4.1 Backend File Mapping
+> **IMPORTANT :** Cette section génère `handoff.filesToCreate` comme un **objet structuré** avec 7 catégories.
+> Chaque fichier est un objet `{path, type, linkedFRs, linkedUCs}`. **PAS de texte libre.**
+> Les chemins doivent utiliser le namespace du projet (lire `.smartstack/config.json.baseNamespace`).
 
-For each entity in specification.entities[], document implementation files:
+### 4.1 Domain File Mapping
+
+For each entity in `specification.entities[]`, create domain files:
 
 ```json
 {
-  "fileMapping": {
-    "backend": [
+  "filesToCreate": {
+    "domain": [
       {
-        "entity": "Order",
-        "files": [
-          {
-            "path": "src/Domain/Entities/Order.cs",
-            "type": "Entity",
-            "linkedFRs": ["FR-001", "FR-002", "FR-003"]
-          },
-          {
-            "path": "src/Application/Services/OrderService.cs",
-            "type": "Service",
-            "linkedFRs": ["FR-001", "FR-002", "FR-003", "FR-004"]
-          },
-          {
-            "path": "src/API/Controllers/OrdersController.cs",
-            "type": "ApiController",
-            "endpoints": 6,
-            "linkedUCs": ["UC-001", "UC-002", "UC-003", "UC-004", "UC-005", "UC-006"]
-          },
-          {
-            "path": "src/Infrastructure/Repositories/OrderRepository.cs",
-            "type": "Repository",
-            "operations": ["GetAll", "GetById", "Create", "Update", "Delete"]
-          },
-          {
-            "path": "src/Infrastructure/Data/Migrations/AddOrderTable.cs",
-            "type": "Migration",
-            "tables": ["Order", "OrderLine"]
-          },
-          {
-            "path": "src/Tests/Application/OrderServiceTests.cs",
-            "type": "UnitTests",
-            "testCount": 12
-          },
-          {
-            "path": "src/Tests/Integration/OrderApiTests.cs",
-            "type": "IntegrationTests",
-            "testCount": 8
-          }
-        ]
+        "path": "src/Domain/Entities/Order.cs",
+        "type": "Entity",
+        "linkedFRs": ["FR-001", "FR-002", "FR-003"]
+      },
+      {
+        "path": "src/Domain/Entities/OrderStatus.cs",
+        "type": "Enum",
+        "linkedFRs": ["FR-001"]
+      }
+    ]
+  }
+}
+```
+
+### 4.2 Application File Mapping
+
+```json
+{
+  "filesToCreate": {
+    "application": [
+      {
+        "path": "src/Application/Services/OrderService.cs",
+        "type": "Service",
+        "linkedFRs": ["FR-001", "FR-002", "FR-003", "FR-004"],
+        "linkedUCs": ["UC-001", "UC-002", "UC-003", "UC-004"]
+      },
+      {
+        "path": "src/Application/DTOs/OrderDto.cs",
+        "type": "DTO",
+        "linkedFRs": ["FR-001"]
+      }
+    ]
+  }
+}
+```
+
+### 4.3 Infrastructure File Mapping
+
+```json
+{
+  "filesToCreate": {
+    "infrastructure": [
+      {
+        "path": "src/Infrastructure/Repositories/OrderRepository.cs",
+        "type": "Repository",
+        "linkedFRs": ["FR-001"]
+      },
+      {
+        "path": "src/Infrastructure/Data/Migrations/AddOrderTable.cs",
+        "type": "Migration",
+        "linkedFRs": ["FR-001"]
+      }
+    ]
+  }
+}
+```
+
+### 4.4 API File Mapping
+
+```json
+{
+  "filesToCreate": {
+    "api": [
+      {
+        "path": "src/API/Controllers/OrdersController.cs",
+        "type": "ApiController",
+        "linkedUCs": ["UC-001", "UC-002", "UC-003", "UC-004", "UC-005", "UC-006"]
       }
     ]
   }
 }
 ```
 
-### 4.2 Frontend File Mapping
+### 4.5 Frontend File Mapping
 
-For each use case in specification.useCases[], document UI files:
+For each use case in `specification.useCases[]`, create UI files:
 
 ```json
 {
-  "fileMapping": {
+  "filesToCreate": {
     "frontend": [
       {
-        "useCase": "UC-001: List Orders",
-        "files": [
-          {
-            "path": "src/pages/Orders/OrderListPage.tsx",
-            "type": "Page",
-            "linkedWireframe": "WF-001"
-          },
-          {
-            "path": "src/components/Orders/OrderListTable.tsx",
-            "type": "Component",
-            "linkedFRs": ["FR-001"]
-          },
-          {
-            "path": "src/components/Orders/OrderFilterBar.tsx",
-            "type": "Component",
-            "linkedFRs": ["FR-001"]
-          },
-          {
-            "path": "src/services/api/OrdersApiClient.ts",
-            "type": "ApiClient",
-            "methods": ["getOrders", "searchOrders", "filterOrders"]
-          },
-          {
-            "path": "src/stores/ordersSlice.ts",
-            "type": "Redux Slice",
-            "state": ["orders", "loading", "error", "pagination"]
-          },
-          {
-            "path": "src/tests/pages/OrderListPage.test.tsx",
-            "type": "ComponentTests",
-            "testCount": 8
-          }
-        ]
+        "path": "src/pages/Orders/OrderListPage.tsx",
+        "type": "Page",
+        "linkedUCs": ["UC-001"],
+        "linkedFRs": ["FR-001"]
       },
       {
-        "useCase": "UC-002: Create Order",
-        "files": [
-          {
-            "path": "src/pages/Orders/CreateOrderPage.tsx",
-            "type": "Page",
-            "linkedWireframe": "WF-002"
-          },
-          {
-            "path": "src/components/Orders/CreateOrderForm.tsx",
-            "type": "Component",
-            "linkedFRs": ["FR-002", "FR-003"]
-          },
-          {
-            "path": "src/hooks/useOrderForm.ts",
-            "type": "CustomHook",
-            "linkedValidations": ["Validations for Order fields"]
-          }
-        ]
+        "path": "src/components/Orders/OrderListTable.tsx",
+        "type": "Component",
+        "linkedFRs": ["FR-001"]
+      },
+      {
+        "path": "src/components/Orders/CreateOrderForm.tsx",
+        "type": "Component",
+        "linkedFRs": ["FR-002", "FR-003"]
+      },
+      {
+        "path": "src/services/api/OrdersApiClient.ts",
+        "type": "ApiClient",
+        "linkedUCs": ["UC-001", "UC-002", "UC-003"]
+      },
+      {
+        "path": "src/stores/ordersSlice.ts",
+        "type": "ReduxSlice",
+        "linkedFRs": ["FR-001"]
       }
     ]
   }
 }
 ```
 
-### 4.3 SeedData File Mapping
+### 4.6 SeedData File Mapping
 
-Map 5 mandatory SeedData tables to migration files:
+> **OBLIGATOIRE : 2 catégories de SeedData**
+> 1. **SeedData Core** (5 fichiers obligatoires) : navigation, permissions, rôles — dérivés de `specification.seedDataCore`
+> 2. **SeedData Métier** (N fichiers) : tables de référence (Status, Priority, etc.) — dérivés de `specification.entities` et `specification.navigationHierarchy`
+
+#### 4.6.1 SeedData Core (OBLIGATOIRE - 5 fichiers)
+
+**Source :** `feature.json.specification.seedDataCore` (généré en step-02)
 
 ```json
 {
-  "fileMapping": {
+  "filesToCreate": {
     "seedData": [
       {
-        "table": "Module_Status",
-        "migrationFile": "src/Infrastructure/Data/Migrations/Seed_Order_Status.cs",
-        "rows": [
-          {
-            "id": 1,
-            "code": "DRAFT",
-            "displayName": "Draft",
-            "description": "Order created but not submitted"
-          },
-          {
-            "id": 2,
-            "code": "SUBMITTED",
-            "displayName": "Submitted for Review",
-            "description": "Order awaiting manager approval"
-          },
-          {
-            "id": 3,
-            "code": "APPROVED",
-            "displayName": "Approved",
-            "description": "Order approved and ready for fulfillment"
-          }
-        ]
+        "path": "src/Infrastructure/Data/SeedData/NavigationModuleConfiguration.cs",
+        "type": "HasData",
+        "category": "core",
+        "source": "specification.seedDataCore.navigationModules",
+        "linkedFRs": []
       },
       {
-        "table": "Module_Priority",
-        "migrationFile": "src/Infrastructure/Data/Migrations/Seed_Order_Priority.cs",
-        "rows": 3
+        "path": "src/Infrastructure/Data/SeedData/NavigationTranslationConfiguration.cs",
+        "type": "HasData",
+        "category": "core",
+        "source": "specification.seedDataCore.navigationTranslations",
+        "linkedFRs": []
+      },
+      {
+        "path": "src/Infrastructure/Data/SeedData/PermissionConfiguration.cs",
+        "type": "HasData",
+        "category": "core",
+        "source": "specification.seedDataCore.permissions",
+        "linkedFRs": []
       },
       {
-        "table": "Module_Category",
-        "migrationFile": "src/Infrastructure/Data/Migrations/Seed_Order_Category.cs",
-        "rows": 8
+        "path": "src/Infrastructure/Data/SeedData/RolePermissionConfiguration.cs",
+        "type": "HasData",
+        "category": "core",
+        "source": "specification.seedDataCore.rolePermissions",
+        "linkedFRs": []
       },
       {
-        "table": "Module_Type",
-        "migrationFile": "src/Infrastructure/Data/Migrations/Seed_Order_Type.cs",
-        "rows": 4
+        "path": "src/Application/Constants/Permissions.cs",
+        "type": "Constants",
+        "category": "core",
+        "source": "specification.seedDataCore.permissionConstants",
+        "linkedFRs": []
+      }
+    ]
+  }
+}
+```
+
+> **CRITIQUE :** Sans ces 5 fichiers, le module sera invisible dans l'application (erreur 403).
+> Le contenu de chaque fichier doit correspondre EXACTEMENT aux données dans `specification.seedDataCore`.
+
+#### 4.6.2 SeedData Métier
+
+Map mandatory SeedData tables from `specification.navigationHierarchy.seedDataRequired`:
+
+```json
+{
+  "filesToCreate": {
+    "seedData": [
+      {
+        "path": "src/Infrastructure/Data/SeedData/OrderStatusConfiguration.cs",
+        "type": "HasData",
+        "category": "business",
+        "source": "specification.navigationHierarchy.seedDataRequired[0]",
+        "linkedFRs": ["FR-001"],
+        "rows": 5
       },
       {
-        "table": "Module_Department",
-        "migrationFile": "src/Infrastructure/Data/Migrations/Seed_Order_Department.cs",
-        "rows": 6
+        "path": "src/Infrastructure/Data/SeedData/OrderPriorityConfiguration.cs",
+        "type": "HasData",
+        "category": "business",
+        "linkedFRs": [],
+        "rows": 3
+      }
+    ]
+  }
+}
+```
+
+### 4.7 Tests File Mapping
+
+```json
+{
+  "filesToCreate": {
+    "tests": [
+      {
+        "path": "src/Tests/Application/OrderServiceTests.cs",
+        "type": "UnitTests",
+        "linkedFRs": ["FR-001", "FR-002", "FR-003", "FR-004"]
+      },
+      {
+        "path": "src/Tests/Integration/OrderApiTests.cs",
+        "type": "IntegrationTests",
+        "linkedUCs": ["UC-001", "UC-002", "UC-003"]
       }
     ]
   }
@@ -483,11 +535,15 @@ For task breakdown:
 
 ### 6.1 BR Implementation Mapping
 
-For each business rule, specify where it will be validated:
+> **IMPORTANT :** Générer `handoff.brToCodeMapping[]` (pas `businessRuleMappings`).
+> Dériver depuis `feature.json.analysis.businessRules[]`.
+> Chaque BR doit avoir au minimum 1 point d'implémentation. Format structuré obligatoire.
+
+For each business rule in `analysis.businessRules[]`, specify where it will be validated:
 
 ```json
 {
-  "businessRuleMappings": [
+  "brToCodeMapping": [
     {
       "ruleId": "BR-001",
       "title": "Order number must be unique",
@@ -569,9 +625,15 @@ Map validations to code layers:
 
 ## 7. Define API Endpoints
 
+> **RÈGLE ABSOLUE :** COPIER EXACTEMENT les routes depuis `specification.apiEndpoints[]`.
+> Ne PAS réinventer de routes ni changer le préfixe.
+> Le `handoff.apiEndpointSummary` doit être un sous-ensemble de `specification.apiEndpoints` enrichi avec `linkedUC`.
+> Si `specification.apiEndpoints` utilise `/api/freebike/fleetmanagement/...`, le handoff doit utiliser **exactement le même préfixe**.
+> Ne JAMAIS substituer par `/api/v1/...` ou un autre format.
+
 ### 7.1 RESTful Route Mapping
 
-For each use case, define API endpoints:
+**Source :** `specification.apiEndpoints[]` — copier les routes, enrichir avec linkedUC/linkedFR :
 
 ```json
 {
@@ -980,9 +1042,19 @@ src/locales/
 
 ## 10. Ralph Loop prd.json Generation
 
+> **RÈGLE FONDAMENTALE : Le prd.json est DÉRIVÉ du feature.json, jamais généré indépendamment.**
+>
+> Règles de dérivation strictes :
+> 1. Les entités dans `prd.json.architecture.entities[]` doivent reprendre **EXACTEMENT** les noms et champs de `feature.json.analysis.entities[]`
+> 2. Les `linkedFRs` et `linkedBRs` dans les tasks doivent utiliser les IDs **existants** dans le feature.json (pas d'invention)
+> 3. Les chemins de fichiers doivent correspondre à la structure réelle du projet (lire `.smartstack/config.json` pour le `baseNamespace`)
+> 4. Les permissions doivent reprendre le format **complet** de `specification.permissionMatrix` (ex: `business.freebike.fleetmanagement.vehicles.read`)
+> 5. Les routes API doivent être **identiques** à `specification.apiEndpoints[].path`
+> 6. **AUCUNE entité, FR, BR, UC ou route ne doit apparaître dans le prd.json si elle n'existe pas dans le feature.json**
+
 ### 10.1 PRD Document Structure
 
-Generate comprehensive product requirements document:
+Generate comprehensive product requirements document (**derived from feature.json**) :
 
 ```json
 {
@@ -1080,17 +1152,74 @@ Critical section: Layer-by-layer task breakdown:
           }
         ]
       },
+      {
+        "layerId": "SEEDDATA-CORE",
+        "name": "SeedData Core Layer (OBLIGATOIRE)",
+        "description": "5 mandatory SmartStack core files: navigation, permissions, roles. Source: specification.seedDataCore",
+        "tasks": [
+          {
+            "id": "CORE-001",
+            "title": "Create NavigationModuleConfiguration.cs (HasData)",
+            "description": "Derive from specification.seedDataCore.navigationModules. Creates module + section entries.",
+            "effort": "1h",
+            "dependencies": ["TASK-DOMAIN-001"],
+            "category": "seedDataCore",
+            "linkedFRs": [],
+            "acceptance": "NavigationModuleConfiguration.cs created with HasData() seeding all module/section entries"
+          },
+          {
+            "id": "CORE-002",
+            "title": "Create NavigationTranslationConfiguration.cs (HasData)",
+            "description": "Derive from specification.seedDataCore.navigationTranslations. Creates translations for fr, en, it, de.",
+            "effort": "1h",
+            "dependencies": ["CORE-001"],
+            "category": "seedDataCore",
+            "linkedFRs": [],
+            "acceptance": "NavigationTranslationConfiguration.cs created with HasData() seeding all translations (4 languages)"
+          },
+          {
+            "id": "CORE-003",
+            "title": "Create PermissionConfiguration.cs (HasData)",
+            "description": "Derive from specification.seedDataCore.permissions. Full path format: business.{app}.{module}.{resource}.{action}",
+            "effort": "1h",
+            "dependencies": ["TASK-DOMAIN-001"],
+            "category": "seedDataCore",
+            "linkedFRs": [],
+            "acceptance": "PermissionConfiguration.cs created with HasData() seeding all permissions with full paths"
+          },
+          {
+            "id": "CORE-004",
+            "title": "Create RolePermissionConfiguration.cs (HasData)",
+            "description": "Derive from specification.seedDataCore.rolePermissions. Maps roles to permissions using full paths.",
+            "effort": "1h",
+            "dependencies": ["CORE-003"],
+            "category": "seedDataCore",
+            "linkedFRs": [],
+            "acceptance": "RolePermissionConfiguration.cs created with HasData() seeding role-permission assignments"
+          },
+          {
+            "id": "CORE-005",
+            "title": "Create Permissions.cs constants (Application layer)",
+            "description": "Derive from specification.seedDataCore.permissionConstants. PascalCase const names.",
+            "effort": "0.5h",
+            "dependencies": ["CORE-003"],
+            "category": "seedDataCore",
+            "linkedFRs": [],
+            "acceptance": "Permissions.cs created in Application/Constants with all permission constants"
+          }
+        ]
+      },
       {
         "layerId": "SEEDDATA",
-        "name": "SeedData Layer",
-        "description": "Lookup tables and reference data",
+        "name": "SeedData Business Layer",
+        "description": "Lookup tables and reference data (Status, Priority, Category, etc.)",
         "tasks": [
           {
             "id": "TASK-SEED-001",
             "title": "Create Order_Status SeedData migration",
             "description": "[From specification.navigationHierarchy.seedDataRequired[0]]",
             "effort": "1h",
-            "dependencies": ["TASK-DOMAIN-001"],
+            "dependencies": ["TASK-DOMAIN-001", "CORE-005"],
             "linkedFRs": [],
             "acceptance": "Migration creates Order_Status table with 5 status values seeded"
           }
@@ -1317,7 +1446,29 @@ LAYER BREAKDOWN (28h total effort):
     Completed: [TBD]
     Progress: 0%
 
-[SEEDDATA] SeedData Layer (1h)
+[SEEDDATA-CORE] SeedData Core Layer (4.5h) — OBLIGATOIRE
+  □ CORE-001: Create NavigationModuleConfiguration.cs (1h)
+    Status: pending
+    Source: specification.seedDataCore.navigationModules
+    Progress: 0%
+  □ CORE-002: Create NavigationTranslationConfiguration.cs (1h)
+    Status: pending
+    Source: specification.seedDataCore.navigationTranslations
+    Progress: 0%
+  □ CORE-003: Create PermissionConfiguration.cs (1h)
+    Status: pending
+    Source: specification.seedDataCore.permissions
+    Progress: 0%
+  □ CORE-004: Create RolePermissionConfiguration.cs (1h)
+    Status: pending
+    Source: specification.seedDataCore.rolePermissions
+    Progress: 0%
+  □ CORE-005: Create Permissions.cs constants (0.5h)
+    Status: pending
+    Source: specification.seedDataCore.permissionConstants
+    Progress: 0%
+
+[SEEDDATA] SeedData Business Layer (1h) — depends on CORE-005
   □ TASK-SEED-001: Create Order_Status migration (1h)
     Status: pending
     Assigned: [TBD]
@@ -1411,25 +1562,25 @@ LAYER BREAKDOWN (28h total effort):
 ═════════════════════════════════════════════════════════════════
 SUMMARY
 ═════════════════════════════════════════════════════════════════
-Total Tasks:           15
-Total Effort:          28 hours
+Total Tasks:           20 (5 CORE + 15 business)
+Total Effort:          32.5 hours
 Completed:             0 (0%)
 In Progress:           0 (0%)
-Pending:               15 (100%)
+Pending:               20 (100%)
 Blocked:               0 (0%)
 
 Dependencies:
-  Domain → SeedData → Application → Infrastructure
-         ↘                                    ↙
-           ↓                                ↓
-         API ←─────────── Frontend
-           ↓                  ↓
-         i18n & Tests ← ─────┘
-           ↓
-       Validation
-
-Critical Path: Domain → SeedData → App → Infra → API → Tests (18h)
-Parallel Path: Frontend (6h) can start after API definition
+  Domain → SeedData-CORE → SeedData → Application → Infrastructure
+                    ↘                                         ↙
+                      ↓                                     ↓
+                    API ←─────────── Frontend
+                      ↓                  ↓
+                    i18n & Tests ← ─────┘
+                      ↓
+                  Validation
+
+Critical Path: Domain → CORE → SeedData → App → Infra → API → Tests
+Parallel Path: Frontend can start after API definition
 
 ═════════════════════════════════════════════════════════════════
 NOTES
@@ -1523,17 +1674,69 @@ Remove step-06 from final choice:
 
 1. **Verify validation passed** (status: "approved")
 2. **Explore existing patterns** (check for code generators)
-3. **Map to files** (document implementation locations)
-4. **Generate implementation instructions** (task breakdown)
-5. **Map BRs to code** (validation points)
-6. **Define API endpoints** (RESTful routes)
-7. **Plan tests** (coverage strategy)
-8. **Plan i18n** (translation keys)
-9. **Generate prd.json** (comprehensive requirements)
-10. **Initialize progress.txt** (task tracker)
-11. **Present user choices** (next agent selection)
-
-### 13.2 Output Summary
+3. **Calculate complexity** (simple/medium/complex)
+4. **Map to files** (document implementation locations — structured `filesToCreate`)
+5. **Generate implementation instructions** (task breakdown including CORE-001→CORE-005)
+6. **Map BRs to code** (`brToCodeMapping` — validation points)
+7. **Copy API endpoints** (from `specification.apiEndpoints` — EXACT same routes)
+8. **Plan tests** (coverage strategy)
+9. **Plan i18n** (translation keys)
+10. **Generate prd.json** (DERIVED from feature.json — strict alignment)
+11. **Initialize progress.txt** (task tracker with [SEEDDATA-CORE] section)
+12. **Update changelog** (step-04 entry)
+13. **Present user choices** (next agent selection)
+
+### 13.2 Calculate Complexity
+
+**OBLIGATOIRE :** Calculer et écrire `handoff.complexity` dans feature.json :
+
+| Critère | Simple | Medium | Complex |
+|---------|--------|--------|---------|
+| Entities | ≤3 | ≤6 | >6 |
+| Use Cases | ≤5 | ≤12 | >12 |
+| Business Rules | ≤10 | ≤20 | >20 |
+
+```json
+{
+  "handoff": {
+    "complexity": "medium",
+    "complexityDetails": {
+      "entities": 4,
+      "useCases": 6,
+      "businessRules": 5,
+      "calculated": "medium (≤6 entities, ≤12 UCs, ≤20 BRs)"
+    }
+  }
+}
+```
+
+La complexité la plus élevée parmi les 3 critères détermine le niveau global.
+
+### 13.3 Update Changelog
+
+**OBLIGATOIRE :** Ajouter une entrée changelog pour step-04 via `ba-writer` :
+
+```json
+{
+  "changelog": [
+    {
+      "step": "step-04-handoff",
+      "timestamp": "2025-02-01T11:00:00Z",
+      "changes": [
+        "Complexity: medium",
+        "Files to create: X (Y core + Z business)",
+        "BR mappings: X rules mapped",
+        "API endpoints: X routes (from specification)",
+        "prd.json: X tasks across Y layers",
+        "progress.txt initialized",
+        "User choice: [Feature Full / Ralph Loop / End BA]"
+      ]
+    }
+  ]
+}
+```
+
+### 13.4 Output Summary
 
 Display final summary:
 
@@ -1544,28 +1747,30 @@ Display final summary:
 
 Module:               Orders
 Status:               handed-off
+Complexity:           medium
 Specification:        11 sections complete
 Validation:           approved
 Implementation:       Ready to code
 
 Generated Files:
   ✓ docs/feature.json (specification + validation + handoff)
-  ✓ .ralph/prd.json (v2.0.0 with 15 tasks)
+  ✓ .ralph/prd.json (v2.0.0 with 20 tasks)
   ✓ .ralph/progress.txt (progress tracker)
 
 Statistics:
   - Use cases:        6 (UC-001 → UC-006)
   - Requirements:     12 FRs
   - Business rules:   5 BRs (mapped to code)
-  - API endpoints:    6 REST routes
+  - API endpoints:    6 REST routes (from specification)
   - Components:       8 frontend components
   - Tests:            20 test cases (unit + integration + E2E)
   - i18n keys:        16 translation keys
-  - Implementation:   15 tasks across 9 layers
-  - Total effort:     28 hours
+  - CORE tasks:       5 (navigation, permissions, roles)
+  - Implementation:   20 tasks across 10 layers
+  - Complexity:       medium
 
 Dependencies:
-  ✓ Domain → SeedData → Application → Infrastructure → API → Frontend
+  ✓ Domain → SeedData-CORE → SeedData → Application → Infrastructure → API → Frontend
   ✓ Tests & i18n run in parallel
   ✓ Validation confirms all FRs/BRs covered
 
@@ -1578,13 +1783,17 @@ Next Step: Choose development approach (Feature Full / Ralph Loop / Manual)
 
 ## OUTPUT
 
+> **INTERDIT : Ne générer AUCUN fichier JSON supplémentaire** (specification.json, analysis.json, handoff.json, etc.).
+> Le **feature.json** est le SEUL livrable JSON. Le prd.json et progress.txt sont les seuls fichiers supplémentaires autorisés.
+> Un fichier specification.json séparé crée une **double source de vérité** et sera rejeté par la validation.
+
 This step enriches **feature.json** with:
-- **handoff** section containing file mappings, implementation instructions, BR mappings, API endpoints, test plans, and i18n keys
+- **handoff** section containing: `complexity`, `filesToCreate` (structured object with 7 categories), `brToCodeMapping`, `apiEndpointSummary`, test plans, and i18n keys
 - **Status:** "handed-off"
 
 Also generates:
-- **.ralph/prd.json** - Comprehensive product requirements (v2.0.0 schema)
-- **.ralph/progress.txt** - Task progress tracker with 15 implementation tasks
+- **.ralph/prd.json** - Comprehensive product requirements (v2.0.0 schema, DERIVED from feature.json)
+- **.ralph/progress.txt** - Task progress tracker with 20 implementation tasks (5 CORE + 15 business)
 
 **Standard mode:** Full handoff with all implementation details.
 **Micro mode:** Simplified handoff with minimal tasks, auto-suggest Feature Full.