@atlashub/smartstack-cli 1.1.0

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

@@ -0,0 +1,746 @@
+---
+description: Phase 6 - Development prompt generation (ULTRATHINK)
+agent: ba-handoff
+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"
+
+---
+
+## 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
+
+```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.*')
+```
+
+---
+
+## STEP 3: Génération du handoff
+
+```bash
+HANDOFF_FILE="$FEATURE_DIR/4-development-handoff.md"
+```
+
+### Template 4-development-handoff.md
+
+```markdown
+# Development Handoff - {FEATURE_ID} {Feature Name}
+
+> **Module:** business/{application}/{module}
+> **Version:** 1.0 (locked)
+> **Specs validées:** FRD v1.0
+> **Implémentation:** `/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:
+
+```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
+
+---
+
+## 1. CONTEXTE RAPIDE
+
+| Attribut | Valeur |
+|----------|--------|
+| Feature ID | {FEATURE_ID} |
+| Module | business/{application}/{module} |
+| Permission base | `business.{application}.{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` | ✅ | ✅ | ❌ | ❌ | ❌ |
+
+---
+
+## 5. ENDPOINTS API
+
+| 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é |
+
+### 5.1 Query Parameters (GET liste)
+
+| 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 |
+
+### 5.2 CreateDto
+
+| 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
+
+| 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
+
+**Règle:** {description complète}
+
+**Implémentation:**
+```
+SI {condition}
+ALORS {action}
+SINON {erreur avec message}
+```
+
+**Message d'erreur:** `{module}.errors.br001Violation`
+
+---
+
+## 7. PAGES FRONTEND
+
+### 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
+
+### 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
+
+### Frontend
+
+- [ ] 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
+
+```bash
+# Implémentation complète
+/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
+
+```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
+```
+
+---
+
+## STEP 5: Vérification de complétude (RALPH-LOOP)
+
+Avant de terminer, vérifier que TOUS les critères sont remplis:
+
+```
+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
+```
+
+---
+
+## 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).