@atlashub/smartstack-cli 1.11.0 → 1.12.0

package/templates/commands/business-analyse/3-analyse.md

@@ -6,403 +6,101 @@ model: sonnet
 
 # Phase 3: Analyse Business - BRD
 
-> **Modèle:** Sonnet (modélisation, règles métier)
-> **Coût estimé:** ~$0.15
-> **Input:** 1-discovery.md
-> **Output:** 2-business-requirements.md (BRD)
+> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
 
 ---
 
-## ULTRATHINK MODE
-
-```
-╔══════════════════════════════════════════════════════════════════════════════╗
-║  ANALYSE MÉTIER APPROFONDIE                                                  ║
-╠══════════════════════════════════════════════════════════════════════════════╣
-║                                                                              ║
-║  Cette phase transforme la découverte en exigences business formelles:       ║
-║                                                                              ║
-║  • Formaliser les règles métier (BR-XXX)                                     ║
-║  • Modéliser les processus (diagrammes textuels)                             ║
-║  • Définir les objectifs mesurables                                          ║
-║  • Identifier les intégrations nécessaires                                   ║
-║                                                                              ║
-║  RÈGLE: Aucun code technique. Tables et diagrammes textuels uniquement.      ║
-║                                                                              ║
-╚══════════════════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## STEP 1: Charger la découverte
+## Prérequis
 
 ```bash
-FEATURE_ID=$1
-FEATURE_DIR=$(find .business-analyse -type d -name "${FEATURE_ID}*" | head -1)
-DISCOVERY_FILE="$FEATURE_DIR/1-discovery.md"
-
-if [ ! -f "$DISCOVERY_FILE" ]; then
-  echo "❌ ERREUR: 1-discovery.md non trouvé"
-  echo "   Lancez d'abord: /business-analyse:2-discover $FEATURE_ID"
-  exit 1
-fi
-
-# Lire le document discovery
-DISCOVERY_CONTENT=$(cat "$DISCOVERY_FILE")
+find_feature_dir "$1" || exit 1
+[ -f "$FEATURE_DIR/1-discovery.md" ] || { echo "❌ Discovery requis"; exit 1; }
 ```
 
 ---
 
-## STEP 2: Scanner la documentation existante
+## Objectif
 
-```bash
-# Scanner les BRD existants pour cohérence
-EXISTING_BRDS=$(find .business-analyse -name "2-business-requirements.md" -o -name "2-brd.md" 2>/dev/null)
-
-# Scanner les règles métier existantes
-EXISTING_RULES=$(grep -h "^| BR-" $EXISTING_BRDS 2>/dev/null | sort -u)
+Transformer la découverte en exigences business formelles:
+- Formaliser règles métier (BR-XXX)
+- Modéliser processus (diagrammes textuels)
+- Définir objectifs mesurables
 
-echo "Règles existantes trouvées: $(echo "$EXISTING_RULES" | wc -l)"
-
-# Scanner le glossaire
-GLOSSARY=$(cat .business-analyse/glossary.md 2>/dev/null)
-```
+**Règle:** Aucun code technique. Tables et diagrammes textuels uniquement.
 
 ---
 
-## STEP 3: Extraction et formalisation des règles métier
-
-À partir de la découverte, extraire et formaliser chaque règle:
-
-### Pattern de règle métier
+## Pattern Règle Métier
 
 ```
-RULE BR-XXX: {Nom de la règle}
+BR-XXX: {Nom}
 
-ÉNONCÉ:
-  {Description formelle de la règle}
+ÉNONCÉ: {description formelle}
 
 CONDITIONS:
-  SI {condition A}
-  ET {condition B}
-  ALORS {résultat}
-  SINON {résultat alternatif}
+SI {condition A} ET {condition B}
+ALORS {résultat}
+SINON {résultat alternatif}
 
 EXEMPLES:
-  | Entrée | Sortie attendue |
-  |--------|-----------------|
-  | {ex1}  | {résultat1}     |
-  | {ex2}  | {résultat2}     |
-
-VALIDATION:
-  - Critère 1
-  - Critère 2
-```
-
----
-
-## STEP 4: Modélisation des processus
-
-### Diagramme de flux (format texte)
-
-```
-┌─────────────┐     ┌─────────────┐     ┌─────────────┐
-│   START     │────►│   Étape 1   │────►│  Décision   │
-│             │     │  {action}   │     │    ?        │
-└─────────────┘     └─────────────┘     └──────┬──────┘
-                                               │
-                          ┌────────────────────┼────────────────────┐
-                          │                    │                    │
-                          ▼                    ▼                    ▼
-                    ┌─────────┐          ┌─────────┐          ┌─────────┐
-                    │ Chemin A│          │ Chemin B│          │ Chemin C│
-                    └────┬────┘          └────┬────┘          └────┬────┘
-                          │                    │                    │
-                          └────────────────────┼────────────────────┘
-                                               │
-                                               ▼
-                                        ┌─────────────┐
-                                        │     END     │
-                                        └─────────────┘
+| Entrée | Sortie attendue |
 ```
 
 ---
 
-## STEP 5: Génération du BRD
-
-```bash
-BRD_FILE="$FEATURE_DIR/2-business-requirements.md"
-```
-
-### Template 2-business-requirements.md
+## Template 2-business-requirements.md
 
 ```markdown
