@atlashub/smartstack-cli 1.34.0 → 1.36.0

package/templates/skills/business-analyse/steps/step-01-discover.md

@@ -1,27 +1,23 @@
 ---
 name: step-01-discover
 description: Discovery phase - Elicitation with ULTRATHINK (load questionnaire progressively)
-model: opus
-prev_step: steps/step-00-init.md
 next_step: steps/step-02-analyse.md
 ---
 
-<objective>
+## YOUR TASK:
+
 Conduct comprehensive requirements elicitation using ULTRATHINK mode.
 Load questionnaire categories progressively based on feature type.
-</objective>
 
-<ultrathink>
-ULTRATHINK MODE ACTIVE - Critical thinking required:
-- Consider ALL edge cases before formulating questions
-- Challenge EVERY stakeholder assumption
-- Anticipate UNEXPRESSED needs
-- Validate completeness before proceeding
-- DO NOT accept vague answers
-- DO NOT skip question categories
-</ultrathink>
+> **ULTRATHINK MODE:**
+> - Consider ALL edge cases before formulating questions
+> - Challenge EVERY stakeholder assumption
+> - Anticipate UNEXPRESSED needs
+> - Validate completeness before proceeding
+> - DO NOT accept vague answers
+> - DO NOT skip question categories
 
-## EXECUTION SEQUENCE
+## EXECUTION SEQUENCE:
 
 ### 1. Read Current State
 
@@ -32,9 +28,18 @@ Read `{output_dir}/00-context.md` to restore:
 - `{module_name}`
 - `{auto_mode}`
 - `{economy_mode}`
+- `{language}` (défaut: `fr`)
 
 Update progress: `01-discover` -> "In Progress"
 
+**Read digest from previous step:**
+Read `{output_dir}/digest-00.md` for compressed context from step-00.
+**DO NOT read full output files** unless in resume mode (`-r`).
+
+> **LANGUE :** Toute communication via `AskUserQuestion` (questions, options, reformulations, relances)
+> doit être dans `{language}`. Les exemples ci-dessous sont en français — adapter si `{language}` ≠ `fr`.
+> Voir `_shared.md` → "Configuration Langue de Communication" pour les règles complètes.
+
 ---
 
 ### 2. Determine Feature Type
@@ -54,113 +59,468 @@ Store: `{feature_type}`
 
 ---
 
