@atlashub/smartstack-cli 1.11.0 → 1.13.1

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

@@ -0,0 +1,176 @@
+# Business Analyse - Fonctions Partagées
+
+> **Ref:** Ce fichier contient les fonctions communes à toutes les phases BA.
+
+---
+
+## Validation Contexte Business
+
+```bash
+validate_business_context() {
+  local CONTEXT="$1"
+  [[ "$CONTEXT" =~ ^(platform|personal|system)$ ]] && {
+    echo "❌ ERREUR: BA réservée au contexte 'business'. Contact: support@atlshub.ch"
+    return 1
+  }
+  return 0
+}
+```
+
+---
+
+## Feature Directory
+
+```bash
+find_feature_dir() {
+  local FEATURE_ID="$1"
+  FEATURE_DIR=$(find .business-analyse -type d -name "${FEATURE_ID}*" 2>/dev/null | head -1)
+  [ -z "$FEATURE_DIR" ] && { echo "❌ Feature $FEATURE_ID non trouvée"; return 1; }
+  APPLICATION=$(echo "$FEATURE_DIR" | grep -oP 'business/\K[^/]+')
+  MODULE=$(echo "$FEATURE_DIR" | grep -oP 'modules/\K[^/]+')
+  export FEATURE_DIR APPLICATION MODULE
+}
+```
+
+---
+
+## Génération Feature ID
+
+```bash
+generate_feature_id() {
+  local LAST_ID=$(grep -oP '"lastFeatureId":\s*\K\d+' .business-analyse/config.json 2>/dev/null || echo "0")
+  printf "FEAT-%03d" $((LAST_ID + 1))
+}
+```
+
+---
+
+## Modèles par Phase
+
+| Phase | Modèle | Raison |
+|-------|--------|--------|
+| 1-init | Haiku | Setup structure |
+| 2-discover | **Opus** | Elicitation ULTRATHINK |
+| 3-analyse | Sonnet | Modélisation BRD |
+| 4-specify | Sonnet | FRD + Use Cases |
+| 5-validate | Haiku | Gate oui/non |
+| 6-handoff | **Opus** | Prompt zéro ambiguïté |
+| 7-doc-html | Sonnet | React + Context7 |
+
+---
+
+## ULTRATHINK
+
+Mode comportemental pour phases critiques (2, 3, 4, 6):
+- Considérer TOUS les edge cases
+- Challenger CHAQUE hypothèse
+- Anticiper besoins NON exprimés
+- Valider complétude avant output
+
+**NE PAS appeler** comme skill/tool.
+
+---
+
+## Context7 (Phase 7)
+
+```
+"use context7 with /facebook/react and /i18next/react-i18next
+ to generate {component} following SmartStack patterns"
+```
+
+Libraries: `/facebook/react`, `/i18next/react-i18next`, `/remix-run/react-router`, `/lucide-icons/lucide-react`
+
+---
+
+## Permission Path
+
+Format: `business.{application}.{module}.{action}`
+
+| Action | Permission |
+|--------|------------|
+| Lecture | `.read` |
+| Création | `.create` |
+| Modification | `.update` |
+| Suppression | `.delete` |
+| Export | `.export` |
+| Import | `.import` |
+| Admin | `.admin` |
+
+---
+
+## i18n (4 langues obligatoires)
+
+| Langue | Fichier |
+|--------|---------|
+| FR | `fr/{app}-{module}.json` |
+| EN | `en/{app}-{module}.json` |
+| IT | `it/{app}-{module}.json` |
+| DE | `de/{app}-{module}.json` |
+
+---
+
+## Output Paths
+
+| Type | Chemin |
+|------|--------|
+| Documentation | `web/smartstack-web/src/pages/business/{app}/{module}/DocumentationPage.tsx` |
+| i18n | `web/smartstack-web/src/i18n/locales/{lang}/` |
+| Route | `/business/{app}/{module}/documentation` |
+
+---
+
+## Résumé Standard
+
+```
+{PHASE} - {FEATURE_ID}
+├── Status: {Complete/En cours}
+├── Output: {fichiers créés}
+└── Prochain: {commande suivante}
+```
+
+---
+
+## Config Template
+
+```json
+{
+  "project": "{Name}",
+  "lastFeatureId": 0,
+  "context": "business",
+  "standards": ["BABOK-v3", "IEEE-830"],
+  "contact": "support@atlshub.ch"
+}
+```
+
+---
+
+## Structure Feature
+
+```
+.business-analyse/business/{app}/modules/{module}/features/{FEAT-XXX}/
+├── 1-discovery.md
+├── 2-business-requirements.md
+├── 3-functional-specification.md
+├── 4-development-handoff.md
+├── validation.json
+└── tracking/
+    ├── changes/
+    ├── bugs/
+    └── hotfixes/
+```
+
+---
+
+## Ralph Loop (optionnel)
+
+Fichiers créés par phase Ralph:
+- `prd.json` - Tracking tâches (`"passes": true/false`)
+- `progress.txt` - Mémoire inter-itérations
+
+Signal fin: `<promise>COMPLETE</promise>`
+
+---
+
+## Support
+
+Contact: **support@atlshub.ch**

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