-# BRD - {FEATURE_ID} {Feature Name}
-
-> **Module:** business/{application}/{module}
-> **Version:** 1.0
-> **Basé sur:** 1-discovery.md v1.0
-> **Standard:** BABOK v3
+# BRD - {FEATURE_ID}
 
----
+> **Module:** business/{app}/{module} | **Basé sur:** 1-discovery.md v1.0
 
 ## 1. Résumé exécutif
-
-{Synthèse en 3-5 phrases du besoin business et de la solution proposée}
-
----
+{3-5 phrases}
 
 ## 2. Objectifs business
-
-| ID | Objectif | Métrique | Baseline | Cible | Deadline |
-|----|----------|----------|----------|-------|----------|
-| OBJ-001 | {objectif} | {KPI} | {actuel} | {cible} | {date} |
-
-### 2.1 Critères de succès
-
-| Critère | Mesure | Seuil acceptable |
-|---------|--------|------------------|
-| {critère} | {comment mesurer} | {valeur seuil} |
-
----
+| ID | Objectif | KPI | Baseline | Cible |
 
 ## 3. Règles métier
-
-| ID | Règle | Catégorie | Priorité | Source |
-|----|-------|-----------|----------|--------|
-| BR-001 | {Description courte} | {catégorie} | Must | Discovery Q{x} |
-
-### 3.1 Détail BR-001: {Nom}
-
-**Énoncé:**
-{Formulation précise et complète de la règle}
-
-**Conditions:**
-```
-SI {condition A}
-ET {condition B}
-ALORS {résultat}
-SINON {résultat alternatif}
-```
-
-**Exemples:**
-
-| Scénario | Entrée | Sortie attendue |
-|----------|--------|-----------------|
-| Cas nominal | {entrée} | {résultat} |
-| Cas limite | {entrée} | {résultat} |
-| Cas erreur | {entrée} | {erreur} |
-
-**Validation:**
-- [ ] {Critère de validation 1}
-- [ ] {Critère de validation 2}
-
----
+| ID | Règle | Catégorie | Priorité |
+### Détail BR-001
+ÉNONCÉ + CONDITIONS + EXEMPLES
 
 ## 4. Processus métier
-
-### 4.1 Processus principal: {Nom}
-
-**Acteurs:** {liste des acteurs impliqués}
-
-**Déclencheur:** {événement qui démarre le processus}
-
-**Flux:**
-
+### Flux principal
 ```
-┌─────────────┐     ┌─────────────┐     ┌─────────────┐
-│   Début     │────►│  Étape 1    │────►│  Étape 2    │
-│             │     │  {action}   │     │  {action}   │
-└─────────────┘     └─────────────┘     └──────┬──────┘
-                                               │
-                                               ▼
-                                        ┌─────────────┐
-                                        │  Étape 3    │
-                                        │  {action}   │
-                                        └──────┬──────┘
-                                               │
-                                               ▼
-                                        ┌─────────────┐
-                                        │    Fin      │
-                                        └─────────────┘
+START → Étape 1 → Décision → [Chemin A|B|C] → END
 ```