-### 3. Load Questionnaire Categories (Progressive)
+### 3. Explore Codebase FIRST (Pre-Research)
+
+> **RULE: Explore BEFORE asking questions. Informed questions > generic questions.**
+
+**Purpose:** Understand what already exists to ask targeted questions, not generic ones.
+
+**Phase 3a: MCP SmartStack (si disponible)**
+
+> Appeler les outils MCP SmartStack pour obtenir le contexte architectural.
+> Si le MCP n'est pas disponible, passer directement à la phase 3b.
+
+```
+MCP Call 1: analyze_extension_points
+  → Découvrir les modules, entités et points d'extension existants
+  → Résultat : liste des modules, entités, services disponibles
+
+MCP Call 2: api_docs (pour l'application cible)
+  → Consulter la documentation API existante de {application_name}
+  → Résultat : endpoints existants, DTOs, permissions
+
+MCP Call 3: validate_conventions (vérification préliminaire)
+  → Vérifier que le nom {module_name} respecte les conventions
+  → Résultat : validation ou suggestion de correction
+```
+
+**Phase 3b: Exploration codebase (agents parallèles)**
+
+```
+Agent 1: Modules existants dans l'application
+  "Search for existing modules in src/SmartStack.Domain/Entities/Business/{application_name}/
+   and src/SmartStack.Application/Features/{application_name}/.
+   List entities, their attributes, and relationships."
+
+Agent 2: Intégrations et services liés
+  "Search for existing APIs, services, and integrations in
+   src/SmartStack.Application/Features/ that {module_name} might connect with.
+   List SignalR hubs, background jobs, external API clients."
+
+Agent 3: Patterns UI (si UI-centric ou Full module)
+  "Search for existing pages in web/smartstack-web/src/pages/business/{application_name}/
+   List page structures, components used, and navigation patterns."
+```
+
+If `{economy_mode}` = true:
+- MCP tools remain available (use for validation)
+- Skip subagent exploration (phase 3b agents)
+- Use direct Glob/Grep tools for codebase exploration
+- Read 3-5 most relevant files directly
+
+**Store findings as `{codebase_context}`:**
+
+```markdown
+## Codebase Context
+
+### MCP SmartStack (si appelé)
+- Extension points: {list from analyze_extension_points}
+- API existante: {summary from api_docs}
+- Convention check: {result from validate_conventions}
+
+### Exploration codebase
+- Entités existantes dans {application_name}: {list}
+- Modules liés: {list}
+- Patterns existants: {entity base classes, CQRS structure}
+- Connexions potentielles: {shared entities, APIs, events}
+```
+
+**Use `{codebase_context}` to:**
+- Adapter les options des questions (proposer les entités existantes comme relations)
+- Sauter les questions déjà répondues par le codebase
+- Détecter les conflits avec les modules existants tôt
+- Proposer les patterns d'intégration disponibles (notifications, workflow, IA)
+
+---
+
+### 4. Load Questionnaire Categories (Progressive)
 
 **IMPORTANT: Load ONLY relevant categories to minimize context!**
 
 #### Always load (core):
 ```
 Read: questionnaire/01-context.md      # ~50 lines
-Read: questionnaire/02-stakeholders.md # ~40 lines
-Read: questionnaire/03-scope.md        # ~35 lines
-Read: questionnaire/06-security.md     # ~30 lines (minimal)
+Read: questionnaire/02-stakeholders.md # ~70 lines
+Read: questionnaire/03-scope.md        # ~60 lines
+Read: questionnaire/06-security.md     # ~70 lines
 ```
 
 #### Conditional loading based on feature_type:
 ```
 IF {feature_type} = "Data-centric" OR "Full module":
-  Read: questionnaire/04-data.md       # ~45 lines
+  Read: questionnaire/04-data.md          # ~80 lines
+  Read: questionnaire/11-data-lifecycle.md # ~50 lines
 
 IF {feature_type} = "Integration" OR "Full module":
-  Read: questionnaire/05-integrations.md # ~30 lines
+  Read: questionnaire/05-integrations.md  # ~60 lines
 
 IF {feature_type} = "UI-centric" OR "Full module":
-  Read: questionnaire/07-ui.md         # ~20 lines
+  Read: questionnaire/07-ui.md           # ~60 lines
 
 IF {feature_type} = "Reporting" OR performance-critical:
-  Read: questionnaire/08-performance.md # ~25 lines
+  Read: questionnaire/08-performance.md  # ~55 lines
 
 IF {feature_type} = "Workflow" OR constraints exist:
-  Read: questionnaire/09-constraints.md # ~25 lines
+  Read: questionnaire/09-constraints.md  # ~55 lines
 
 IF documentation required:
-  Read: questionnaire/10-documentation.md # ~20 lines
+  Read: questionnaire/10-documentation.md # ~55 lines
+
+ALWAYS for new modules (not enhancements):
+  Read: questionnaire/12-migration.md     # ~50 lines
+  Read: questionnaire/13-cross-module.md  # ~50 lines
 ```
 
-**Maximum context per discovery: ~150-200 lines** (vs 283 lines before)
+---
+
+### 5. Conduct Elicitation (INTERACTIVE)
+
+> **RULE: Use `AskUserQuestion` for EVERY question batch. NEVER list questions as text.**
+> See `_shared.md` → "Interactive Elicitation Protocol" for the full protocol.
+
+**Flow per category:**
+1. Ask batch of max 4 questions via `AskUserQuestion` with predefined options
+2. Process answers → apply ULTRATHINK + Elicitation Techniques
+3. If answers are vague/insufficient → follow-up `AskUserQuestion` with targeted probes
+4. Summarize understanding to user before moving to next category
+5. Repeat for next category
 
 ---
 
