@atlashub/smartstack-cli 1.11.0 → 1.12.0

package/templates/commands/business-analyse/6-handoff.md

@@ -6,741 +6,152 @@ model: opus
 
 # Phase 6: Handoff Développement
 
-> **Modèle:** OPUS (génération prompt one-shot, zéro ambiguïté)
-> **Coût estimé:** ~$0.35 (one-shot) / ~$1.00-2.50 (avec ralph-loop)
-> **Prérequis:** validation.json avec status "APPROVED"
+> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
 
 ---
 
-## RALPH-LOOP INTEGRATION (OPTIONNEL)
-
-```
-╔══════════════════════════════════════════════════════════════════════════════╗
-║  UTILISATION AVEC RALPH-LOOP POUR GARANTIE DE COMPLÉTUDE                     ║
-╠══════════════════════════════════════════════════════════════════════════════╣
-║                                                                              ║
-║  /ralph-loop "/business-analyse:6-handoff FEAT-XXX"                          ║
-║              --completion-promise "COMPLETE" --max-iterations 10             ║
-║                                                                              ║
-║  FICHIERS RALPH (créés automatiquement):                                     ║
-║  ├── prd.json        → Sections du handoff avec statut                       ║
-║  └── progress.txt    → Mémoire des sections générées                         ║
-║                                                                              ║
-║  PROCESSUS PAR ITERATION:                                                    ║
-║  1. Lire prd.json → Trouver prochaine section "passes": false                ║
-║  2. Lire progress.txt → Voir sections déjà générées                          ║
-║  3. Générer UNE section du handoff                                           ║
-║  4. Mettre à jour 4-development-handoff.md                                   ║
-║  5. Mettre à jour prd.json → "passes": true                                  ║
-║  6. Ajouter résumé section à progress.txt                                    ║
-║  7. Si TOUTES sections "passes": true → <promise>COMPLETE</promise>          ║
-║                                                                              ║
-║  SIGNAL DE FIN: <promise>COMPLETE</promise>                                  ║
-║                                                                              ║
-╚══════════════════════════════════════════════════════════════════════════════╝
-```
-
-### Structure prd.json pour Handoff
-
-```json
-{
-  "feature_id": "FEAT-XXX",
-  "phase": "handoff",
-  "userStories": [
-    { "id": "1", "title": "Section 1: Header et Contexte", "passes": false },
-    { "id": "2", "title": "Section 2: Entités Domain", "passes": false },
-    { "id": "3", "title": "Section 3: Configuration EF Core", "passes": false },
-    { "id": "4", "title": "Section 4: Commands/Queries Application", "passes": false },
-    { "id": "5", "title": "Section 5: Endpoints API avec permissions", "passes": false },
-    { "id": "6", "title": "Section 6: Service API Frontend", "passes": false },
-    { "id": "7", "title": "Section 7: Pages Frontend", "passes": false },
-    { "id": "8", "title": "Section 8: i18n (4 langues)", "passes": false },
-    { "id": "9", "title": "Section 9: Intégrations SmartStack", "passes": false },
-    { "id": "10", "title": "Section 10: Checklist validation", "passes": false },
-    { "id": "11", "title": "Validation: aucun TBD/? restant", "passes": false }
-  ]
-}
-```
-
----
-
-## OBJECTIF
-
-```
-╔══════════════════════════════════════════════════════════════════════════════╗
-║  GÉNÉRER UN PROMPT AUTONOME POUR IMPLÉMENTATION ONE-SHOT                     ║
-╠══════════════════════════════════════════════════════════════════════════════╣
-║                                                                              ║
-║  Le handoff est un document AUTONOME qui permet au développeur Claude        ║
-║  d'implémenter la feature SANS poser de questions.                           ║
-║                                                                              ║
-║  EXIGENCES:                                                                  ║
-║  • Zéro ambiguïté sur les spécifications                                     ║
-║  • Instructions EXPLORE pour découvrir les patterns existants                ║
-║  • Checklist complète de validation                                          ║
-║  • Permissions explicites avec paths complets                                ║
-║                                                                              ║
-║  USAGE: /implement {FEATURE_ID}                                              ║
-║                                                                              ║
-╚══════════════════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## STEP 1: Vérifier la validation
-
-```bash
-FEATURE_ID=$1
-FEATURE_DIR=$(find .business-analyse -type d -name "${FEATURE_ID}*" | head -1)
-VALIDATION_FILE="$FEATURE_DIR/validation.json"
-
-if [ ! -f "$VALIDATION_FILE" ]; then
-  echo "❌ ERREUR: validation.json non trouvé"
-  echo "   Lancez d'abord: /business-analyse:5-validate $FEATURE_ID"
-  exit 1
-fi
-
-# Vérifier le status
-STATUS=$(grep -oP '"status":\s*"\K[^"]+' "$VALIDATION_FILE")
-
-if [ "$STATUS" != "APPROVED" ]; then
-  echo "❌ ERREUR: Validation non approuvée (status: $STATUS)"
-  echo "   Les spécifications doivent être validées avant le handoff."
-  exit 1
-fi
-
-echo "✅ Validation approuvée - Génération du handoff..."
-```
-
----
-
-## STEP 2: Charger tous les documents
+## Prérequis
 
 ```bash
