@atlashub/smartstack-cli 1.11.0 → 1.13.1

package/templates/commands/business-analyse/5-validate.md

@@ -6,133 +6,73 @@ model: haiku
 
 # Phase 5: Validation Utilisateur
 
-> **Modèle:** Haiku (gate approbation, oui/non)
-> **Coût estimé:** ~$0.01
-> **Prérequis:** 3-functional-specification.md existant
+> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
 
 ---
 
-## GATE VALIDATION (BLOQUANT)
-
-```
-╔══════════════════════════════════════════════════════════════════════════════╗
-║  VALIDATION OBLIGATOIRE AVANT HANDOFF                                        ║
-╠══════════════════════════════════════════════════════════════════════════════╣
-║                                                                              ║
-║  Cette phase est un GATE qui BLOQUE le passage au handoff si non approuvé.   ║
-║                                                                              ║
-║  Le sponsor/stakeholder DOIT valider:                                        ║
-║  • Les cas d'utilisation sont complets                                       ║
-║  • Les wireframes correspondent aux attentes                                 ║
-║  • Les règles métier sont correctes                                          ║
-║  • Les permissions sont appropriées                                          ║
-║                                                                              ║
-║  SI REJET:                                                                   ║
-║  → Retour à /business-analyse:3-analyse pour révision                        ║
-║  → Document versionné (incrémentation minor ou major)                        ║
-║                                                                              ║
-╚══════════════════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## STEP 1: Charger les documents
+## Prérequis
 
 ```bash
-FEATURE_ID=$1
-FEATURE_DIR=$(find .business-analyse -type d -name "${FEATURE_ID}*" | head -1)
-FRD_FILE="$FEATURE_DIR/3-functional-specification.md"
-
-if [ ! -f "$FRD_FILE" ]; then
-  echo "❌ ERREUR: 3-functional-specification.md non trouvé"
-  echo "   Lancez d'abord: /business-analyse:4-specify $FEATURE_ID"
-  exit 1
-fi
-
-# Charger les documents pour résumé
-DISCOVERY=$(cat "$FEATURE_DIR/1-discovery.md" 2>/dev/null)
-BRD=$(cat "$FEATURE_DIR/2-business-requirements.md" 2>/dev/null)
-FRD=$(cat "$FRD_FILE")
+find_feature_dir "$1" || exit 1
+[ -f "$FEATURE_DIR/3-functional-specification.md" ] || { echo "❌ FRD requis"; exit 1; }
 ```
 
 ---
 
-## STEP 2: Afficher le résumé pour validation
+## GATE VALIDATION
 
-```
-================================================================================
-                    VALIDATION DES SPÉCIFICATIONS - {FEATURE_ID}
-================================================================================
+Cette phase BLOQUE le passage au handoff si non approuvé.
 