-### 4. Conduct Elicitation
+#### 5.1 Category 1: Business Context (ALWAYS)
 
-#### 4.1 Category 1: Business Context (ALWAYS)
+**Batch 1 — Fundamental Need (Q1.1-Q1.4):**
 
-Ask questions from `01-context.md`:
-- Q1.1: Business problem to solve?
-- Q1.2: Current situation (AS-IS)?
-- Q1.3: Target situation (TO-BE)?
-- Q1.4: Measurable KPIs?
-- Q1.5-Q1.8: Business value questions
+```
+AskUserQuestion([
+  { question: "Quel problème métier ce module doit-il résoudre ?",
+    header: "Problème",
+    options: [
+      { label: "Processus manuel", description: "Automatiser un processus existant fait manuellement" },
+      { label: "Données dispersées", description: "Centraliser des données dans plusieurs outils/fichiers" },
+      { label: "Manque visibilité", description: "Obtenir des indicateurs et du suivi inexistants" },
+      { label: "Conformité", description: "Répondre à une obligation réglementaire ou sécurité" }
+    ], multiSelect: false },
+  { question: "Comment ce processus est-il géré aujourd'hui (AS-IS) ?",
+    header: "AS-IS",
+    options: [
+      { label: "Excel/fichiers", description: "Géré via Excel, fichiers partagés ou emails" },
+      { label: "Autre logiciel", description: "Un outil existant qui ne convient plus" },
+      { label: "100% manuel", description: "Processus entièrement papier ou oral" },
+      { label: "Partiellement auto", description: "Partiellement automatisé mais avec des lacunes" }
+    ], multiSelect: false },
+  { question: "Quelle est la situation cible (TO-BE) ?",
+    header: "TO-BE",
+    options: [
+      { label: "CRUD complet", description: "Gestion complète (lister, créer, modifier, supprimer)" },
+      { label: "Workflow", description: "Processus avec étapes, validations, transitions" },
+      { label: "Dashboard + KPIs", description: "Tableau de bord avec indicateurs de suivi" },
+      { label: "Intégration", description: "Connexion avec un système externe existant" }
+    ], multiSelect: true },
+  { question: "Comment mesurerez-vous le succès (KPIs) ?",
+    header: "KPIs",
+    options: [
+      { label: "Temps gagné", description: "Réduction du temps de traitement (ex: -50%)" },
+      { label: "Erreurs réduites", description: "Diminution des erreurs de saisie ou d'oubli" },
+      { label: "Adoption", description: "Nombre d'utilisateurs actifs / fréquence d'utilisation" },
+      { label: "Pas défini", description: "Les KPIs restent à définir avec le métier" }
+    ], multiSelect: true }
+])
+```
 