-DISCOVERY=$(cat "$FEATURE_DIR/1-discovery.md")
-BRD=$(cat "$FEATURE_DIR/2-business-requirements.md")
-FRD=$(cat "$FEATURE_DIR/3-functional-specification.md")
-
-# Extraire les informations clés
-APPLICATION=$(echo $FEATURE_DIR | grep -oP 'business/\K[^/]+')
-MODULE=$(echo $FEATURE_DIR | grep -oP 'modules/\K[^/]+')
-FEATURE_NAME=$(echo $FEATURE_DIR | grep -oP 'FEAT-\d+-\K.*')
+find_feature_dir "$1" || exit 1
+STATUS=$(grep -oP '"decision":\s*"\K[^"]+' "$FEATURE_DIR/validation.json")
+[ "$STATUS" != "APPROVED" ] && { echo "❌ Validation requise"; exit 1; }
 ```
 
 ---
 
-## STEP 3: Génération du handoff
-
-```bash
-HANDOFF_FILE="$FEATURE_DIR/4-development-handoff.md"
-```
-
-### Template 4-development-handoff.md
+## Objectif
 
-```markdown
-# Development Handoff - {FEATURE_ID} {Feature Name}
+Générer un prompt AUTONOME permettant d'implémenter SANS questions:
+- Instructions EXPLORE pour patterns existants
+- Specs détaillées
+- Permissions explicites
+- Checklist validation
 
-> **Module:** business/{application}/{module}
-> **Version:** 1.0 (locked)
-> **Specs validées:** FRD v1.0
-> **Implémentation:** `/implement {FEATURE_ID}`
+**Usage:** `/implement {FEATURE_ID}`
 
 ---
 
-## INSTRUCTIONS DÉVELOPPEUR CLAUDE
-
-Ce document est un **prompt autonome** pour Claude Code.
-Exécutez la commande suivante pour implémenter cette feature:
+## Template 4-development-handoff.md
 