@@ -4,54 +4,42 @@ agent: ba-bug
 model: sonnet
 ---
 
-# Documentation Bug - Business Analyse
+# Documentation Bug
 
-> **Modèle:** Sonnet (analyse root cause)
+> **Ref:** Fonctions communes dans [_shared.md](_shared.md)
 > **Output:** `.business-analyse/.../tracking/bugs/BUG-XXX.md`
 
 ---
 
-## QUAND UTILISER
+## Quand utiliser
 
-```
-╔══════════════════════════════════════════════════════════════════════════════╗
-║  DOCUMENTATION BUG: Traçabilité et analyse structurée                        ║
-╠══════════════════════════════════════════════════════════════════════════════╣
-║                                                                              ║
-║  Utiliser cette commande pour:                                               ║
-║  • Documenter un bug découvert après implémentation                          ║
-║  • Analyser la root cause                                                    ║
-║  • Créer un prompt de correction pour Claude                                 ║
-║  • Maintenir la traçabilité vers les specs (FR/BR impactés)                  ║
-║                                                                              ║
-║  NE PAS utiliser pour:                                                       ║
-║  • Hotfix urgent (utiliser /business-analyse:hotfix)                         ║
-║  • Changement de scope (utiliser /business-analyse:change-request)           ║
-║                                                                              ║
-╚══════════════════════════════════════════════════════════════════════════════╝
-```
+| ✅ Utiliser | ❌ Ne pas utiliser |
+|-------------|-------------------|
+| Bug post-implémentation | Hotfix urgent → `/business-analyse:hotfix` |
+| Analyse root cause | Changement scope → `/business-analyse:change-request` |
+| Traçabilité specs |  |
 
 ---
 