-**ULTRATHINK checkpoint:**
-- Is the problem clearly defined?
-- Are success criteria measurable?
-- What happens if NOT developed?
+**ULTRATHINK checkpoint after batch 1:**
+- If "Other" → apply Technique 3 (Concrete Scenario) via follow-up AskUserQuestion
+- If KPI = "Pas défini" → apply Technique 4 (Absence Test) via follow-up
+- If answer is solution-oriented → apply Technique 1 (Solution → Problem Reframing)
+
+**Batch 2 — Business Value (Q1.5-Q1.8):**
+
+```
+AskUserQuestion([
+  { question: "Quel ROI attendez-vous ? (temps, argent, efficacité)",
+    header: "ROI",
+    options: [
+      { label: "Gain de temps", description: "Heures/jours économisés par semaine/mois" },
+      { label: "Réduction coûts", description: "Économies directes (licences, ressources, erreurs)" },
+      { label: "Revenus", description: "Impact direct sur le chiffre d'affaires" },
+      { label: "Qualitatif", description: "Satisfaction, conformité, image — non chiffrable" }
+    ], multiSelect: true },
+  { question: "Que se passe-t-il si ce module n'est PAS développé ?",
+    header: "Sans module",
+    options: [
+      { label: "Bloquant", description: "Impossible de continuer sans (réglementaire, technique)" },
+      { label: "Dégradé", description: "On continue avec l'existant mais avec des inefficacités" },
+      { label: "Risque", description: "Risque croissant (erreurs, perte de données, non-conformité)" },
+      { label: "Confort", description: "Pas d'impact critique, amélioration de confort" }
+    ], multiSelect: false },
+  { question: "Priorité par rapport aux autres besoins ?",
+    header: "Priorité",
+    options: [
+      { label: "Critique", description: "Doit être livré en premier, bloque d'autres projets" },
+      { label: "Haute", description: "Important mais pas bloquant" },
+      { label: "Moyenne", description: "Souhaité mais peut attendre" },
+      { label: "Basse", description: "Nice-to-have" }
+    ], multiSelect: false }
+])
+```
+
+---
+
+#### 5.2 Category 2: Stakeholders (ALWAYS)
 
-#### 4.2 Category 2: Stakeholders (ALWAYS)
+**Batch 1 — Identification (Q2.1-Q2.4):**
 
-Ask questions from `02-stakeholders.md`:
-- Q2.1-Q2.4: Identification
-- Q2.5-Q2.8: Needs per role
+```
+AskUserQuestion([
+  { question: "Qui sont les utilisateurs directs de ce module ?",
+    header: "Utilisateurs",
+    options: [
+      { label: "Opérationnel", description: "Utilisateurs quotidiens qui saisissent/consultent" },
+      { label: "Manager", description: "Responsables qui valident, supervisent, consultent les KPIs" },
+      { label: "Admin", description: "Administrateurs qui configurent et gèrent les accès" },
+      { label: "Externe", description: "Clients, fournisseurs, partenaires" }
+    ], multiSelect: true },
+  { question: "Qui sont les bénéficiaires indirects ?",
+    header: "Indirects",
+    options: [
+      { label: "Direction", description: "Reçoit des reportings ou KPIs" },
+      { label: "Support", description: "Équipe support qui aide les utilisateurs" },
+      { label: "Audit", description: "Auditeurs internes/externes (conformité)" },
+      { label: "Aucun", description: "Pas de bénéficiaire indirect identifié" }
+    ], multiSelect: true },
+  { question: "Qui est le décideur final (sponsor) ?",
+    header: "Sponsor",
+    options: [
+      { label: "Direction métier", description: "Directeur du département demandeur" },
+      { label: "Chef de projet", description: "PM/PO qui pilote le développement" },
+      { label: "DSI/CTO", description: "Direction technique" },
+      { label: "Comité", description: "Décision collégiale (comité de pilotage)" }
+    ], multiSelect: false }
+])
+```
 
 **ULTRATHINK checkpoint:**
-- All user types identified?
-- Pain points documented per role?
-- Decision maker confirmed?
+- If only 1-2 user types → probe with Technique 5: "Et les auditeurs, le support, les processus automatisés ?"
+- If no "Admin" → SmartStack requires admin role, clarify
+- If "Externe" → follow-up: portal, API, or shared access?
 
-#### 4.3 Category 3: Scope (ALWAYS)
+**Batch 2 — Needs per role (Q2.5-Q2.8):**
 