-```bash
-/implement {FEATURE_ID}
-```
-
-**Options disponibles:**
-- `--phase=1` : Backend seulement (Domain + Application + Infrastructure)
-- `--phase=2` : Frontend seulement (Pages + Services + i18n)
-- `--phase=3` : Tests seulement (Unit + Integration + Postman)
-- `--phase=4` : Documentation HTML seulement
-
----
+```markdown
+# Handoff - {FEATURE_ID}
 
-## 1. CONTEXTE RAPIDE
+> **Module:** business/{app}/{module}
+> **Implémentation:** /implement {FEATURE_ID}
 
-| Attribut | Valeur |
-|----------|--------|
+## 1. Contexte
 | Feature ID | {FEATURE_ID} |
-| Module | business/{application}/{module} |
-| Permission base | `business.{application}.{module}` |
+| Permission base | business.{app}.{module} |
 | Complexité | {Simple/Moyenne/Complexe} |
-| Entités | {N} à créer |
-| Endpoints | {N} à implémenter |
-| Pages | {N} à créer |
-
----
-
-## 2. [EXPLORE] DÉCOUVERTE DES PATTERNS
-
-**AVANT de coder, explorer ces fichiers pour comprendre les patterns existants:**
-
-### 2.1 Backend - Patterns à suivre
-
-```
-DOMAIN:
-→ src/SmartStack.Domain/Entities/
-  Explorer: Structure des entités existantes, BaseEntity, interfaces
-  Pattern: Propriétés, méthodes métier, validations
-
-→ src/SmartStack.Domain/Constants/
-  Explorer: Permissions.cs pour voir le format des constantes
-  Pattern: public static class {Module} { public const string View = "..."; }
-
-APPLICATION:
-→ src/SmartStack.Application/Features/
-  Explorer: Structure CQRS (Commands/Queries/Handlers)
-  Pattern: Un dossier par feature, DTOs séparés
-
-→ src/SmartStack.Application/Common/
-  Explorer: Interfaces, comportements, validators
-  Pattern: IRepository, IUnitOfWork, FluentValidation
-
-INFRASTRUCTURE:
-→ src/SmartStack.Infrastructure/Persistence/Configurations/
-  Explorer: EntityTypeConfiguration existantes
-  Pattern: HasData pour seed, relations, indexes
-
-→ src/SmartStack.Infrastructure/Persistence/Configurations/Authorization/
-  Explorer: PermissionConfiguration.cs pour seed permissions
-  Pattern: HasData avec GUID aléatoires
-
-API:
-→ src/SmartStack.Api/Controllers/
-  Explorer: Structure des controllers Business area
-  Pattern: [RequirePermission], [ProducesResponseType], routes
-
-→ src/SmartStack.Api/Areas/Business/
-  Explorer: Controllers existants dans l'area Business
-```
-
-### 2.2 Frontend - Patterns à suivre
 
-```
-PAGES:
-→ web/smartstack-web/src/pages/business/
-  Explorer: Structure des pages existantes
-  Pattern: Liste + Détail + Modal, hooks customs
-
-→ web/smartstack-web/src/pages/admin/
-  Explorer: RolesPage, UsersPage pour patterns CRUD
-  Pattern: DataTable, filtres, modals
-
-COMPOSANTS:
-→ web/smartstack-web/src/components/
-  Explorer: Composants réutilisables
-  Pattern: Button, Modal, DataTable, Form
-
-SERVICES:
-→ web/smartstack-web/src/services/api/
-  Explorer: Services API existants
-  Pattern: apiClient, endpoints, types
-
-I18N:
-→ web/smartstack-web/src/i18n/locales/fr/
-  Explorer: Structure des fichiers de traduction
-  Pattern: Clés hiérarchiques, pluriels
-
-HOOKS:
-→ web/smartstack-web/src/hooks/
-  Explorer: Hooks customs existants
-  Pattern: useApi, usePermission, useToast
-```
-
----
-
-## 3. ENTITÉ(S) À CRÉER
-
-### 3.1 {EntityName}
-
-**Description:** {description métier de l'entité}
-
-**Attributs:**
-
-| Attribut | Description métier | Obligatoire | Validation | Règle BR |
-|----------|-------------------|-------------|------------|----------|
-| Id | Identifiant unique | Oui | GUID aléatoire | - |
-| {attr1} | {description} | Oui | {règle} | BR-001 |
-| {attr2} | {description} | Non | {règle} | - |
-| {attr3} | {description} | Oui | {règle} | BR-002 |
-| Status | État de l'entité | Oui | Enum | - |
-| CreatedAt | Date création | Oui | Auto | - |
-| CreatedBy | Créateur | Oui | Auto (current user) | - |
-| UpdatedAt | Date modification | Non | Auto | - |
-| UpdatedBy | Modificateur | Non | Auto (current user) | - |
-
-**Relations:**
-
-| Relation | Type | Entité cible | Navigation |
-|----------|------|--------------|------------|
-| {rel1} | 1:N | {Entity} | Collection |
-| {rel2} | N:1 | {Entity} | Reference |
-
-**Status Enum:**
-
-| Valeur | Description | Transitions possibles |
-|--------|-------------|----------------------|
-| Draft | Brouillon | → Active |
-| Active | Actif | → Inactive, Archived |
-| Inactive | Désactivé | → Active, Archived |
-| Archived | Archivé | (terminal) |
-
----
-
-## 4. PERMISSIONS À IMPLÉMENTER
-
-### 4.1 Constantes (Permissions.cs)
-
-**Ajouter dans `src/SmartStack.Application/Common/Constants/Permissions.cs`:**
-
-```
-Emplacement: public static class Business > public static class {Module}
-
-Paths à créer:
-• business.{application}.{module}.read
-• business.{application}.{module}.create
-• business.{application}.{module}.update
-• business.{application}.{module}.delete
-```
-
-### 4.2 Seed EF Core (PermissionConfiguration.cs)
-
-**Ajouter dans `PermissionConfiguration.cs` avec HasData:**
-
-| Permission Path | Description | ModuleId |
-|-----------------|-------------|----------|
-| `business.{app}.{module}.read` | View {module} data | {moduleId} |
-| `business.{app}.{module}.create` | Create {module} entries | {moduleId} |
-| `business.{app}.{module}.update` | Modify {module} entries | {moduleId} |
-| `business.{app}.{module}.delete` | Delete {module} entries | {moduleId} |
-
-**⚠️ IMPORTANT:** Utiliser des GUIDs ALÉATOIRES (pas de patterns prévisibles)
-
-### 4.3 Matrice Rôle-Permission
-
-| Permission | SuperAdmin | Admin | Manager | User | ReadOnly |
-|------------|------------|-------|---------|------|----------|
-| `.read` | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `.create` | ✅ | ✅ | ✅ | ❌ | ❌ |
-| `.update` | ✅ | ✅ | ✅ | ❌ | ❌ |
-| `.delete` | ✅ | ✅ | ❌ | ❌ | ❌ |
+## 2. [EXPLORE] Patterns
+### Backend
+- src/SmartStack.Domain/Entities/
+- src/SmartStack.Application/Features/
+- src/SmartStack.Infrastructure/Persistence/Configurations/
+- src/SmartStack.Api/Controllers/
 
----
+### Frontend
+- web/smartstack-web/src/pages/business/
+- web/smartstack-web/src/services/api/
+- web/smartstack-web/src/i18n/locales/
 
-## 5. ENDPOINTS API
+## 3. Entités
+| Attribut | Description | Requis | Validation | BR |
 
-| Endpoint | Méthode | Permission | Body | Response |
-|----------|---------|------------|------|----------|
-| `/api/business/{module}` | GET | `.read` | Query params | 200: Liste paginée |
-| `/api/business/{module}` | POST | `.create` | CreateDto | 201: Entité créée |
-| `/api/business/{module}/{id}` | GET | `.read` | - | 200: Entité |
-| `/api/business/{module}/{id}` | PUT | `.update` | UpdateDto | 200: Entité modifiée |
-| `/api/business/{module}/{id}` | DELETE | `.delete` | - | 204: No Content |
-| `/api/business/{module}/{id}/activate` | PATCH | `.update` | - | 204: Activé |
-| `/api/business/{module}/{id}/deactivate` | PATCH | `.update` | - | 204: Désactivé |
+## 4. Permissions
+### Paths
+business.{app}.{module}.read|create|update|delete
 
-### 5.1 Query Parameters (GET liste)
+### Matrice
+| Permission | Admin | Manager | User | ReadOnly |
 
-| Param | Type | Default | Description |
-|-------|------|---------|-------------|
-| page | int | 1 | Numéro de page |
-| pageSize | int | 10 | Items par page (max 100) |
-| sortBy | string | createdAt | Champ de tri |
-| sortOrder | string | desc | asc/desc |
-| search | string | - | Recherche textuelle |
-| status | string | - | Filtre par status |
+### Seed (PermissionConfiguration.cs)
+GUIDs aléatoires obligatoires
 
-### 5.2 CreateDto
+## 5. Endpoints API
+| Endpoint | Method | Permission | Response |
 
+### DTOs
 | Champ | Type | Requis | Validation |
-|-------|------|--------|------------|
-| {field1} | string | Oui | MaxLength(100) |
-| {field2} | string | Oui | Enum values |
-| {field3} | string | Non | MaxLength(500) |
-
-### 5.3 UpdateDto
-
-Identique à CreateDto.
-
-### 5.4 ResponseDto
-
-| Champ | Type | Description |
-|-------|------|-------------|
-| id | Guid | Identifiant |
-| {field1} | string | {description} |
-| {field2} | string | {description} |
-| status | string | Status actuel |
-| createdAt | DateTime | Date création |
-| updatedAt | DateTime? | Date modification |
-
----
-
-## 6. RÈGLES MÉTIER À IMPLÉMENTER
 
+## 6. Règles métier
 | BR-ID | Règle | Où implémenter |
-|-------|-------|----------------|
-| BR-001 | {règle} | Domain Entity / Validator |
-| BR-002 | {règle} | Command Handler |
-| BR-003 | {règle} | Domain Service |
 
-### 6.1 Détail BR-001
+## 7. Pages Frontend
+### Liste - Route: /business/{app}/{module}
+Composants: Header, Filtres, DataTable, Modal
 
-**Règle:** {description complète}
+### Permissions UI
+| Élément | Permission | Si absent |
 
-**Implémentation:**
-```
-SI {condition}
-ALORS {action}
-SINON {erreur avec message}
-```
+## 8. i18n (4 langues)
+| Fichier | Clés |
+| fr/{module}.json | title, fields.*, actions.*, messages.* |
+| en, it, de | idem |
 
-**Message d'erreur:** `{module}.errors.br001Violation`
-
----
+## 9. Intégrations SmartStack
+| Type | Requis | Skill | Quand |
+| Notifications | {oui/non} | /notification add | Après service |
+| Workflows | {oui/non} | /workflow create | Après triggers |
+| IA | {oui/non} | /ai-prompt create | Pendant service |
 
-## 7. PAGES FRONTEND
+## 10. Tests
+### Unitaires
+- [ ] Entity validation
+- [ ] Validators
 
-### 7.1 Liste ({Module}Page.tsx)
-
-**Route:** `/business/{application}/{module}`
-
-**Composants requis:**
-- Header avec titre + bouton Nouveau
-- Filtres (status, recherche, dates)
-- DataTable avec pagination
-- Actions par ligne (view, edit, delete)
-- Modal création/édition
-
-**Permissions UI:**
-- Bouton Nouveau: visible si `.create`
-- Bouton Edit: visible si `.update`
-- Bouton Delete: visible si `.delete`
-
-### 7.2 Détail ({Module}DetailPage.tsx)
-
-**Route:** `/business/{application}/{module}/:id`
-
-**Composants:**
-- Breadcrumb
-- Card informations principales
-- Actions (edit, delete, activate/deactivate)
-- Historique des modifications (si audit)
-
----
-
-## 8. INTERNATIONALISATION (i18n)
-
-**Fichiers à créer/modifier:**
-
-| Fichier | Clés à ajouter |
-|---------|----------------|
-| `fr/{module}.json` | Toutes les clés |
-| `en/{module}.json` | Toutes les clés |
-| `it/{module}.json` | Toutes les clés |
-| `de/{module}.json` | Toutes les clés |
-
-**Structure des clés:**
-
-```json
-{
-  "{module}": {
-    "title": "{Module Name}",
-    "subtitle": "{Description}",
-    "fields": {
-      "{field1}": "{Label}",
-      "{field2}": "{Label}"
-    },
-    "actions": {
-      "create": "Nouveau",
-      "edit": "Modifier",
-      "delete": "Supprimer"
-    },
-    "messages": {
-      "created": "{Entity} créé avec succès",
-      "updated": "{Entity} modifié avec succès",
-      "deleted": "{Entity} supprimé avec succès"
-    },
-    "errors": {
-      "notFound": "{Entity} non trouvé",
-      "validation": "Données invalides"
-    }
-  }
-}
-```
-
----
-
-## 9. INTÉGRATIONS SMARTSTACK ⭐
-
-> **Importé depuis FRD Section 9 - Skills à exécuter automatiquement**
-
-### 9.1 Notifications (si requis)
-
-| Événement | NotificationType | Destinataire | Message |
-|-----------|------------------|--------------|---------|
-| {Entity}Created | `{Entity}Created` | Créateur | `{module}.notifications.created` |
-| {Entity}Updated | `{Entity}Updated` | Assigné | `{module}.notifications.updated` |
-| {Entity}Assigned | `{Entity}Assigned` | Nouvel assigné | `{module}.notifications.assigned` |
-
-**Skill:** `/notification add`
-**Service à modifier:** `{Entity}Service.cs`
-
-**Template intégration:**
-```csharp
-await _notificationService.SendNotificationAsync(
-    userId: {destinataire}.Id,
-    type: NotificationType.{Entity}Created,
-    title: _localizer["{module}.notifications.created.title"],
-    message: _localizer["{module}.notifications.created.message", entity.Name],
-    relatedEntityType: nameof({Entity}),
-    relatedEntityId: entity.Id,
-    actionUrl: $"/{module}/{entity.Id}",
-    cancellationToken: ct);
-```
-
-### 9.2 Workflows (si requis)
-
-| Workflow Code | Trigger | Steps | Variables |
-|---------------|---------|-------|-----------|
-| `{workflow-code}` | `{entity}.created` | SendEmail, Wait | entityId, entityName, userEmail |
-
-**Skill:** `/workflow create`
-
-**Template déclenchement:**
-```csharp
-await _workflowService.TriggerAsync(
-    "{entity}.created",
-    new Dictionary<string, object>
-    {
-        ["entityId"] = entity.Id,
-        ["entityName"] = entity.Name,
-        ["userEmail"] = _currentUser.Email
-    },
-    language: _currentUser.Language ?? "fr",
-    cancellationToken: ct);
-```
-
-### 9.3 Assistance IA (si requis)
-
-| Prompt Code | Fonction | Input | Output | Schema |
-|-------------|----------|-------|--------|--------|
-| `{prompt-code}` | {génération/classification} | {context} | {format} | {schema} |
-
-**Skill:** `/ai-prompt create`
-
-**Template intégration:**
-```csharp
-var result = await _aiCompletionService.CompleteAsync<{OutputType}>(
-    "{prompt-code}",
-    new Dictionary<string, object>
-    {
-        ["context"] = context,
-        ["entity"] = entity
-    },
-    cancellationToken: ct);
-```
-
-### 9.4 Résumé des Skills à exécuter
-
-| Intégration | Requis | Skill | Moment d'exécution |
-|-------------|--------|-------|-------------------|
-| Notifications | {oui/non} | `/notification add` | Après service backend |
-| Workflows | {oui/non} | `/workflow create` | Après triggers définis |
-| IA | {oui/non} | `/ai-prompt create` | Pendant service backend |
-
-**⚠️ IMPORTANT:** Ces skills sont exécutés automatiquement par `/implement` si requis=oui.
-
----
-
-## 10. TESTS REQUIS
-
-### 10.1 Tests unitaires
-
-- [ ] Entity validation rules
-- [ ] Command validators (FluentValidation)
-- [ ] Business rules in handlers
-
-### 10.2 Tests d'intégration
-
-- [ ] GET /api/business/{module} - 200 OK
-- [ ] GET /api/business/{module}/{id} - 200 OK
-- [ ] GET /api/business/{module}/{id} - 404 Not Found
-- [ ] POST /api/business/{module} - 201 Created
-- [ ] POST /api/business/{module} - 400 Bad Request (validation)
-- [ ] PUT /api/business/{module}/{id} - 200 OK
-- [ ] DELETE /api/business/{module}/{id} - 204 No Content
-
-### 10.3 Tests de permission
-
-- [ ] GET sans permission - 403 Forbidden
-- [ ] POST avec ReadOnly - 403 Forbidden
-- [ ] DELETE avec User - 403 Forbidden
-
-### 10.4 Collection Postman
-
-Générer automatiquement avec `/controller:create`
-
----
-
-## 11. CHECKLIST POST-IMPLÉMENTATION
+### Intégration
+- [ ] GET 200, POST 201, PUT 200, DELETE 204
+- [ ] 403 sans permission
 
+## 11. Checklist
 ### Backend
-
-- [ ] Entity créée dans Domain
-- [ ] Configuration EF Core créée
-- [ ] Migration EF Core créée (`/efcore:migration`)
-- [ ] Commands/Queries créés dans Application
-- [ ] Validators FluentValidation créés
-- [ ] Controller créé dans Api/Areas/Business
-- [ ] Permissions ajoutées dans Permissions.cs
-- [ ] Permissions seedées dans PermissionConfiguration.cs
-- [ ] Build backend OK
+- [ ] Entity + Config EF Core + Migration
+- [ ] Commands/Queries + Validators
+- [ ] Controller + Permissions
+- [ ] Build OK
 
 ### Frontend
+- [ ] Pages + Service API + i18n 4 langues
+- [ ] Routes + Build OK
 
-- [ ] Page liste créée
-- [ ] Page détail créée (si applicable)
-- [ ] Service API créé
-- [ ] i18n complet (4 langues)
-- [ ] Routes ajoutées dans App.tsx
-- [ ] Build frontend OK
-
-### Tests
-
-- [ ] Tests unitaires passent
-- [ ] Tests intégration passent
-- [ ] Collection Postman créée
-
-### Documentation
-
-- [ ] `/business-analyse:7-doc-html {FEATURE_ID}` exécuté
-
-### Intégrations SmartStack
-
-- [ ] Notifications ajoutées (si requis)
-- [ ] Workflows créés (si requis)
-- [ ] Prompts IA créés (si requis)
-- [ ] Hooks frontend SignalR (si notifications)
-
----
-
-## 12. COMMANDE D'IMPLÉMENTATION
+### Intégrations
+- [ ] Notifications/Workflows/IA si requis
 
-```bash
-# Implémentation complète
+## 12. Commande
 /implement {FEATURE_ID}
