create-byan-agent 2.5.0 → 2.6.1

package/README.md

@@ -1,403 +1,409 @@
-# BYAN v2.5.0 - Build Your AI Network
+# BYAN v2.6.1 — Build Your AI Network
 
-[![npm version](https://img.shields.io/npm/v/create-byan-agent.svg)](https://www.npmjs.com/package/create-byan-agent)
+[![npm](https://img.shields.io/npm/v/create-byan-agent.svg)](https://www.npmjs.com/package/create-byan-agent)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Tests](https://img.shields.io/badge/tests-1308%2F1308-brightgreen.svg)](https://github.com/Yan-Acadenice/BYAN)
+[![Tests](https://img.shields.io/badge/tests-1444%2F1466-brightgreen.svg)](https://github.com/Yan-Acadenice/BYAN)
 [![Node](https://img.shields.io/badge/node-%3E%3D12.0.0-brightgreen.svg)](https://nodejs.org)
 
-**🏛️ Intelligent AI Agent Ecosystem** | Powered by Merise Agile + TDD + 64 Mantras
+**Créateur intelligent d'agents IA** | Merise Agile + TDD + 64 Mantras
 
-Create custom AI agents through intelligent interviews + **Hermes Universal Dispatcher** for intelligent routing across 35+ specialized agents.
+> Documentation en anglais disponible ici : [README-EN.md](./README-EN.md)
 
-### 🎯 New in v2.5.0: Hermes - Universal Dispatcher
+---
 
-**One entry point to rule them all** 🏛️
+## Bonjour
 
-```bash
-@hermes          # → Menu-driven navigation to 35+ agents
-@hermes @dev     # → Direct invocation  
-@hermes rec créer API backend  # → Smart routing
-@hermes pipe feature complète  # → Multi-agent pipelines
-```
+Bonjour à tous ! J'ai l'honneur de vous présenter **BYAN**, votre ami sur vos projets — que vous soyez développeur, vibe codeur ou juste curieux.
 
-**Features:**
-- 🎯 **Smart Routing**: Describe your task → Hermes recommends best agents
-- 🔗 **Pipelines**: Pre-configured multi-agent workflows (Feature Complete, Bug Fix, etc.)
-- 📋 **Agent Directory**: Browse 35+ agents organized by module (core, bmm, bmb, cis, tea)
-- 💰 **Cost Optimizer**: 87.5% LLM cost savings (optional integration)
-- 🌐 **Multi-Platform**: GitHub Copilot CLI, Claude Code, Codex
-- 🪶 **Node 12+ Compatible**: Works on legacy servers
+> **Important :** Je précise que c'est un projet pas fini et plus un MVP/note d'intention qu'une vraie version finale en production. C'est un outil en évolution active, et c'est précisément là où réside son intérêt.
 
-[→ Full Hermes Guide](./install/HERMES-GUIDE.md)
+### Pourquoi BYAN existe
 
----
+Pour comprendre le contexte de BYAN, il faut comprendre pourquoi j'ai décidé de le créer. La problématique de base est simple.
 
-## 🚀 Quick Start
+Je me suis retrouvé avec un gros projet sur les bras, des deadlines très serrées, pas de budget, et une équipe inexpérimentée pour le faire. Ce qui m'a amené à faire des crunchs stupides avec des développeurs en dépression.
 
-### Install & Run
+Pour résoudre ce problème, m'est venue l'idée d'utiliser les agents IA pour accélérer le développement du projet. Grâce à un de mes étudiants en dev (crédité dans les contributeurs du projet) à qui je donne cours, j'ai découvert la méthode **BMAD**, qui est un framework d'agents IA. Au départ sceptique, j'ai été bluffé du résultat, bien que ces agents IA souffraient des biais habituels des IA, en particulier en fonction du modèle utilisé et de qui l'utilise et comment.
 
-```bash
-# Using npx (recommended - no installation needed)
-npx create-byan-agent
+Alors une idée simple est venue : **et si on pouvait mettre un cadre à tous ces agents pour y apporter de "l'intelligence", peu importe le projet, en mettant des règles et contraintes de base pour contrer les biais des modèles d'IA ?**
 
-# Or install globally
-npm install -g create-byan-agent
+C'est là que m'est venue l'idée de leur insuffler des **mantras** — des règles absolues auxquelles l'agent devait se conformer. Des gardes-fous épistémiques, méthodologiques et comportementaux qui transforment un LLM bavard en partenaire fiable.
 
-# Then run
-create-byan-agent
-```
+Maintenant, la problématique se pose en multi-agents : comment faire pour que tous mes agents aient bien ces bonnes pratiques et règles ?
 
-### Programmatic Usage
+Il suffit de les instaurer à la source, c'est-à-dire **à la création des agents**. C'est là que BYAN intervient : il va vous assister dans la création intelligente d'agents IA.
 
-```javascript
-const ByanV2 = require('create-byan-agent');
+### Ce que BYAN n'est pas
 
-const byan = new ByanV2({
-  maxQuestions: 12,
-  outputDir: './_byan-output'
-});
+Par contre, attention : **BYAN n'est pas magique**. Le but est de pousser le "homme-machine" pour faire des agents IA une extension de votre cerveau. Donc BYAN va vous challenger, éprouver votre problème et votre solution — mais mal utilisé, il ne résoudra pas vos problèmes comme par magie.
 
-await byan.startSession();
-
-// Interactive interview (12 questions)
-while (!byan.isComplete()) {
-  const question = byan.getNextQuestion();
-  const answer = await getUserInput(question.text);
-  await byan.submitResponse(answer);
-}
-
-// Generate agent profile
-const profile = await byan.generateProfile();
-console.log('Agent created:', profile.filePath);
-```
+C'est juste un agent intelligent avec les bons softskills et hardskills pour vous accompagner dans la réalisation de vos projets.
 
 ---
 
-## ✨ What's New in v2.1.0
+## Installation
 
-### 4 New BMAD Modules
+### Prérequis
 
-**📚 Glossary Builder** - Auto-builds domain vocabularies
-- Auto-triggers for complex domains (ecommerce, finance, healthcare)
-- Validates definition clarity (min 70%)
-- Suggests related concepts
+- Node.js >= 12.0.0
+- npm >= 6.0.0
+- Un compte GitHub Copilot, Claude Code ou Codex (selon la plateforme cible)
 
-**🔍 Five Whys Analyzer** - Root cause analysis
-- Detects pain points automatically
-- 5 sequential WHY questions
-- Categorizes causes (technical/process/people/resource)
+### Installation rapide (recommandée)
 
-**👂 Active Listener** - Intelligent response processing
-- Auto-reformulation every 3rd response
-- Validates confirmations
-- Session summaries with insights
+Aucune installation préalable n'est nécessaire. Lancez simplement :
 
-**✅ Mantras Validator** - Quality validation
-- 64 BMAD/IA mantras
-- Compliance scoring (target: 80%+)
-- Category-based validation
-
-**417 new tests** | **100% passing** | **95%+ coverage** | **< 10% overhead**
-
----
+```bash
+# Crée un nouveau projet BYAN (via npx, sans installation préalable)
+npx create-byan-agent
 
-## 🎯 Features
+# Ou installation globale
+npm install -g create-byan-agent
+create-byan-agent
+```
 
-### Core Capabilities
+L'installeur (Yanstaller) vous guide interactivement à travers le processus :
 
-- **Intelligent 4-Phase Interview**: Context → Business → Agent Needs → Validation
-- **Automatic Profile Generation**: Creates `.md` agent files with YAML frontmatter
-- **Built-in Validation**: Validates against GitHub Copilot CLI requirements
-- **Template System**: Flexible templates with placeholder resolution
-- **Quality Enforcement**: Zero emoji policy, clean code principles
-- **State Machine Workflow**: INTERVIEW → ANALYSIS → GENERATION → COMPLETED
+```
+? Nom du projet : mon-projet
+? Langue de communication : Francais
+? Plateforme cible : GitHub Copilot CLI
+? Activer le fact-check scientifique ? [Y/n]
+? Activer le système ELO de confiance ? [Y/n]
+? Optimiser les coûts LLM automatiquement (~54% d'économies) ? [Y/n]
+```
 
-### Advanced BMAD Features (v2.1.0)
+### Structure du projet après installation
 
-- **Domain Glossaries**: Auto-build glossaries with clarity validation
-- **Root Cause Analysis**: 5 Whys technique for pain point analysis
-- **Active Listening**: Intelligent reformulation and validation
-- **Mantra Validation**: 64 mantras compliance checking
+À la fin de l'installation, votre projet contient :
 
-### 100% Backwards Compatible
+```
+votre-projet/
+  _byan/               # Plateforme BYAN — cœur du système
+    _config/           # Manifestes des agents et workflows
+    _memory/           # Mémoire persistante (ELO, fact-graph, session-state)
+    agents/            # Agents disponibles (core, bmm, bmb, cis, tea)
+    workflows/         # Workflows guidés
+    knowledge/         # Base de connaissances sources (axiomes, benchmarks)
+    config.yaml        # Configuration principale (langue, utilisateur, chemins)
+  .github/agents/      # Wrappers GitHub Copilot CLI
+  .claude/             # Intégration Claude Code (si activée)
+  .codex/              # Intégration Codex/OpenCode (si activée)
+  bin/byan-v2-cli.js   # CLI BYAN
+```
 
-All v2.0.0 code works unchanged in v2.1.0. BMAD features are opt-in.
+### Commandes CLI disponibles
 
----
+Une fois installé, vous pouvez utiliser le CLI BYAN :
 
-## 📖 Usage Examples
+```bash
+# Lancer l'interview intelligente (crée un agent en 12 questions)
+node bin/byan-v2-cli.js create
 
-### Example 1: Basic Agent Creation
+# Vérifier l'état de la session
+node bin/byan-v2-cli.js status
 
-```javascript
-const ByanV2 = require('create-byan-agent');
+# Système ELO — score de confiance par domaine technique
+node bin/byan-v2-cli.js elo summary
+node bin/byan-v2-cli.js elo context security
+node bin/byan-v2-cli.js elo record javascript VALIDATED
 
-async function createAgent() {
-  const byan = new ByanV2();
-  await byan.startSession();
-  
-  // Answer 12 interview questions
-  await byan.submitResponse('code-review-assistant');
-  await byan.submitResponse('Reviews code for bugs and best practices');
-  // ... 10 more responses
-  
-  const profile = await byan.generateProfile();
-  console.log('✅ Agent created');
-}
+# Fact-check scientifique — vérifier une assertion
+node bin/byan-v2-cli.js fc check "Redis est toujours plus rapide que PostgreSQL"
+node bin/byan-v2-cli.js fc parse "C'est évidemment la meilleure approche"
+node bin/byan-v2-cli.js fc graph
 ```
 
-### Example 2: With BMAD Features
+### Utilisation programmatique (via npm)
 
 ```javascript
 const ByanV2 = require('create-byan-agent');
 
-async function createWithBMAD() {
-  const byan = new ByanV2({
-    bmad_features: {
-      glossary_builder: { enabled: true },
-      five_whys: { enabled: true },
-      active_listener: { enabled: true },
-      mantras_validator: { enabled: true }
-    }
-  });
-  
-  await byan.startSession();
-  
-  // Glossary auto-triggers for complex domains
-  const glossary = byan.startGlossary('ecommerce');
-  byan.addConcept('Order', 'Customer purchase request...');
-  
-  // Pain point detection
-  const detection = byan.detectPainPoints('Slow checkout');
-  if (detection.needsWhys) {
-    const question = byan.askWhy();
-    // ... 5 Whys analysis
-  }
-  
-  // Generate and validate
-  const profile = await byan.generateProfile();
-  const validation = byan.validateAgent(profile.content);
-  
-  console.log(`Score: ${validation.score * 100}%`);
+const byan = new ByanV2({ maxQuestions: 12 });
+await byan.startSession();
+
+// Interview guidée
+while (!byan.isComplete()) {
+  const question = byan.getNextQuestion();
+  const answer = await getUserInput(question.text);
+  await byan.submitResponse(answer);
 }
-```
 
-### Example 3: Validate Existing Agent
+// Générer le profil d'agent
+const profile = await byan.generateProfile();
+console.log('Agent créé :', profile.filePath);
 
-```javascript
-const ByanV2 = require('create-byan-agent');
-const fs = require('fs');
+// Fact-check
+const result = byan.checkClaim("Redis est plus rapide");
+console.log(result.assertionType, result.score + '%');
 
-const byan = new ByanV2({
-  bmad_features: {
-    mantras_validator: { enabled: true }
-  }
-});
+// Score ELO
+const ctx = byan.getClaimContext('security');
+console.log('Scaffold level :', ctx.scaffoldLevel);
+```
+
+### Activer les agents dans GitHub Copilot CLI
 
-const agentContent = fs.readFileSync('my-agent.md', 'utf-8');
-const validation = byan.validateAgent(agentContent);
+Une fois installé, les agents sont disponibles via `@agent-name` :
 
-console.log(`Compliance: ${validation.score * 100}%`);
-console.log(`Compliant: ${validation.compliant.length}/64`);
-console.log(`Non-compliant: ${validation.nonCompliant.length}/64`);
+```bash
+@hermes            # Dispatcher universel — recommande le bon agent
+@byan              # Créateur d'agents (interview intelligente)
+@analyst           # Analyste business (Mary)
+@architect         # Architecte technique (Winston)
+@pm                # Product Manager (John)
+@dev               # Développeur (Amelia)
+@fact-checker      # Fact-check scientifique
+# ... et 30+ autres agents
 ```
 
 ---
 
-## 🔧 Configuration
+## Liste des Agents Disponibles
+
+BYAN contient **27 agents spécialisés** organisés en **5 modules** :
+
+### Core — Fondation de la Plateforme
+
+| Agent | Persona | Rôle | Cas d'usage typique |
+|-------|---------|------|---------------------|
+| **hermes** | Dispatcher | Routeur universel — recommande le bon agent selon votre tâche | "Quel agent pour créer une API REST ?" |
+| **bmad-master** | Orchestrateur | Exécute workflows et tasks BMAD directement | Lancer un workflow complet sans intermédiaire |
+| **yanstaller** | Installeur | Installation intelligente et interactive de BYAN | Setup initial d'un nouveau projet |
+| **expert-merise-agile** | Expert | Conception Merise Agile + MCD/MCT + cahiers des charges | Modélisation d'un schéma de données métier |
+
+### BMB — Créateurs d'Agents et de Modules
+
+| Agent | Persona | Rôle | Cas d'usage typique |
+|-------|---------|------|---------------------|
+| **byan** | Builder | Créateur d'agents via interview intelligente (12 questions, 64 mantras). Intègre [FC] fact-check et [ELO] | Créer un agent spécialisé pour votre domaine |
+| **fact-checker** | Scientifique | Fact-check d'assertions, audit de documents, analyse de chaînes de raisonnement | Vérifier une spec technique avant sprint |
+| **agent-builder** | Bond | Expert en construction d'agents BMAD-compliant | Construire un agent complexe manuellement |
+| **module-builder** | Morgan | Architecte de modules BYAN complets | Créer un nouveau module métier |
+| **workflow-builder** | Wendy | Designer de workflows guidés | Concevoir un processus multi-étapes |
+| **marc** | Spécialiste | Intégration GitHub Copilot CLI | Déployer des agents sur Copilot |
+| **rachid** | Spécialiste | Déploiement npm/npx | Publier un package BYAN |
+| **carmack** | Optimiseur | Optimisation tokens (-46%) | Réduire le coût d'utilisation des agents |
+| **patnote** | Gestionnaire | Mises à jour BYAN et résolution de conflits | Mettre à jour un projet BYAN existant |
+| **claude** | Spécialiste | Intégration Claude Code + MCP | Configurer les agents sur Claude |
+| **codex** | Spécialiste | Intégration OpenCode/Codex | Configurer les agents sur Codex |
+
+### BMM — Cycle de Développement Logiciel
+
+| Agent | Persona | Rôle | Cas d'usage typique |
+|-------|---------|------|---------------------|
+| **analyst** | Mary | Analyse business, étude de marché, brief produit | "J'ai une idée, aide-moi à la structurer" |
+| **pm** | John | Product management, création de PRD, roadmap | Rédiger un Product Requirements Document |
+| **architect** | Winston | Architecture technique, tech stack, patterns | Concevoir l'architecture d'un système |
+| **ux-designer** | Sally | Design UX/UI, empathie utilisateur, parcours | Créer les maquettes et user flows |
+| **dev** | Amelia | Implémentation, coding, ultra-succincte | Développer une user story |
+| **sm** | Bob | Scrum master, sprint planning, backlog grooming | Préparer et planifier un sprint |
+| **quinn** | Quinn | QA engineer, tests, couverture de code | Générer des tests pour une feature |
+| **tech-writer** | Paige | Documentation, guides utilisateur, clarté | Rédiger la doc d'une API |
+| **quick-flow-solo-dev** | Barry | Développement rapide sur code existant (brownfield) | Petites features sans cérémonie |
+
+### CIS — Innovation et Stratégie Créative
+
+| Agent | Persona | Rôle | Cas d'usage typique |
+|-------|---------|------|---------------------|
+| **brainstorming-coach** | Carson | Idéation, énergie "YES AND", 20+ techniques | "J'ai un problème compliqué, aide-moi à penser" |
+| **creative-problem-solver** | Dr. Quinn | Résolution systématique (TRIZ, Theory of Constraints) | Débloquer un problème technique difficile |
+| **design-thinking-coach** | Maya | Design thinking humain-centré, empathie maps | Concevoir une solution centrée utilisateur |
+| **innovation-strategist** | Victor | Stratégie d'innovation, Blue Ocean, disruption | Trouver un angle différenciant pour un produit |
+| **presentation-master** | Caravaggio | Présentations, slides, storytelling visuel | Créer un pitch deck ou une présentation technique |
+| **storyteller** | Sophia | Storytelling, narratives, communication de marque | Rédiger un texte qui engage et convainc |
+
+### TEA — Architecture de Tests
+
+| Agent | Persona | Rôle | Cas d'usage typique |
+|-------|---------|------|---------------------|
+| **tea** | Murat | Master test architect — ATDD, NFR, CI/CD, risk-based testing | Concevoir la stratégie de test complète d'un projet |
+
+### Agents Custom — Créés avec BYAN
+
+| Agent | Persona | Rôle | Cas d'usage typique |
+|-------|---------|------|---------------------|
+| **jimmy** | Jimmy | Spécialiste documentation technique — Runbooks, Infrastructure, Déploiement, Procédures, Web. Publie dans Outline Wiki via API REST | Documenter un runbook serveur, une procédure de déploiement ou une config infrastructure |
 
-### Basic Configuration
+---
 
-```javascript
-const byan = new ByanV2({
-  maxQuestions: 12,
-  outputDir: './_byan-output/bmb-creations',
-  sessionId: 'my-session'
-});
-```
+## Contributeurs
 
-### BMAD Configuration
+### Créateur et Lead Developer
 
-```javascript
-const byan = new ByanV2({
-  bmad_features: {
-    glossary_builder: {
-      enabled: true,
-      auto_trigger_domains: ['ecommerce', 'finance', 'healthcare'],
-      min_concepts: 5,
-      clarity_threshold: 0.7
-    },
-    five_whys: {
-      enabled: true,
-      max_depth: 5,
-      auto_trigger: true
-    },
-    active_listener: {
-      enabled: true,
-      reformulation_frequency: 3
-    },
-    mantras_validator: {
-      enabled: true,
-      min_compliance_score: 0.8
-    }
-  }
-});
-```
+**[Yan-Acadenice](https://github.com/Yan-Acadenice)** — Conception, architecture, développement de BYAN
 
----
+### Contributeur Principal — Agent Hermes
+
+**[Wazadriano](https://github.com/orgs/Centralis-V3/people/Wazadriano)** — Agent Hermes, Dispatcher Universel (v2.3.2)
+- Architecture et conception du dispatcher universel Hermes
+- Règles de routage intelligent et pipelines multi-agents
+- Intégration complète avec l'écosystème BYAN
 
-## 📊 Quality Metrics
+### Remerciements
 
-- **Tests**: 1,308/1,308 passing (100%)
-  - Core v2.0: 891 tests
-  - BMAD v2.1: 417 tests
-- **Coverage**: 95%+
-- **Performance**: < 10% overhead vs v2.0.0
-- **Principles**: KISS, DRY, SOLID, TDD
-- **Standards**: Zero emojis (Mantra IA-23)
+BYAN est construit au-dessus de la méthode **[BMAD](https://github.com/bmadcode/BMAD-METHOD)**, découverte grâce à un étudiant de la formation **[Acadenice](https://acadenice.fr/)** à qui je donne cours.
 
 ---
 
-## 📚 API Reference
+## Explication de l'Architecture BYAN — Workflow/Context/Agent/Worker (WCAW)
 
-### Main Class: ByanV2
+BYAN est organisé autour de quatre concepts fondamentaux qui interagissent ensemble :
 
-#### Core Methods
+### Agent
 
-- `constructor(config)` - Initialize BYAN
-- `startSession()` - Start interview session
-- `getNextQuestion()` - Get next interview question
-- `submitResponse(answer)` - Submit answer
-- `generateProfile()` - Generate agent profile
-- `isComplete()` - Check if interview complete
+Un agent est un spécialiste IA avec une identité définie. Il possède :
+- **Persona** : qui il est, son style de communication, ses forces
+- **Menu** : les actions disponibles, chacune liée à un workflow ou une commande
+- **Rules** : les contraintes absolues qu'il ne peut pas violer (les 64 mantras)
+- **Capabilities** : ce qu'il peut faire, ce qu'il ne fait pas
 
-#### Glossary Builder (BMAD)
+Les agents sont définis en Markdown avec des sections XML. Ils sont stockés dans `_byan/{module}/agents/` et exposés sur chaque plateforme via un wrapper léger (`.github/agents/`, `.claude/`, `.codex/prompts/`).
 
-- `startGlossary(domain, options)` - Initialize glossary
-- `addConcept(term, definition)` - Add concept
-- `getConcepts()` - Get all concepts
-- `getGlossary()` - Get full glossary
+### Workflow
 
-#### Five Whys Analyzer (BMAD)
+Un workflow est une séquence d'étapes guidées qu'un agent exécute pour accomplir une tâche complexe. Par exemple, le workflow `create-prd` guide l'agent PM à travers la création d'un Product Requirements Document en 6 étapes structurées.
 
-- `detectPainPoints(response)` - Detect pain points
-- `askWhy()` - Get WHY question
-- `processWhyAnswer(answer)` - Process answer
-- `getRootCause()` - Get root cause analysis
+Les workflows peuvent être :
+- **Tri-modaux** : Create / Validate / Edit (ex: PRD, Architecture)
+- **Séquentiels** : processus multi-phases guidés (ex: interview BYAN en 4 phases)
+- **Utilitaires** : tâches ponctuelles (ex: fact-check, shard-doc)
 
-#### Active Listener (BMAD)
+### Context Layer
 
-- `listen(input, context)` - Process input with listening
-- `reformulate(input, style)` - Reformulate input
-- `validateResponse(input)` - Validate confirmation
-- `summarizeSession()` - Generate session summary
+Le contexte est la couche de mémoire et d'état partagée entre tous les agents sur un projet. Il contient :
+- `_byan/config.yaml` : configuration globale (langue, nom utilisateur, chemins de sortie)
+- `_byan/_memory/elo-profile.json` : score de confiance ELO persistant par domaine
+- `_byan/_memory/fact-graph.json` : base de connaissances vérifiées (persiste entre sessions)
+- `_byan-output/` : tous les artefacts générés (PRD, architecture, stories, fact sheets)
+- `_byan/knowledge/` : sources vérifiées, axiomes, benchmarks ELO par domaine
 
-#### Mantras Validator (BMAD)
+### Worker
 
-- `validateAgent(definition)` - Validate against mantras
-- `generateComplianceReport()` - Generate report
-- `validateMantra(mantraId, content)` - Validate specific mantra
-- `getMantras(category)` - Get mantras by category
+Un worker est un module utilitaire npm-installable qui fait un travail spécifique en arrière-plan. Il est indépendant du cycle agent/workflow et peut être utilisé directement dans votre code.
 
----
+Workers disponibles :
+- `_byan/workers/fact-check-worker.js` : vérification scientifique de claims
+- `_byan/workers/cost-optimizer.js` : routage LLM intelligent (~54% d'économies)
 
-## 🔄 Migration from v2.0.0
+```javascript
+const FactCheckWorker = require('./_byan/workers/fact-check-worker');
+const fc = new FactCheckWorker({ verbose: true });
 
-**Good news**: Zero breaking changes! Your v2.0.0 code works unchanged.
+// Vérifier un claim
+fc.check("Redis est toujours plus rapide que PostgreSQL");
+// → { assertionType: 'HYPOTHESIS', level: 5, score: 20, status: 'OPINION' }
 
-```javascript
-// v2.0.0 code - still works in v2.1.0
-const ByanV2 = require('create-byan-agent');
-const byan = new ByanV2();
-await byan.startSession();
-// ... your existing workflow
+// Détecter les claims implicites dans un texte
+fc.parse("C'est évidemment la meilleure approche pour la sécurité");
+// → [{ matched: 'évidemment', position: 5, ... }]
 ```
 
-To use new BMAD features, simply enable them in config. See [MIGRATION.md](https://github.com/Yan-Acadenice/BYAN/blob/main/MIGRATION-v2.0-to-v2.1.md) for details.
-
 ---
 
-## 📖 Documentation
-
-- [Full Documentation](https://github.com/Yan-Acadenice/BYAN/blob/main/README-BYAN-V2.md)
-- [CHANGELOG v2.1.0](https://github.com/Yan-Acadenice/BYAN/blob/main/CHANGELOG-v2.1.0.md)
-- [Migration Guide](https://github.com/Yan-Acadenice/BYAN/blob/main/MIGRATION-v2.0-to-v2.1.md)
-- [Manual Testing Guide](https://github.com/Yan-Acadenice/BYAN/blob/main/BYAN-V2.1.0-MANUAL-TEST-PLAN.md)
-- [BMAD Quick Reference](https://github.com/Yan-Acadenice/BYAN/blob/main/BMAD-QUICK-REFERENCE.md)
+## Schéma de Fonctionnement — Architecture WCAW
 
----
+Le diagramme conceptuel ci-dessous montre comment les quatre composants interagissent. **Hermes** est le point d'entrée universel : il reçoit votre requête et la route vers le bon agent.
 
-## 🤝 Contributing
+```
+VOUS  →  @hermes "je veux créer un agent"
+              │
+              ▼
+    ┌─────────────────────────────────────────────────────────┐
+    │                  AGENT (spécialiste IA)                  │
+    │    Persona · Menu · Rules (64 mantras) · Capabilities    │
+    └────────────┬─────────────────────────┬───────────────────┘
+                 │ déclenche               │ appelle
+                 ▼                         ▼
+    ┌────────────────────┐    ┌─────────────────────────────┐
+    │     WORKFLOW       │    │          WORKER              │
+    │  Steps guidés      │    │  ELO Engine                 │
+    │  Artifacts générés │    │  Fact-Checker               │
+    │  Validation steps  │    │  Cost Optimizer             │
+    └────────┬───────────┘    └─────────────┬───────────────┘
+             │ lit/écrit                    │ persiste
+             ▼                              ▼
+    ┌─────────────────────────────────────────────────────────┐
+    │                    CONTEXT LAYER                         │
+    │  config.yaml · elo-profile.json · fact-graph.json        │
+    │  _byan-output/ · _byan/knowledge/ · session-state        │
+    └─────────────────────────────────────────────────────────┘
+```
 
-Contributions welcome! Please read our contributing guidelines and submit pull requests to our [GitHub repository](https://github.com/Yan-Acadenice/BYAN).
+### Diagrammes interactifs draw.io
 
----
+Pour une visualisation plus détaillée, ouvrez ces fichiers avec draw.io :
 
-## 👥 Contributors
+- **Architecture globale BYAN** : [byan-architecture.drawio](https://github.com/Yan-Acadenice/BYAN/blob/main/byan-architecture.drawio)
+- **Concept Workflow/Context/Agent/Worker** : [byan-wcaw-concept.drawio](https://github.com/Yan-Acadenice/BYAN/blob/main/byan-wcaw-concept.drawio)
 
-### Core Team
-- **[Yan-Acadenice](https://github.com/Yan-Acadenice)** - Creator & Lead Developer
+---
 
-### Special Contributors
-- **[Wazadriano](https://github.com/Wazadriano)** - Hermes Universal Dispatcher (v2.3.2)
-  - Designed and documented the Hermes agent architecture
-  - Smart routing rules and multi-agent pipelines
-  - Complete integration with BYAN ecosystem
+## Système ELO — Confiance Épistémique
 
----
+BYAN v2.6.1 introduit un système de calibration de la confiance par domaine technique (algorithme Glicko-2, échelle 0-1000).
 
-## 💝 Credits
+| Plage ELO | Niveau | Comportement BYAN |
+|-----------|--------|-------------------|
+| 0–200 | Apprenti | Explications complètes, analogies, scaffold maximum |
+| 201–450 | Débutant | Guide pas-à-pas, vérification fréquente |
+| 450–550 | Zone morte | Challenge intense (pic de Dunning-Kruger) |
+| 551–750 | Intermédiaire | Challenge modéré, hypothèses testées |
+| 751–900 | Avancé | Challenge minimal, discussion pair-à-pair |
+| 901–1000 | Expert | Réponses courtes, pas d'explications de base |
 
-**Créé avec passion par [Yan-Acadenice](https://github.com/Yan-Acadenice)**  
-Pour la communauté [Acadenice](https://acadenice.fr/)
+**Principe :** un score bas ne punit pas — il augmente la pédagogie. BYAN s'adapte à votre niveau réel, pas à celui que vous déclarez.
 
 ---
 
-## 📄 License
+## Fact-Check Scientifique
 
-MIT © [Yan-Acadenice](https://github.com/Yan-Acadenice)
-
----
+BYAN applique Zero Trust sur lui-même : tout claim doit être **démontrable**, **quantifiable**, **reproductible**.
 
-## 🆘 Support
+```
+[REASONING]              Déduction logique — sans garantie de vérité
+[HYPOTHESIS]             Plausible dans ce contexte — à vérifier avant action
+[CLAIM L{n}]             Assertion sourcée — niveau 1 à 5
+[FACT USER-VERIFIED date] Validé par l'utilisateur avec artefact de preuve
+```
 
-- **Issues**: [GitHub Issues](https://github.com/Yan-Acadenice/BYAN/issues)
-- **Repository**: [github.com/Yan-Acadenice/BYAN](https://github.com/Yan-Acadenice/BYAN)
+Domaines stricts : `security` / `performance` / `compliance` → LEVEL-2 minimum ou BLOCKED.
 
 ---
 
-## 🎯 Use Cases
-
-### For Solo Developers
-Create specialized agents for your workflow without complex setup.
+## Workflows Principaux
+
+| Workflow | Description | Agent principal |
+|----------|-------------|-----------------|
+| `create-prd` | Créer un Product Requirements Document | pm |
+| `create-architecture` | Concevoir l'architecture technique | architect |
+| `create-epics-and-stories` | Découper en epics et user stories | sm |
+| `sprint-planning` | Planifier un sprint | sm |
+| `dev-story` | Développer une user story | dev |
+| `code-review` | Revoir du code | dev / quinn |
+| `quick-spec` | Spec rapide conversationnelle | quick-flow-solo-dev |
+| `quick-dev` | Dev rapide sur code existant | quick-flow-solo-dev |
+| `testarch-atdd` | Générer des tests ATDD avant implémentation | tea |
+| `fact-check` | Analyser une assertion ou un document | fact-checker |
+| `elo-workflow` | Consulter et gérer le score de confiance ELO | byan |
 
-### For Teams
-Build consistent agent profiles following team standards and mantras.
+---
 
-### For Agencies
-Rapid agent prototyping with built-in quality validation.
+## Plateformes Supportées
 
-### For Open Source
-Generate well-documented agent profiles for public repositories.
+| Plateforme | Invocation | Chemin de config |
+|------------|-----------|------------------|
+| GitHub Copilot CLI | `@agent-name` | `.github/agents/*.md` |
+| Claude Code | `@agent-name` | `.claude/rules/*.md` |
+| Codex / OpenCode | `@agent-name` | `.codex/prompts/*.md` |
+| CLI direct | `node bin/byan-v2-cli.js` | `_byan/config.yaml` |
 
 ---
 
-## 🌟 Highlights
+## Licence
 
-- ✅ **Zero Setup**: Works immediately with npx
-- ✅ **Intelligent**: Smart interview adapts to your answers
-- ✅ **Quality**: Built-in validation against 64 mantras
-- ✅ **Fast**: Create agents in 10-15 minutes
-- ✅ **Flexible**: Use as CLI or programmatically
-- ✅ **Tested**: 1,308 tests, 100% passing
-- ✅ **Compatible**: Works with v2.0.0 code unchanged
+MIT © [Yan-Acadenice](https://github.com/Yan-Acadenice)
 
 ---
 
-**Ready to create your first AI agent?**
-
-```bash
-npx create-byan-agent
-```
-
-🚀 Let's build something amazing!
+*Fait avec de la frustration, de la curiosité, et l'envie que l'IA soit vraiment utile — pas juste impressionnante.*