-Ask questions from `03-scope.md`:
-- Q3.1-Q3.4: MoSCoW prioritization
-- Q3.5-Q3.8: Process flows
+For **EACH role** identified in batch 1, ask:
+
+```
+AskUserQuestion([
+  { question: "Pour {role}: quelles tâches principales ?",
+    header: "{role}",
+    options: [
+      { label: "Consulter", description: "Visualiser, rechercher, filtrer les données" },
+      { label: "Saisir/Modifier", description: "Créer et modifier des enregistrements" },
+      { label: "Valider/Approuver", description: "Valider des actions, changer des statuts" },
+      { label: "Exporter/Reporting", description: "Extraire des données, générer des rapports" }
+    ], multiSelect: true },
+  { question: "Fréquence d'utilisation pour {role} ?",
+    header: "Fréquence",
+    options: [
+      { label: "Plusieurs fois/jour", description: "Outil de travail quotidien principal" },
+      { label: "1 fois/jour", description: "Consultation ou saisie quotidienne ponctuelle" },
+      { label: "Hebdomadaire", description: "Revues ou points hebdomadaires" },
+      { label: "Mensuelle/rare", description: "Clôture, audit, utilisation exceptionnelle" }
+    ], multiSelect: false },
+  { question: "Principal point de douleur actuel de {role} ?",
+    header: "Frustration",
+    options: [
+      { label: "Lenteur", description: "Le processus actuel prend trop de temps" },
+      { label: "Erreurs", description: "Saisies en double, incohérences, oublis" },
+      { label: "Manque info", description: "Pas de visibilité sur l'état ou les indicateurs" },
+      { label: "Aucun outil", description: "Tout est fait manuellement sans outil" }
+    ], multiSelect: true }
+])
+```
+
+---
+
+#### 5.3 Category 3: Scope (ALWAYS)
+
+**Batch 1 — MoSCoW (Q3.1-Q3.4):**
+
+```
+AskUserQuestion([
+  { question: "Fonctionnalités ESSENTIELLES (Must-Have v1) ?",
+    header: "Must-Have",
+    options: [
+      { label: "CRUD complet", description: "Liste + Création + Modification + Suppression" },
+      { label: "Recherche/Filtres", description: "Recherche textuelle et filtres combinables" },
+      { label: "Workflow/Validation", description: "Processus de validation avec statuts" },
+      { label: "Import/Export", description: "Import de données existantes et/ou export" }
+    ], multiSelect: true },
+  { question: "Fonctionnalités SOUHAITÉES (Should-Have v2) ?",
+    header: "Should-Have",
+    options: [
+      { label: "Dashboard/KPIs", description: "Tableau de bord avec indicateurs visuels" },
+      { label: "Notifications", description: "Alertes email ou in-app sur événements" },
+      { label: "Historique/Audit", description: "Historique détaillé des modifications" },
+      { label: "Intégrations", description: "Connexion avec d'autres modules/systèmes" }
+    ], multiSelect: true },
+  { question: "Qu'est-ce qui est EXCLU du périmètre ?",
+    header: "Exclusions",
+    options: [
+      { label: "Mobile", description: "Pas d'accès mobile pour la v1" },
+      { label: "Reporting avancé", description: "Pas de rapports complexes ou BI" },
+      { label: "Multi-langue contenu", description: "UI i18n, mais pas le contenu métier" },
+      { label: "Rien d'exclu", description: "Pas d'exclusion explicite" }
+    ], multiSelect: true }
+])
+```
 
 **ULTRATHINK checkpoint:**