-DOCUMENTS À VALIDER:
-
-1. DISCOVERY (1-discovery.md)
-   ────────────────────────────────────────
-   • Stakeholders identifiés: {N}
-   • Questions ouvertes: {N}
-   • Périmètre défini: ✅
-
-2. BRD (2-business-requirements.md)
-   ────────────────────────────────────────
-   • Objectifs business: {N}
-   • Règles métier: {N} (BR-001 à BR-XXX)
-   • Processus modélisés: {N}
-
-3. FRD (3-functional-specification.md)
-   ────────────────────────────────────────
-   • Cas d'utilisation: {N} (UC-001 à UC-XXX)
-   • Exigences fonctionnelles: {N} (FR-001 à FR-XXX)
-   • Wireframes: {N} écrans
-   • Permissions: {N} définies
-   • Scénarios Gherkin: {N}
-
-================================================================================
-```
+Le stakeholder DOIT valider:
+- Cas d'utilisation complets
+- Wireframes conformes
+- Règles métier correctes
+- Permissions appropriées
 
 ---
 
-## STEP 3: Demande de validation
+## Demande de validation
 
 ```javascript
 AskUserQuestion({
   questions: [
     {
-      question: "Les cas d'utilisation couvrent-ils tous les besoins exprimés?",
+      question: "Les cas d'utilisation couvrent-ils tous les besoins?",
       header: "Use Cases",
       options: [
-        { label: "Oui, complets", description: "Tous les UC sont validés" },
-        { label: "Partiellement", description: "Certains UC manquent ou sont incomplets" },
-        { label: "Non", description: "Révision majeure nécessaire" }
+        { label: "Oui, complets", description: "Tous les UC validés" },
+        { label: "Partiellement", description: "UC incomplets" },
+        { label: "Non", description: "Révision majeure" }
       ],
       multiSelect: false
     },
     {
-      question: "Les wireframes correspondent-ils à vos attentes?",
+      question: "Les wireframes correspondent aux attentes?",
       header: "UI/UX",
       options: [
-        { label: "Oui, validés", description: "Les écrans sont conformes" },
-        { label: "Ajustements mineurs", description: "Quelques modifications à faire" },
-        { label: "Non", description: "Refonte des wireframes nécessaire" }
+        { label: "Oui, validés", description: "Écrans conformes" },
+        { label: "Ajustements mineurs", description: "Modifications légères" },
+        { label: "Non", description: "Refonte nécessaire" }
       ],
       multiSelect: false
     },
     {
-      question: "Les règles métier (BR-XXX) sont-elles correctes?",
+      question: "Les règles métier (BR-XXX) sont correctes?",
       header: "Règles",
       options: [
-        { label: "Oui, correctes", description: "Toutes les règles sont validées" },
-        { label: "Corrections mineures", description: "Quelques règles à ajuster" },
-        { label: "Non", description: "Règles incorrectes ou manquantes" }
+        { label: "Oui, correctes", description: "Toutes validées" },
+        { label: "Corrections mineures", description: "Quelques ajustements" },
+        { label: "Non", description: "Règles incorrectes" }
       ],
       multiSelect: false
     },
     {
-      question: "Les permissions sont-elles appropriées?",
+      question: "Les permissions sont appropriées?",
       header: "Permissions",
       options: [
-        { label: "Oui, validées", description: "Matrice permissions OK" },
-        { label: "À ajuster", description: "Certains rôles/permissions à modifier" },
-        { label: "Non", description: "Permissions à revoir entièrement" }
+        { label: "Oui, validées", description: "Matrice OK" },
+        { label: "À ajuster", description: "Rôles à modifier" },
+        { label: "Non", description: "À revoir" }
       ],
       multiSelect: false
     }
@@ -142,185 +82,51 @@ AskUserQuestion({
 
 ---
 
-## STEP 4: Traitement de la décision
+## Traitement décision
 
-### Si toutes les réponses sont positives (Oui/Validé)
+### Si APPROUVÉ (toutes réponses positives)
 
-```bash
-# Créer le fichier validation.json
-cat > "$FEATURE_DIR/validation.json" << EOF
+```json
 {
-  "featureId": "$FEATURE_ID",
-  "validatedAt": "$(date -Iseconds)",
-  "validatedBy": "{stakeholder}",
+  "featureId": "{FEATURE_ID}",
   "status": "APPROVED",
   "documents": {
     "discovery": { "version": "1.0", "status": "approved" },
     "brd": { "version": "1.0", "status": "approved" },
     "frd": { "version": "1.0", "status": "approved" }
   },
-  "comments": "",
   "nextStep": "handoff"
 }
-EOF
-
-echo "✅ VALIDATION APPROUVÉE"
 ```
 
-**Output:**
-```
-================================================================================
-                    ✅ VALIDATION APPROUVÉE - {FEATURE_ID}
-================================================================================
-
-Tous les documents ont été validés par le stakeholder.
-
-DOCUMENTS VERROUILLÉS:
-  • 1-discovery.md v1.0 ✅
-  • 2-business-requirements.md v1.0 ✅
-  • 3-functional-specification.md v1.0 ✅
-
-FICHIER CRÉÉ: validation.json
-
-================================================================================
-PROCHAINE ÉTAPE
-================================================================================
-
-Générez le prompt de développement:
-
-  /business-analyse:6-handoff {FEATURE_ID}
-
-================================================================================
-```
-
-### Si réponses négatives ou partielles
+### Si REJETÉ
 
-```bash
-# Créer le fichier validation.json avec status REJECTED
-cat > "$FEATURE_DIR/validation.json" << EOF
+```json
 {
-  "featureId": "$FEATURE_ID",
-  "validatedAt": "$(date -Iseconds)",
-  "validatedBy": "{stakeholder}",
+  "featureId": "{FEATURE_ID}",
   "status": "REJECTED",
-  "rejectionReasons": {
-    "useCases": "{feedback}",
-    "wireframes": "{feedback}",
-    "businessRules": "{feedback}",
-    "permissions": "{feedback}"
-  },
-  "requiredChanges": [
-    "{change 1}",
-    "{change 2}"
-  ],
+  "rejectionReasons": { "useCases": "", "wireframes": "", "businessRules": "", "permissions": "" },
   "nextStep": "revise"
 }
-EOF
-
-echo "❌ VALIDATION REJETÉE - Révision requise"
-```
-
-**Output:**
 ```
-================================================================================
-                    ❌ VALIDATION REJETÉE - {FEATURE_ID}
-================================================================================
-
-Le stakeholder a demandé des révisions.
-
-POINTS À RÉVISER:
-  □ Use Cases: {feedback détaillé}
-  □ Wireframes: {feedback détaillé}
-  □ Règles métier: {feedback détaillé}
-  □ Permissions: {feedback détaillé}
-
-FICHIER CRÉÉ: validation.json (status: REJECTED)
-
-================================================================================
-ACTION REQUISE
-================================================================================
-
-1. Relire le feedback dans validation.json
-2. Réviser les documents concernés
-3. Relancer les phases appropriées:
-
-   # Si révision majeure (scope change)
-   /business-analyse:3-analyse {FEATURE_ID}  # Incrémente version major
-
-   # Si révision mineure (ajustements)
-   /business-analyse:4-specify {FEATURE_ID}  # Incrémente version minor
-
-4. Relancer la validation:
-   /business-analyse:5-validate {FEATURE_ID}
-
-================================================================================
-```
-
----
-
-## STEP 5: Collecte du feedback détaillé (si rejet)
-
-```javascript
-AskUserQuestion({
-  questions: [{
-    question: "Décrivez les changements nécessaires pour chaque point rejeté:",
-    header: "Feedback",
-    options: [
-      { label: "Fourni ci-dessous", description: "Je vais détailler les changements" },
-      { label: "Réunion nécessaire", description: "Je préfère discuter en réunion" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
-Si "Fourni ci-dessous":
-- Collecter le feedback textuel
-- Ajouter au validation.json
-- Créer un fichier de tracking pour les changements
 
 ---
 
-## Règles de versioning post-validation
+## Versioning post-validation
 
 | Situation | Action | Nouvelle version |
 |-----------|--------|------------------|
 | Approuvé | Verrouiller | 1.0 (locked) |
 | Rejet mineur | Réviser specify | 1.1 |
 | Rejet majeur | Réviser analyse | 2.0 |
-| Change request post-handoff | CR process | via CR-FEAT-XXX-001 |
 
 ---
 
-## Fichier validation.json
+## Résumé
 
-```json
-{
-  "featureId": "FEAT-XXX",
-  "validatedAt": "2024-01-15T14:30:00Z",
-  "validatedBy": "product.owner@company.com",
-  "status": "APPROVED | REJECTED",
-  "documents": {
-    "discovery": { "version": "1.0", "status": "approved" },
-    "brd": { "version": "1.0", "status": "approved" },
-    "frd": { "version": "1.0", "status": "approved | needs_revision" }
-  },
-  "rejectionReasons": {
-    "useCases": "string or null",
-    "wireframes": "string or null",
-    "businessRules": "string or null",
-    "permissions": "string or null"
-  },
-  "requiredChanges": [],
-  "comments": "string",
-  "nextStep": "handoff | revise"
-}
 ```
-
----
-
-## Support
-
-> **Questions sur le processus de validation?**
->
-> 📧 **support@atlshub.ch**
+VALIDATE - {FEATURE_ID}
+├── Status: {APPROVED/REJECTED}
+├── Documents: {N} validés
+└── Prochain: /business-analyse:6-handoff {FEATURE_ID}
+```