-
-**Étapes détaillées:**
-
-| # | Étape | Acteur | Action | Système | Règles |
-|---|-------|--------|--------|---------|--------|
-| 1 | {nom} | {qui} | {fait quoi} | {réponse} | BR-XXX |
-
-### 4.2 Flux alternatifs
-
-| Condition | À l'étape | Flux alternatif | Résultat |
-|-----------|-----------|-----------------|----------|
-| {si...} | {#} | {description} | {état final} |
-
-### 4.3 Flux d'erreur
-
-| Erreur | À l'étape | Gestion | Message utilisateur |
-|--------|-----------|---------|---------------------|
-| {erreur} | {#} | {action} | {message} |
-
----
+| # | Étape | Acteur | Action | Règles |
 
 ## 5. Modèle de données (conceptuel)
-
-### 5.1 Entités
-
 | Entité | Description | Cardinalité |
-|--------|-------------|-------------|
-| {Entité} | {description métier} | {relation} |
-
-### 5.2 Attributs (description métier, PAS de types)
-
-| Entité | Attribut | Description | Obligatoire | Règles |
-|--------|----------|-------------|-------------|--------|
-| {E} | {attribut} | {description} | Oui/Non | BR-XXX |
-
-### 5.3 Relations
-
 ```
-┌──────────┐         ┌──────────┐
-│ Entité A │───[1:N]─│ Entité B │
-└──────────┘         └──────────┘
-      │
-      │[1:1]
-      ▼
-┌──────────┐
-│ Entité C │
-└──────────┘
+Entité A ──[1:N]── Entité B
 ```
 
----
-
 ## 6. Intégrations
-
-| Système | Direction | Données | Fréquence | Criticité |
-|---------|-----------|---------|-----------|-----------|
-| {sys} | In/Out/Bi | {données} | {freq} | Haute/Moyenne/Basse |
-
-### 6.1 Détail intégration {Système}
-
-**Objectif:** {pourquoi cette intégration}
-
-**Données échangées:**
-
-| Champ | Direction | Format | Mapping |
-|-------|-----------|--------|---------|
-| {champ} | {in/out} | {format} | {vers quel champ} |
-
-**Gestion des erreurs:**
-- Si {système} indisponible: {comportement}
-- Si données invalides: {comportement}
-
----
+| Système | Direction | Données | Fréquence |
 
 ## 7. Exigences non-fonctionnelles
+### Performance | Sécurité
 
-### 7.1 Performance
-
-| Métrique | Exigence | Priorité |
-|----------|----------|----------|
-| Temps de réponse | < {x}ms | Must |
-| Utilisateurs simultanés | {n} | Must |
-| Volume de données | {n} enregistrements | Should |
-
-### 7.2 Sécurité
-
-| Exigence | Description | Priorité |
-|----------|-------------|----------|
-| Authentification | {méthode} | Must |
-| Autorisation | Par permission granulaire | Must |
-| Audit | {actions à logger} | Must |
-| Conformité | {normes: GDPR, etc.} | Must |
-
----
-
-## 8. Glossaire du module
-
-| Terme | Définition | Synonymes |
-|-------|------------|-----------|
-| {terme} | {définition métier} | {autres termes} |
-
----
+## 8. Glossaire
+| Terme | Définition |
 
 ## 9. Hypothèses et dépendances
-
-### 9.1 Hypothèses
-
 | # | Hypothèse | Impact si fausse |
-|---|-----------|------------------|
-| H1 | {hypothèse} | {impact} |
-
-### 9.2 Dépendances
-
-| # | Dépendance | Type | Owner | Status |
-|---|------------|------|-------|--------|
-| D1 | {dépendance} | Technique/Business | {qui} | {status} |
-
----
-
-## 10. Prochaines étapes
-
-- [ ] Valider ce BRD avec le sponsor
-- [ ] Résoudre les hypothèses non confirmées
-- [ ] Lancer `/business-analyse:4-specify {FEATURE_ID}`
-
----
-
-## Historique des versions
-
-| Version | Date | Auteur | Modifications |
-|---------|------|--------|---------------|
-| 1.0 | {date} | BA (Sonnet) | Création initiale |
 ```
 
 ---
 
-## STEP 6: Mise à jour du glossaire global
-
-```bash
-# Ajouter les nouveaux termes au glossaire global
-GLOSSARY_FILE=".business-analyse/glossary.md"
-
-# Extraire les termes du BRD section 8
-NEW_TERMS=$(grep "^| " "$BRD_FILE" | grep -v "^| Terme" | grep -v "^|---")
-
-# Ajouter au glossaire si non existants
-```
-
----
-
-## STEP 7: Résumé
+## Résumé
 
 ```
-================================================================================
-                    ANALYSE BUSINESS COMPLÈTE - {FEATURE_ID}
-================================================================================
-
-DOCUMENT GÉNÉRÉ:   {FEATURE_DIR}/2-business-requirements.md
-MODÈLE UTILISÉ:    Sonnet avec ULTRATHINK
-BASÉ SUR:          1-discovery.md v1.0
-
-CONTENU:
-  Objectifs:       {N} définis
-  Règles métier:   {N} formalisées (BR-001 à BR-XXX)
-  Processus:       {N} modélisés
-  Entités:         {N} identifiées
-  Intégrations:    {N} documentées
-
-================================================================================
-PROCHAINE ÉTAPE
-================================================================================
-
-1. Valider 2-business-requirements.md avec le sponsor
-2. Lancer les spécifications fonctionnelles:
-
-   /business-analyse:4-specify {FEATURE_ID}
-
-================================================================================
-
-Contact support: support@atlshub.ch
+ANALYSE - {FEATURE_ID}
+├── Objectifs: {N}
+├── Règles métier: {N} (BR-001 à BR-XXX)
+├── Processus: {N}
+├── Entités: {N}
+└── Prochain: /business-analyse:4-specify {FEATURE_ID}
 ```