-## STEP 1: Collecte des informations
+## Collecte informations
 
 ```javascript
 AskUserQuestion({
   questions: [
     {
-      question: "Quelle feature est impactée par ce bug?",
+      question: "Quelle feature est impactée?",
       header: "Feature",
       options: [
-        { label: "Feature existante", description: "Bug sur une feature documentée" },
-        { label: "Nouvelle", description: "Bug sur code non documenté en BA" }
+        { label: "Feature existante", description: "Bug sur feature documentée" },
+        { label: "Nouvelle", description: "Bug sur code non documenté" }
       ],
       multiSelect: false
     },
     {
-      question: "Quelle est la sévérité du bug?",
+      question: "Sévérité du bug?",
       header: "Sévérité",
       options: [
-        { label: "Critique", description: "Bloque l'utilisation, perte de données" },
+        { label: "Critique", description: "Bloque utilisation, perte données" },
         { label: "Majeur", description: "Fonctionnalité principale impactée" },
         { label: "Mineur", description: "Workaround possible" },
         { label: "Cosmétique", description: "UI/UX, pas d'impact fonctionnel" }
@@ -59,13 +47,13 @@ AskUserQuestion({
       multiSelect: false
     },
     {
-      question: "Le bug est-il reproductible?",
+      question: "Bug reproductible?",
       header: "Repro",
       options: [
-        { label: "Toujours", description: "100% reproductible" },
-        { label: "Souvent", description: ">50% du temps" },
-        { label: "Parfois", description: "<50% du temps" },
-        { label: "Rarement", description: "Difficile à reproduire" }
+        { label: "Toujours", description: "100%" },
+        { label: "Souvent", description: ">50%" },
+        { label: "Parfois", description: "<50%" },
+        { label: "Rarement", description: "Difficile" }
       ],
       multiSelect: false
     }
@@ -75,114 +63,7 @@ AskUserQuestion({
 
 ---
 
-## STEP 2: Générer Bug ID
-
-```bash
-FEATURE_ID=$1  # Optionnel
-DATE=$(date +%Y%m%d)
-
-# Lire le dernier bug ID
-LAST_BUG_ID=$(find .business-analyse -name "BUG-*.md" | grep -oP 'BUG-\K\d+' | sort -n | tail -1 || echo "0")
-NEW_BUG_ID=$(printf "%03d" $((LAST_BUG_ID + 1)))
-BUG_ID="BUG-$NEW_BUG_ID"
-
-# Déterminer le dossier
-if [ -n "$FEATURE_ID" ]; then
-  FEATURE_DIR=$(find .business-analyse -type d -name "${FEATURE_ID}*" | head -1)
-  BUG_DIR="$FEATURE_DIR/tracking/bugs"
-else
-  BUG_DIR=".business-analyse/tracking/bugs"
-fi
-
-mkdir -p "$BUG_DIR"
-```
-
----
-
-## STEP 3: Collecte détaillée
-
-Demander à l'utilisateur:
-
-1. **Description du bug** (comportement observé vs attendu)
-2. **Étapes de reproduction**
-3. **Environnement** (browser, OS, données de test)
-4. **Screenshots/logs** si disponibles
-
----
-
-## STEP 4: Analyse root cause
-
-```
-╔══════════════════════════════════════════════════════════════════════════════╗
-║  ANALYSE ROOT CAUSE (5 WHYS)                                                 ║
-╠══════════════════════════════════════════════════════════════════════════════╣
-║                                                                              ║
-║  1. POURQUOI le bug se produit?                                              ║
-║     → {réponse niveau 1}                                                     ║
-║                                                                              ║
-║  2. POURQUOI {réponse niveau 1}?                                             ║
-║     → {réponse niveau 2}                                                     ║
-║                                                                              ║
-║  3. POURQUOI {réponse niveau 2}?                                             ║
-║     → {réponse niveau 3}                                                     ║
-║                                                                              ║
-║  ... jusqu'à identifier la ROOT CAUSE                                        ║
-║                                                                              ║
-╚══════════════════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## STEP 5: Génération du document
-
-### Template BUG-XXX.md
-
-```markdown
-# {BUG_ID} - {Bug Title}
-
-> **Feature:** {FEATURE_ID} (si applicable)
-> **Sévérité:** {Critique/Majeur/Mineur/Cosmétique}
-> **Status:** Open
-> **Date:** {YYYY-MM-DD}
-
----
-
-## 1. Description
-
-### Comportement observé
-{Description précise de ce qui se passe}
-
-### Comportement attendu
-{Ce qui devrait se passer selon les specs}
-
-### Impact
-- Utilisateurs impactés: {qui}
-- Fonctionnalité: {laquelle}
-- Workaround: {existe/n'existe pas}
-
----
-
-## 2. Reproduction
-
-### Prérequis
-- Environnement: {dev/staging/prod}
-- Rôle utilisateur: {rôle}
-- Données requises: {données de test}
-
-### Étapes
-1. {Étape 1}
-2. {Étape 2}
-3. {Étape 3}
-4. → Bug observé
-
-### Reproductibilité
-{Toujours/Souvent/Parfois/Rarement}
-
----
-
-## 3. Analyse
-
-### 3.1 Root Cause Analysis (5 Whys)
+## Analyse Root Cause (5 Whys)
 
 | # | Question | Réponse |
 |---|----------|---------|
@@ -190,136 +71,48 @@ Demander à l'utilisateur:
 | 2 | Pourquoi {réponse 1}? | {réponse} |
 | 3 | Pourquoi {réponse 2}? | {réponse} |
 | 4 | Pourquoi {réponse 3}? | {réponse} |
-| 5 | Pourquoi {réponse 4}? | **ROOT CAUSE: {cause}** |
-
-### 3.2 Specs impactées
-
-| Type | ID | Description | Impact |
-|------|----|----|--------|
-| Règle métier | BR-XXX | {description} | {comment impacté} |
-| Exigence | FR-XXX | {description} | {comment impacté} |
-| Use Case | UC-XXX | {description} | {comment impacté} |
-
-### 3.3 Code impacté
-
-| Fichier | Ligne(s) | Description |
-|---------|----------|-------------|
-| `{path/to/file}` | ~{lines} | {ce qui est incorrect} |
-
----
-
-## 4. Solution proposée
-
-### 4.1 Correction
-
-{Description de la correction à apporter}
-
-### 4.2 Fichiers à modifier
-
-| Fichier | Modification |
-|---------|--------------|
-| `{path}` | {description du changement} |
-
-### 4.3 Tests à ajouter
-
-```gherkin
-@bugfix @{BUG_ID}
-Scenario: {BUG_ID} - {description}
-  Given {contexte}
-  When {action qui causait le bug}
-  Then {comportement correct attendu}
-```
-
----
-
-## 5. Prompt de correction
-
-```
-CONTEXTE:
-Bug {BUG_ID} à corriger dans le module business/{app}/{module}
-
-ROOT CAUSE:
-{root cause identifiée}
-
-CORRECTION:
-{description de la correction}
-
-FICHIERS À MODIFIER:
-{liste des fichiers}
-
-TEST DE VALIDATION:
-Après correction, le scénario Gherkin suivant doit passer:
-{scénario}
-```
+| 5 | Pourquoi {réponse 4}? | **ROOT CAUSE** |
 
 ---
 
-## 6. Validation
-
-### Critères d'acceptation
-- [ ] Bug n'est plus reproductible
-- [ ] Tests de régression passent
-- [ ] Nouveau test ajouté pour ce cas
-- [ ] Code review effectué
-
-### Environnements testés
-- [ ] Local
-- [ ] Staging
-- [ ] Production (si applicable)
+## Template BUG-XXX.md
 
----
-
-## 7. Prévention
-
-### Comment éviter ce type de bug à l'avenir?
+```markdown
+# {BUG_ID} - {Title}
 