-
-# Par phase
 /implement {FEATURE_ID} --phase=1  # Backend
 /implement {FEATURE_ID} --phase=2  # Frontend
-/implement {FEATURE_ID} --phase=3  # Tests
-/implement {FEATURE_ID} --phase=4  # Documentation HTML
-```
-
----
-
-## Historique des versions
-
-| Version | Date | Auteur | Modifications |
-|---------|------|--------|---------------|
-| 1.0 | {date} | BA (Opus) | Création initiale (locked) |
 ```
 
 ---
 
-## STEP 4: Verrouillage des documents
+## Checklist complétude
 
-```bash
-# Marquer les documents comme verrouillés
-for doc in "1-discovery.md" "2-business-requirements.md" "3-functional-specification.md"; do
-  if [ -f "$FEATURE_DIR/$doc" ]; then
-    # Ajouter un header de verrouillage
-    sed -i "1s/^/<!-- LOCKED: v1.0 - Validated $(date -I) -->\n/" "$FEATURE_DIR/$doc"
-  fi
-done
-```
+- [ ] Contexte complet
+- [ ] EXPLORE patterns listés
+- [ ] Entités avec attributs complets
+- [ ] Permissions paths + matrice + seed
+- [ ] Endpoints + DTOs
+- [ ] Règles métier référencées
+- [ ] Pages + permissions UI
+- [ ] i18n 4 langues
+- [ ] Intégrations Oui/Non
+- [ ] Tests listés
+- [ ] Aucun "TBD" ou "?"
 
 ---
 