-- Must-Have vs Should-Have clear?
-- Exclusions explicit?
-- Main flow documented?
+- If "Rien d'exclu" → anti-pattern "Scope illimité" → probe exclusions
+- If > 5 Must-Have → "Sans cette fonctionnalité, le module a ZÉRO valeur ?"
+
+**Batch 2 — Process flow (Q3.5-Q3.8):**
+
+```
+AskUserQuestion([
+  { question: "Quel est le parcours principal de l'utilisateur ?",
+    header: "Flow",
+    options: [
+      { label: "Liste → Détail → Action", description: "Consulte liste, ouvre élément, agit" },
+      { label: "Formulaire → Validation", description: "Saisie, validation métier, confirmation" },
+      { label: "Dashboard → Drill-down", description: "Vue d'ensemble puis exploration détails" },
+      { label: "Workflow multi-étapes", description: "Processus séquentiel avec transitions" }
+    ], multiSelect: false },
+  { question: "Y a-t-il des points de décision dans le flux ?",
+    header: "Décisions",
+    options: [
+      { label: "Approbation manager", description: "Un supérieur doit valider" },
+      { label: "Condition données", description: "Le flux change selon un champ (montant, type)" },
+      { label: "Choix utilisateur", description: "L'utilisateur choisit une branche" },
+      { label: "Aucun", description: "Flux linéaire sans branchement" }
+    ], multiSelect: true },
+  { question: "Quels cas d'erreur faut-il gérer ?",
+    header: "Erreurs",
+    options: [
+      { label: "Doublon", description: "Tentative de créer un enregistrement existant" },
+      { label: "Données invalides", description: "Champs requis manquants, formats incorrects" },
+      { label: "Permission refusée", description: "L'utilisateur n'a pas les droits" },
+      { label: "Dépendance manquante", description: "Entité référencée supprimée/inexistante" }
+    ], multiSelect: true }
+])
+```
+
+---
+
+#### 5.4 Additional Categories (CONDITIONAL)
+
+For each loaded conditional category (04-10), follow the same interactive protocol:
+
+1. **Read the questionnaire file** for the category
+2. **Formulate `AskUserQuestion` batches** based on the questions and their Elicitation Guide
+3. **Use predefined options** adapted to the category context
+4. **Apply follow-ups** if answers are vague (see each file's Elicitation Guide)
+5. **Check anti-patterns** listed in the questionnaire
+
+Document each response with:
+- Confidence level: **Confirmed** (clear answer) / **To validate** (vague, needs follow-up) / **Hypothesis** (inferred by BA)
+- Follow-up questions if quality is insufficient
+
+#### 5.5 Reformulation Loop (AFTER EACH CATEGORY)
+
+> **RULE: After each category, reformulate understanding and validate with user.**
 
-#### 4.4 Additional Categories (CONDITIONAL)
+After completing a category's batches, display a concise summary and ask for validation:
 
-For each loaded category, conduct targeted elicitation.
-Document responses with:
-- Source (who answered)
-- Confidence level (Confirmed/To validate/Hypothesis)
-- Follow-up questions
+```
+AskUserQuestion([
+  { question: "Voici ce que j'ai compris pour {category_name}:
+    {bullet_point_summary}
+    Est-ce correct ?",
+    header: "Validation",
+    options: [
+      { label: "Correct", description: "La compréhension est fidèle, on continue" },
+      { label: "Partiellement", description: "Il y a des nuances ou corrections à apporter" },
+      { label: "Incorrect", description: "Mauvaise compréhension, il faut reprendre" }
+    ], multiSelect: false }
+])
+```
+
+- If **"Correct"** → proceed to next category
+- If **"Partiellement"** → ask: "Quelles corrections ou nuances souhaitez-vous apporter ?" (free text follow-up)
+- If **"Incorrect"** → re-ask the category with refined questions based on feedback
+
+**This loop prevents misunderstandings from propagating through all subsequent phases.**
 
 ---
 
-### 5. Explore Codebase (if economy_mode = false)
+#### 5.6 Risk Analysis
 
-**Launch parallel exploration agents:**
+> **RULE: Identifier les risques PENDANT la discovery, pas après.**
 
 ```
-Agent 1: Existing patterns
-  "Search for similar modules in src/SmartStack.Domain/Entities/
-   and src/SmartStack.Application/Features/ to understand patterns"
+AskUserQuestion([
+  { question: "Quels risques métier identifiez-vous ?",
+    header: "Risques",
+    options: [
+      { label: "Adoption", description: "Les utilisateurs pourraient ne pas utiliser le module" },
+      { label: "Données", description: "Qualité ou migration des données existantes problématique" },
+      { label: "Processus", description: "Le processus actuel est mal compris ou va changer" },
+      { label: "Dépendance", description: "Dépend d'un autre module/système pas encore prêt" }
+    ], multiSelect: true },
+  { question: "Quels risques techniques anticipez-vous ?",
+    header: "Tech",
+    options: [
+      { label: "Performance", description: "Volume de données ou charge utilisateur élevé" },
+      { label: "Intégration", description: "Connexion avec un système externe complexe" },
+      { label: "Sécurité", description: "Données sensibles, conformité, audit" },
+      { label: "Aucun identifié", description: "Pas de risque technique particulier" }
+    ], multiSelect: true },
+  { question: "Quels risques organisationnels ?",
+    header: "Orga",
+    options: [
+      { label: "Disponibilité", description: "Les parties prenantes ne seront pas disponibles pour valider" },
+      { label: "Changement", description: "Les besoins risquent de changer en cours de développement" },
+      { label: "Formation", description: "Les utilisateurs auront besoin de formation" },
+      { label: "Aucun identifié", description: "Pas de risque organisationnel particulier" }
+    ], multiSelect: true }
+])
+```
+
+Pour chaque risque identifié, classifier :
 
-Agent 2: Related integrations
-  "Search for existing APIs and integrations that this module
-   might need to connect with"
+| Probabilité | Impact | Priorité |
+|-------------|--------|----------|
+| Haute | Haut | **Critique** — mitigation obligatoire |
+| Haute | Bas | **Moyen** — surveiller |
+| Basse | Haut | **Moyen** — plan de contingence |
+| Basse | Bas | **Faible** — accepter |
 
-Agent 3: UI patterns (if UI-centric)
-  "Search for similar pages in web/smartstack-web/src/pages/business/
-   to understand React patterns"
+---
+
+#### 5.7 Acceptance Criteria Co-construction
+
+> **RULE: Les critères d'acceptation sont CO-CONSTRUITS avec le client, pas inférés.**
+
+Pour chaque fonctionnalité Must-Have identifiée en Q3.1, proposer des critères et les valider :
+
+```
+AskUserQuestion([
+  { question: "Pour '{must_have_feature}', ces critères d'acceptation sont-ils corrects ?
+    - AC-{N}: {criterion_proposed_by_BA}
+    - AC-{N+1}: {criterion_proposed_by_BA}
+    - AC-{N+2}: {criterion_proposed_by_BA}",
+    header: "Acceptation",
+    options: [
+      { label: "Corrects", description: "Les critères sont bons tels quels" },
+      { label: "À compléter", description: "Il manque des critères importants" },
+      { label: "À modifier", description: "Certains critères ne sont pas bons" }
+    ], multiSelect: false }
+])
 ```
 
-If `{economy_mode}` = true:
-- Use direct Glob/Grep tools only
-- Read 3-5 most relevant files
-- Skip subagents
+- Si **"À compléter"** → demander quels critères ajouter (texte libre)
+- Si **"À modifier"** → demander quelles corrections apporter
+- Répéter pour chaque fonctionnalité Must-Have
+
+**Résultat :** Liste de critères **validés par le client**, pas supposés par le BA.
 
 ---
 
@@ -216,17 +576,78 @@ Compile all findings into structured format:
 |------|------------|--------|
 {From loaded constraint categories}
 
-## 6. Acceptance Criteria (Inferred)
+## 6. Codebase Context
+
+### 6.1 Existing Modules
+{From step 3 pre-research}
+
+### 6.2 Cross-Module Impact
+{From questionnaire/13-cross-module.md if loaded}
+
+### 6.3 Migration Considerations
+{From questionnaire/12-migration.md if loaded}
+
+## 7. Data Lifecycle
+{From questionnaire/11-data-lifecycle.md if loaded}
+
+## 8. Identified Risks
+
+| Type | Risk | Probability | Impact | Priority | Mitigation |
+|------|--------|-------------|--------|----------|------------|
+{Table from section 5.6}
 
-- [ ] AC-001: {criterion 1}
-- [ ] AC-002: {criterion 2}
+## 9. Critères d'Acceptation (Co-construits)
+
+> Validés avec le client — voir section 5.7
+
+- [ ] AC-001: {criterion 1} ✅ Validé
+- [ ] AC-002: {criterion 2} ✅ Validé
 ...
 ```
 
 ---
 
+### 6b. Generate Context Digest
+
+**Write digest to:** `{output_dir}/digest-01.md`
+
+```markdown
+# Digest: Step 01 - Discovery
+
+## Changes
+- {output_dir}/1-discovery.md: Discovery document created
+
+## Decisions
+- Feature type: {feature_type}
+- Categories loaded: {list of loaded categories}
+- Elicitation approach: {interactive with N batches}
+
+## Findings
+- Codebase context: {summary of pre-research findings}
+- Risk count: {count from section 5.6}
+- Open questions: {count}
+
+## State Updates
+| Variable | New Value |
+|----------|-----------|
+| feature_type | {feature_type} |
+| categories_loaded | {list} |
+| questions_answered | {count} |
+| open_questions | {count} |
+| acceptance_criteria_count | {count} |
+
+## For Next Step
+- {count} business rules implicit in discovery responses
+- {count} entities mentioned by stakeholders
+- Key constraints: {top 3 constraints}
+- Risk register: {count} risks identified ({count} critical)
+```
+
+---
+
 ### 7. Save Output
 
+
 Write to: `{output_dir}/1-discovery.md`
 
 Update `00-context.md`:
@@ -238,15 +659,17 @@ Update `00-context.md`:
 ### 8. Display Summary and Load Next Step
 
 **Display:**
-```
-DISCOVERY - {feature_id}
-├── Status: Complete
-├── Categories loaded: {list of loaded categories}
-├── Questions answered: {count}
-├── Open questions: {count}
-├── Output: {output_dir}/1-discovery.md
-└── Next: step-02-analyse (BRD formalization)
-```
+
+| Field | Value |
+|-------|-------|
+| Step | DISCOVERY |
+| Feature | {feature_id} |
+| Status | Complete |
+| Categories loaded | {list of loaded categories} |
+| Questions answered | {count} |
+| Open questions | {count} |
+| Output | {output_dir}/1-discovery.md |
+| Next | step-02-analyse (BRD formalization) |
 
 **If NOT auto_mode:**
 Ask: "Proceed with business rules analysis?"
@@ -258,10 +681,32 @@ Read and execute: steps/step-02-analyse.md
 
 ---
 
-## OUTPUT
+## OUTPUT FORMAT:
 
 This step produces:
 - `{output_dir}/1-discovery.md` (created)
 - `{output_dir}/00-context.md` (updated with AC)
 
 Questionnaire categories loaded: **~150-200 lines max** (70% reduction)
+
+## ERROR HANDLING:
+
+**If user abandons questionnaire mid-way:**
+1. Save partial discovery with answers collected so far
+2. Mark open categories as "Incomplete"
+3. Update 00-context.md with partial progress
+4. Allow resume with `/business-analyse -r {feature_id}`
+
+**If MCP exploration fails (phase 3a):**
+1. Log warning: "MCP unavailable, using manual exploration"
+2. Continue with phase 3b (codebase agents) or Glob/Grep
+3. Note in discovery: "MCP context unavailable"
+
+**If codebase exploration returns empty:**
+1. Assume greenfield module
+2. Skip cross-reference questions
+3. Note: "No existing patterns found"
+
+## NEXT STEP:
+
+After completion, proceed to `steps/step-02-analyse.md`