-| Action | Responsable | Deadline |
-|--------|-------------|----------|
-| {action préventive} | {qui} | {quand} |
+> **Feature:** {FEATURE_ID} | **Sévérité:** {X} | **Status:** Open
 
----
+## 1. Description
+### Observé vs Attendu
 
-## Historique
+## 2. Reproduction
+### Prérequis | Étapes | Reproductibilité
 
-| Date | Action | Par |
-|------|--------|-----|
-| {date} | Création | {auteur} |
-| {date} | Analyse | {auteur} |
-| {date} | Correction | {dev} |
-| {date} | Validation | {qa} |
-| {date} | Fermé | {pm} |
+## 3. Analyse
+### Root Cause (5 Whys)
+### Specs impactées (BR/FR/UC)
+### Code impacté
+
+## 4. Solution
+### Correction | Fichiers | Tests Gherkin
+
+## 5. Prompt correction
+CONTEXTE: Bug {BUG_ID}
+ROOT CAUSE: {cause}
+CORRECTION: {description}
+FICHIERS: {liste}
+VALIDATION: {scénario Gherkin}
 ```
 
 ---
 
-## STEP 6: Résumé
+## Résumé
 
 ```
-================================================================================
-                    BUG DOCUMENTÉ - {BUG_ID}
-================================================================================
-
-FICHIER:           {BUG_DIR}/{BUG_ID}.md
-FEATURE LIÉE:      {FEATURE_ID ou "N/A"}
-SÉVÉRITÉ:          {sévérité}
-ROOT CAUSE:        {résumé}
-
-SPECS IMPACTÉES:
-  • BR: {liste ou "Aucune"}
-  • FR: {liste ou "Aucune"}
-  • UC: {liste ou "Aucune"}
-
-================================================================================
-CORRECTION
-================================================================================
-
-Utilisez le prompt de correction dans la section 5 pour demander
-à Claude de corriger ce bug.
-
-Si c'est un hotfix urgent, utilisez:
-  /business-analyse:hotfix {BUG_ID}
-
-================================================================================
-
-Contact support: support@atlshub.ch
+BUG - {BUG_ID}
+├── Feature: {FEATURE_ID}
+├── Sévérité: {X}
+├── Root Cause: {résumé}
+├── Specs: BR-XXX, FR-XXX, UC-XXX
+└── Correction: /business-analyse:hotfix {BUG_ID}
 ```