-## STEP 5: Vérification de complétude (RALPH-LOOP)
-
-Avant de terminer, vérifier que TOUS les critères sont remplis:
+## Résumé
 
 ```
-CHECKLIST COMPLÉTUDE HANDOFF:
-□ Section 1 (Contexte) - Feature ID, Module, Complexité renseignés
-□ Section 2 (Explore) - Tous les patterns backend/frontend listés
-□ Section 3 (Entités) - Toutes les entités du FRD avec attributs complets
-□ Section 4 (Permissions) - Paths explicites, matrice rôles complète
-□ Section 5 (Endpoints) - Tous les UC couverts, DTOs définis
-□ Section 6 (Règles métier) - Tous les BR référencés avec implémentation
-□ Section 7 (Pages) - Routes, composants, permissions UI
-□ Section 8 (i18n) - Structure clés pour 4 langues
-□ Section 9 (Intégrations) - Notifications/Workflows/IA spécifiés (oui/non)
-□ Section 10 (Tests) - Checklist unitaires + intégration
-□ Section 11 (Checklist) - Tous les items listés (incluant intégrations)
-□ Section 12 (Commande) - /implement documenté
-□ Aucun marqueur "TBD", "?", "{...}" restant dans le document
+HANDOFF - {FEATURE_ID}
+├── Entités: {N}
+├── Endpoints: {N}
+├── Permissions: {N}
+├── Pages: {N}
+├── Intégrations: {liste}
+└── Prochain: /implement {FEATURE_ID}
 ```
