@atlashub/smartstack-cli 2.1.0 → 2.3.0

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

@@ -1,737 +0,0 @@
----
-name: step-01-discover
-description: Discovery phase - Elicitation with ULTRATHINK (load questionnaire progressively)
-next_step: steps/step-02-analyse.md
----
-
-## YOUR TASK:
-
-Conduct comprehensive requirements elicitation using ULTRATHINK mode.
-Load questionnaire categories progressively based on feature type.
-
-> **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:
-
-### 1. Read Current State
-
-Read `{output_dir}/00-context.md` to restore:
-- `{feature_id}`
-- `{feature_description}`
-- `{application_name}`
-- `{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.
-
-> **⚠️ BRANDING :** Ne JAMAIS utiliser le mot "SmartStack" dans les communications utilisateur
-> (questions, résumés, reformulations, synthèses). Utiliser "la plateforme", "l'application",
-> ou "le système" à la place. SmartStack est le nom interne du framework — le projet client
-> a son propre nom. Les références techniques internes (paths, MCP calls) restent inchangées.
-
----
-
-### 2. Determine Feature Type
-
-Analyze `{feature_description}` to categorize:
-
-| Type | Indicators | Load Categories |
-|------|------------|-----------------|
-| **Data-centric** | "management", "CRUD", "entity", "data" | 01, 02, 03, 04, 06 |
-| **Integration** | "API", "sync", "import", "export", "external" | 01, 02, 03, 05, 06 |
-| **UI-centric** | "screen", "form", "dashboard", "interface" | 01, 02, 03, 06, 07 |
-| **Workflow** | "process", "validation", "workflow", "steps" | 01, 02, 03, 06, 09 |
-| **Reporting** | "report", "export", "statistics", "KPI" | 01, 02, 03, 04, 08 |
-| **Full module** | "module", "complete", "feature" | ALL categories |
-
-Store: `{feature_type}`
-
----
-
-### 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 # ~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          # ~80 lines
-  Read: questionnaire/11-data-lifecycle.md # ~50 lines
-
-IF {feature_type} = "Integration" OR "Full module":
-  Read: questionnaire/05-integrations.md  # ~60 lines
-
-IF {feature_type} = "UI-centric" OR "Full module":
-  Read: questionnaire/07-ui.md           # ~60 lines
-
-IF {feature_type} = "Reporting" OR performance-critical:
-  Read: questionnaire/08-performance.md  # ~55 lines
-
-IF {feature_type} = "Workflow" OR constraints exist:
-  Read: questionnaire/09-constraints.md  # ~55 lines
-
-IF documentation required:
-  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
-```
-
----
-
-### 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
-
----
-
-#### 5.1 Category 1: Business Context (ALWAYS)
-
-**Batch 1 — Fundamental Need (Q1.1-Q1.4):**
-
-```
-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 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: "Quel est le déclencheur de ce besoin ?",
-    header: "Déclencheur",
-    options: [
-      { label: "Urgence opérationnelle", description: "Processus bloqué ou inefficace au quotidien" },
-      { label: "Obligation réglementaire", description: "Conformité imposée par une deadline externe" },
-      { label: "Évolution planifiée", description: "Amélioration prévue dans la roadmap" },
-      { label: "Opportunité", description: "Gain identifié, pas de contrainte immédiate" }
-    ], multiSelect: false },
-  { question: "Quel est le délai souhaité de mise en production ?",
-    header: "Délai",
-    options: [
-      { label: "Urgent (< 1 mois)", description: "Besoin immédiat, bloquant des opérations" },
-      { label: "Court terme (1-3 mois)", description: "Planifié pour le prochain cycle" },
-      { label: "Moyen terme (3-6 mois)", description: "Important mais pas immédiat" },
-      { label: "Flexible", description: "Pas de contrainte de délai définie" }
-    ], multiSelect: false }
-])
-```
-
----
-
-#### 5.2 Category 2: Stakeholders (ALWAYS)
-
-**Batch 1 — Identification (Q2.1-Q2.4):**
-
-```
-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:**
-- If only 1-2 user types → probe with Technique 5: "Et les auditeurs, le support, les processus automatisés ?"
-- If no "Admin" → The platform requires an admin role, clarify
-- If "Externe" → follow-up: portal, API, or shared access?
-
-**Batch 2 — Needs per role (Q2.5-Q2.8):**
-
-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: "Y a-t-il des limites connues pour la v1 ?",
-    header: "Limites v1",
-    options: [
-      { label: "Pas de limite identifiée", description: "Le périmètre sera défini par les Must-Have et Should-Have" },
-      { label: "Budget/temps limité", description: "Contrainte qui pourrait réduire le périmètre" },
-      { label: "Dépendance externe", description: "Certaines fonctions dépendent d'un autre système pas encore prêt" },
-      { label: "Complexité technique", description: "Certaines fonctions nécessitent une phase de R&D" }
-    ], multiSelect: true }
-])
-```
-
-**ULTRATHINK checkpoint:**
-- If > 5 Must-Have → "Parmi ces fonctionnalités, lesquelles apportent le plus de valeur pour la v1 ?"
-- If "Pas de limite identifiée" → accept as valid, scope will be naturally bounded by Must-Have/Should-Have
-
-**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.**
-> **IMPORTANT: The `question` field of `AskUserQuestion` does NOT support markdown or line breaks.**
-> **NEVER put long summaries in the `question` field — it becomes an unreadable wall of text.**
-
-After completing a category's batches:
-
-**Step 1: Display the summary as regular text output** (supports markdown formatting):
-
-```
-Output text directly to the user:
-
-## Synthèse - {category_name}
-
-- **Point 1:** {résumé}
-- **Point 2:** {résumé}
-- **Point 3:** {résumé}
-```
-
-**Step 2: Ask for validation with a SHORT question** (no summary in the question field):
-
-```
-AskUserQuestion([
-  { question: "Cette synthèse est-elle correcte ?",
-    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 }
-])
-```
-
-> **⚠️ FORMATTING RULE for `AskUserQuestion`:**
-> Le champ `question` ne supporte PAS le markdown ni les retours à la ligne.
-> Une question simple reste lisible meme longue. Mais ne JAMAIS mettre de contenu
-> structuré (listes à puces, résumés multi-points, tableaux) dans le champ `question`.
-> Pour du contenu structuré → afficher en **texte direct** AVANT l'appel (voir `_shared.md`).
-
-- 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.6 Risk Analysis
-
-> **RULE: Identifier les risques PENDANT la discovery, pas après.**
-
-```
-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 :
-
-| Probabilité | Impact | Priorité |
-|-------------|--------|----------|
-| Haute | Haut | **Critique** — mitigation obligatoire |
-| Haute | Bas | **Moyen** — surveiller |
-| Basse | Haut | **Moyen** — plan de contingence |
-| Basse | Bas | **Faible** — accepter |
-
----
-
-#### 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 }
-])
-```
-
-- 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.
-
----
-
-### 6. Synthesize Discovery
-
-Compile all findings into structured format:
-
-```markdown
-# Discovery - {feature_id} {feature_description}
-
-> **Module:** business/{application_name}/{module_name}
-> **Version:** 1.0
-> **Date:** {timestamp}
-> **Author:** Business Analyst (Claude)
-
-## 1. Business Context
-
-### 1.1 Need Description
-{Synthesized from Q1.1-Q1.4}
-
-### 1.2 Current Problem
-{From Q1.2}
-
-### 1.3 Expected Value
-{From Q1.5-Q1.7, quantified if possible}
-
-## 2. Stakeholders
-
-| Role | Function | Involvement | Decision Level |
-|------|----------|-------------|-----------------|
-{Table from Q2.x responses}
-
-## 3. Scope
-
-### 3.1 In Scope (Must-Have)
-{From Q3.1}
-
-### 3.2 Should-Have
-{From Q3.2}
-
-### 3.3 Out of Scope
-{From Q3.4 - EXPLICIT exclusions}
-
-## 4. Open Questions
-
-| # | Question | Answer | Status |
-|---|----------|--------|--------|
-{Any unresolved questions}
-
-## 5. Identified Constraints
-
-| Type | Constraint | Impact |
-|------|------------|--------|
-{From loaded constraint categories}
-
-## 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}
-
-## 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`:
-- Progress: `01-discover` -> "Complete"
-- Add acceptance criteria to state
-
----
-
-### 8. Display Summary and Load Next Step
-
-**Display:**
-
-| 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?"
-
-**Load next step:**
-```
-Read and execute: steps/step-02-analyse.md
-```
-
----
-
-## 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`