@atlashub/smartstack-cli 1.1.0

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

@@ -0,0 +1,325 @@
+---
+description: Bug resolution documentation and specification (ULTRATHINK)
+agent: ba-bug
+model: sonnet
+---
+
+# Documentation Bug - Business Analyse
+
+> **Modèle:** Sonnet (analyse root cause)
+> **Output:** `.business-analyse/.../tracking/bugs/BUG-XXX.md`
+
+---
+
+## 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)           ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## STEP 1: Collecte des informations
+
+```javascript
+AskUserQuestion({
+  questions: [
+    {
+      question: "Quelle feature est impactée par ce bug?",
+      header: "Feature",
+      options: [
+        { label: "Feature existante", description: "Bug sur une feature documentée" },
+        { label: "Nouvelle", description: "Bug sur code non documenté en BA" }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "Quelle est la sévérité du bug?",
+      header: "Sévérité",
+      options: [
+        { label: "Critique", description: "Bloque l'utilisation, perte de données" },
+        { label: "Majeur", description: "Fonctionnalité principale impactée" },
+        { label: "Mineur", description: "Workaround possible" },
+        { label: "Cosmétique", description: "UI/UX, pas d'impact fonctionnel" }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "Le bug est-il 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" }
+      ],
+      multiSelect: false
+    }
+  ]
+})
+```
+
+---
+
+## 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)
+
+| # | Question | Réponse |
+|---|----------|---------|
+| 1 | Pourquoi le bug se produit? | {réponse} |
+| 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}
+```
+
+---
+
+## 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)
+
+---
+
+## 7. Prévention
+
+### Comment éviter ce type de bug à l'avenir?
+
+| Action | Responsable | Deadline |
+|--------|-------------|----------|
+| {action préventive} | {qui} | {quand} |
+
+---
+
+## Historique
+
+| Date | Action | Par |
+|------|--------|-----|
+| {date} | Création | {auteur} |
+| {date} | Analyse | {auteur} |
+| {date} | Correction | {dev} |
+| {date} | Validation | {qa} |
+| {date} | Fermé | {pm} |
+```
+
+---
+
+## STEP 6: 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
+```

package/templates/commands/business-analyse/change-request.md

@@ -0,0 +1,368 @@
+---
+description: Phase 10 - Change Request - Formal specification change during development
+agent: ba-change-request
+model: sonnet
+---
+
+# Change Request - Modification Post-Handoff
+
+> **Modèle:** Sonnet (analyse d'impact)
+> **Usage:** Changement de scope après validation/handoff
+> **Output:** `.business-analyse/.../tracking/changes/CR-FEAT-XXX-NNN.md`
+
+---
+
+## QUAND UTILISER
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  CHANGE REQUEST: Modification formelle des spécifications                    ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║                                                                              ║
+║  Utiliser APRÈS validation (phase 5) ou handoff (phase 6) quand:             ║
+║                                                                              ║
+║  • Le stakeholder demande une modification de scope                          ║
+║  • Une nouvelle exigence est découverte                                      ║
+║  • Un cas d'usage manquant est identifié                                     ║
+║  • Une règle métier doit être modifiée                                       ║
+║                                                                              ║
+║  PROCESSUS:                                                                  ║
+║  1. Documenter le changement demandé                                         ║
+║  2. Analyser l'impact sur les specs existantes                               ║
+║  3. Estimer l'effort                                                         ║
+║  4. Obtenir approbation                                                      ║
+║  5. Mettre à jour les documents (avec versioning)                            ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## STEP 1: Identification
+
+```bash
+FEATURE_ID=$1
+FEATURE_DIR=$(find .business-analyse -type d -name "${FEATURE_ID}*" | head -1)
+
+if [ -z "$FEATURE_DIR" ]; then
+  echo "❌ ERREUR: Feature $FEATURE_ID non trouvée"
+  exit 1
+fi
+
+# Générer CR ID
+EXISTING_CRS=$(find "$FEATURE_DIR/tracking/changes" -name "CR-*.md" 2>/dev/null | wc -l)
+CR_NUM=$(printf "%03d" $((EXISTING_CRS + 1)))
+CR_ID="CR-${FEATURE_ID}-${CR_NUM}"
+
+CR_DIR="$FEATURE_DIR/tracking/changes"
+mkdir -p "$CR_DIR"
+```
+
+---
+
+## STEP 2: Collecte du changement
+
+```javascript
+AskUserQuestion({
+  questions: [
+    {
+      question: "Quel type de changement est demandé?",
+      header: "Type",
+      options: [
+        { label: "Nouvelle fonctionnalité", description: "Ajouter quelque chose de nouveau" },
+        { label: "Modification existant", description: "Changer un comportement" },
+        { label: "Suppression", description: "Retirer une fonctionnalité" },
+        { label: "Clarification", description: "Préciser une spec ambiguë" }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "Quelle est la priorité de ce changement?",
+      header: "Priorité",
+      options: [
+        { label: "Critique", description: "Bloque la release" },
+        { label: "Haute", description: "Important pour le MVP" },
+        { label: "Moyenne", description: "Souhaitable" },
+        { label: "Basse", description: "Nice-to-have" }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "Ce changement est-il approuvé par le sponsor?",
+      header: "Approbation",
+      options: [
+        { label: "Oui, approuvé", description: "Sponsor a validé" },
+        { label: "En attente", description: "Discussion en cours" },
+        { label: "À soumettre", description: "Pas encore discuté" }
+      ],
+      multiSelect: false
+    }
+  ]
+})
+```
+
+---
+
+## STEP 3: Description détaillée
+
+Collecter:
+- Description du changement demandé
+- Justification business
+- Demandeur (qui a demandé)
+
+---
+
+## STEP 4: Analyse d'impact
+
+### 4.1 Impact sur les documents
+
+Analyser automatiquement les documents existants:
+
+```bash
+# Lire les documents
+DISCOVERY=$(cat "$FEATURE_DIR/1-discovery.md" 2>/dev/null)
+BRD=$(cat "$FEATURE_DIR/2-business-requirements.md" 2>/dev/null)
+FRD=$(cat "$FEATURE_DIR/3-functional-specification.md" 2>/dev/null)
+HANDOFF=$(cat "$FEATURE_DIR/4-development-handoff.md" 2>/dev/null)
+
+# Identifier les sections impactées
+echo "Analyse d'impact en cours..."
+```
+
+### 4.2 Matrice d'impact
+
+| Document | Section | Impact | Modification requise |
+|----------|---------|--------|---------------------|
+| Discovery | Périmètre | {Aucun/Mineur/Majeur} | {description} |
+| BRD | Règles métier | {Aucun/Mineur/Majeur} | {description} |
+| FRD | Use Cases | {Aucun/Mineur/Majeur} | {description} |
+| FRD | Wireframes | {Aucun/Mineur/Majeur} | {description} |
+| FRD | Permissions | {Aucun/Mineur/Majeur} | {description} |
+| Handoff | Instructions | {Aucun/Mineur/Majeur} | {description} |
+
+### 4.3 Impact sur le code (si déjà implémenté)
+
+| Couche | Fichiers impactés | Type de modification |
+|--------|-------------------|---------------------|
+| Domain | {fichiers} | {ajouter/modifier/supprimer} |
+| Application | {fichiers} | {ajouter/modifier/supprimer} |
+| Infrastructure | {fichiers} | {ajouter/modifier/supprimer} |
+| API | {fichiers} | {ajouter/modifier/supprimer} |
+| Frontend | {fichiers} | {ajouter/modifier/supprimer} |
+
+---
+
+## STEP 5: Estimation effort
+
+| Composant | Effort estimé | Complexité |
+|-----------|---------------|------------|
+| Mise à jour specs | {heures} | {Simple/Moyen/Complexe} |
+| Backend | {heures} | {Simple/Moyen/Complexe} |
+| Frontend | {heures} | {Simple/Moyen/Complexe} |
+| Tests | {heures} | {Simple/Moyen/Complexe} |
+| **Total** | **{heures}** | |
+
+---
+
+## STEP 6: Génération du document CR
+
+### Template CR-FEAT-XXX-NNN.md
+
+```markdown
+# {CR_ID} - Change Request
+
+> **Feature:** {FEATURE_ID}
+> **Type:** {Nouvelle fonctionnalité/Modification/Suppression/Clarification}
+> **Priorité:** {Critique/Haute/Moyenne/Basse}
+> **Status:** {En attente/Approuvé/Rejeté/Implémenté}
+> **Date:** {YYYY-MM-DD}
+
+---
+
+## 1. Changement demandé
+
+### Description
+{Description détaillée du changement}
+
+### Justification business
+{Pourquoi ce changement est nécessaire}
+
+### Demandeur
+{Nom et rôle du demandeur}
+
+---
+
+## 2. Analyse d'impact
+
+### 2.1 Documents impactés
+
+| Document | Version actuelle | Impact | Action |
+|----------|-----------------|--------|--------|
+| 1-discovery.md | 1.0 | {impact} | {action} |
+| 2-brd.md | 1.0 | {impact} | {action} |
+| 3-frd.md | 1.0 | {impact} | {action} |
+| 4-handoff.md | 1.0 | {impact} | {action} |
+
+### 2.2 Specs impactées
+
+| Type | ID | Modification |
+|------|----|----|
+| Règle métier | BR-XXX | {Modifier/Ajouter/Supprimer: description} |
+| Use Case | UC-XXX | {Modifier/Ajouter/Supprimer: description} |
+| Exigence | FR-XXX | {Modifier/Ajouter/Supprimer: description} |
+
+### 2.3 Code impacté (si déjà développé)
+
+| Fichier | Modification |
+|---------|--------------|
+| `{path}` | {description} |
+
+---
+
+## 3. Effort estimé
+
+| Composant | Effort | Risque |
+|-----------|--------|--------|
+| Specs | {heures} | {Faible/Moyen/Élevé} |
+| Backend | {heures} | {Faible/Moyen/Élevé} |
+| Frontend | {heures} | {Faible/Moyen/Élevé} |
+| Tests | {heures} | {Faible/Moyen/Élevé} |
+| **Total** | **{heures}** | |
+
+---
+
+## 4. Décision
+
+### Recommandation
+{Accepter/Rejeter/Reporter} ce changement
+
+### Justification
+{Pourquoi cette recommandation}
+
+### Conditions (si accepté)
+- {Condition 1}
+- {Condition 2}
+
+---
+
+## 5. Approbation
+
+| Rôle | Nom | Décision | Date |
+|------|-----|----------|------|
+| Product Owner | {nom} | {Approuvé/Rejeté} | {date} |
+| Tech Lead | {nom} | {Approuvé/Rejeté} | {date} |
+
+---
+
+## 6. Implémentation (si approuvé)
+
+### 6.1 Mise à jour des specs
+
+| Document | Nouvelle version | Modifications |
+|----------|-----------------|---------------|
+| 3-frd.md | 1.1 | {description} |
+
+### 6.2 Prompt de modification
+
+```
+CHANGE REQUEST: {CR_ID}
+
+CHANGEMENT À IMPLÉMENTER:
+{description du changement}
+
+FICHIERS À MODIFIER:
+{liste des fichiers}
+
+TESTS À AJOUTER:
+{scénarios Gherkin}
+
+VALIDATION:
+{critères de validation}
+```
+
+---
+
+## 7. Historique
+
+| Date | Action | Par |
+|------|--------|-----|
+| {date} | CR créé | {auteur} |
+| {date} | Analyse complétée | {auteur} |
+| {date} | {Approuvé/Rejeté} | {décideur} |
+| {date} | Implémenté | {dev} |
+| {date} | Validé | {qa} |
+```
+
+---
+
+## STEP 7: Actions post-approbation
+
+Si le CR est approuvé:
+
+### 7.1 Mise à jour des documents
+
+```bash
+# Incrémenter version des documents impactés
+# 1.0 → 1.1 pour changement mineur
+# 1.0 → 2.0 pour changement majeur
+
+# Ajouter dans l'historique de chaque document:
+# | 1.1 | {date} | BA | CR-FEAT-XXX-001: {description} |
+```
+
+### 7.2 Options d'implémentation
+
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "Comment souhaitez-vous implémenter ce changement?",
+    header: "Action",
+    options: [
+      { label: "Implémentation immédiate", description: "Générer prompt et implémenter maintenant" },
+      { label: "Planifier", description: "Ajouter au backlog pour plus tard" },
+      { label: "Mettre à jour specs seulement", description: "Modifier les documents, implémenter plus tard" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+---
+
+## STEP 8: Résumé
+
+```
+================================================================================
+                    CHANGE REQUEST CRÉÉ - {CR_ID}
+================================================================================
+
+FEATURE:           {FEATURE_ID}
+TYPE:              {type}
+PRIORITÉ:          {priorité}
+STATUS:            {status}
+
+IMPACT:
+  Documents:       {N} impactés
+  Règles métier:   {N} modifiées
+  Code:            {N} fichiers
+
+EFFORT ESTIMÉ:     {N} heures
+
+================================================================================
+PROCHAINES ÉTAPES
+================================================================================
+
+SI APPROUVÉ:
+1. Mettre à jour les specs avec versioning
+2. Générer prompt de modification
+3. Implémenter les changements
+4. Valider et fermer le CR
+
+SI REJETÉ:
+1. Documenter la raison
+2. Archiver le CR
+
+================================================================================
+
+Contact support: support@atlshub.ch
+```