-
----
-
-## STEP 6: Résumé
-
-**SI TOUS LES CRITÈRES SONT REMPLIS:**
-
-```
-================================================================================
-                    HANDOFF GÉNÉRÉ - {FEATURE_ID}
-================================================================================
-
-DOCUMENT:          {FEATURE_DIR}/4-development-handoff.md
-MODÈLE UTILISÉ:    Opus avec ULTRATHINK
-STATUS:            Prêt pour implémentation
-
-CONTENU:
-  • Instructions EXPLORE complètes
-  • {N} entité(s) spécifiée(s)
-  • {N} endpoint(s) API
-  • {N} permission(s) définies
-  • {N} page(s) frontend
-  • {N} intégration(s) SmartStack (Notif/Workflow/IA)
-  • Checklist de 25+ points
-
-DOCUMENTS VERROUILLÉS:
-  ✓ 1-discovery.md v1.0
-  ✓ 2-business-requirements.md v1.0
-  ✓ 3-functional-specification.md v1.0
-  ✓ 4-development-handoff.md v1.0
-
-================================================================================
-PROCHAINE ÉTAPE
-================================================================================
-
-Lancez l'implémentation:
-
-  /implement {FEATURE_ID}
-
-Ou avec ralph-loop pour one-shot complet:
-
-  /ralph-loop "/implement {FEATURE_ID}" \
-              --completion-promise "FEATURE_COMPLETE" \
-              --max-iterations 25
-
-================================================================================
-
-<promise>COMPLETE</promise>
-
-Contact support: support@atlshub.ch
-```
-
-**SI DES CRITÈRES MANQUENT:**
-
-Ne pas afficher le signal de complétion. Compléter les sections manquantes en relisant les documents source (Discovery, BRD, FRD).