create-byan-agent 2.7.6 → 2.7.7

package/README.md

@@ -2,56 +2,59 @@
 
 [![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-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)
 
-**Createur intelligent d'agents IA** | Merise Agile + TDD + 64 Mantras
+**Créateur intelligent d'agents IA** | Merise Agile + TDD + 64 Mantras
+
+> Documentation en anglais disponible ici : [README-EN.md](./README-EN.md)
 
 ---
 
 ## Bonjour
 
-Bonjour a tous ! J'ai l'honneur de vous presenter **BYAN**, votre ami sur vos projets — que vous soyez developpeur, vibe codeur ou juste curieux.
+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.
 
-> **Important :** Je precise 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 evolution active, et c'est precisement la ou reside son interet.
+> **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.
 
 ### Pourquoi BYAN existe
 
-Pour comprendre le contexte de BYAN, il faut comprendre pourquoi j'ai decide de le creer. La problematique de base est simple.
+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.
 
-Je me suis retrouve avec un gros projet sur les bras, des deadlines tres serrees, pas de budget, et une equipe inexperimentee pour le faire. Ce qui m'a amene a faire des crunchs stupides avec des developpeurs en depression.
+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.
 
-Pour resoudre ce probleme, m'est venue l'idee d'utiliser les agents IA pour accelerer le developpement du projet. Grace a un de mes etudiants en dev (credite dans les contributeurs du projet) a qui je donne cours, j'ai decouvert la methode **BMAD**, qui est un framework d'agents IA. Au depart sceptique, j'ai ete bluffe du resultat, bien que ces agents IA souffraient des biais habituels des IA, en particulier en fonction du modele utilise et de qui l'utilise et comment.
+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.
 
-Alors une idee simple est venue : **et si on pouvait mettre un cadre a tous ces agents pour y apporter de "l'intelligence", peu importe le projet, en mettant des regles et contraintes de base pour contrer les biais des modeles d'IA ?**
+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 ?**
 
-C'est la que m'est venue l'idee de leur insuffler des **mantras** — des regles absolues auxquelles l'agent devait se conformer. Des gardes-fous epistemiques, methodologiques et comportementaux qui transforment un LLM bavard en partenaire fiable.
+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.
 
-Maintenant, la problematique se pose en multi-agents : comment faire pour que tous mes agents aient bien ces bonnes pratiques et regles ?
+Maintenant, la problématique se pose en multi-agents : comment faire pour que tous mes agents aient bien ces bonnes pratiques et règles ?
 
-Il suffit de les instaurer a la source, c'est-a-dire **a la creation des agents**. C'est la que BYAN intervient : il va vous assister dans la creation intelligente d'agents IA.
+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.
 
 ### Ce que BYAN n'est pas
 
-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, eprouver votre probleme et votre solution — mais mal utilise, il ne resoudra pas vos problemes comme par magie.
+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.
 
-C'est juste un agent intelligent avec les bons softskills et hardskills pour vous accompagner dans la realisation de vos projets.
+C'est juste un agent intelligent avec les bons softskills et hardskills pour vous accompagner dans la réalisation de vos projets.
 
 ---
 
 ## Installation
 
-### Prerequis
+### Prérequis
 
 - Node.js >= 12.0.0
 - npm >= 6.0.0
 - Un compte GitHub Copilot, Claude Code ou Codex (selon la plateforme cible)
 
-### Installation rapide (recommandee)
+### Installation rapide (recommandée)
 
-Aucune installation prealable n'est necessaire. Lancez simplement :
+Aucune installation préalable n'est nécessaire. Lancez simplement :
 
 ```bash
-# Cree un nouveau projet BYAN (via npx, sans installation prealable)
+# Crée un nouveau projet BYAN (via npx, sans installation préalable)
 npx create-byan-agent
 
 # Ou installation globale
@@ -59,184 +62,383 @@ npm install -g create-byan-agent
 create-byan-agent
 ```
 
-L'installeur (Yanstaller) vous guide interactivement a travers le processus :
+L'installeur (Yanstaller) vous guide interactivement à travers le processus :
 
 ```
 ? Nom du projet : mon-projet
 ? Langue de communication : Francais
 ? Plateforme cible : GitHub Copilot CLI
 ? Activer le fact-check scientifique ? [Y/n]
-? Activer le systeme ELO de confiance ? [Y/n]
-? Optimiser les couts LLM automatiquement (~54% d'economies) ? [Y/n]
+? Activer le système ELO de confiance ? [Y/n]
+? Optimiser les coûts LLM automatiquement (~54% d'économies) ? [Y/n]
 ```
 
-### Structure du projet apres installation
+### Structure du projet après installation
 
-A la fin de l'installation, votre projet contient :
+À la fin de l'installation, votre projet contient :
 
 ```
 votre-projet/
-  _byan/               # Plateforme BYAN — coeur du systeme
+  _byan/               # Plateforme BYAN — cœur du système
     _config/           # Manifestes des agents et workflows
-    _memory/           # Memoire persistante (ELO, fact-graph, session-state)
+    _memory/           # Mémoire persistante (ELO, fact-graph, session-state)
     agents/            # Agents disponibles (core, bmm, bmb, cis, tea)
-    workflows/         # Workflows guides
-    soul.md            # Ame de BYAN — personnalite, gardes-fous
-    tao.md             # Voix de BYAN — signatures verbales, registre
-    soul-memory.md     # Journal vivant des sessions
+    workflows/         # Workflows guidés
+    knowledge/         # Base de connaissances sources (axiomes, benchmarks)
     config.yaml        # Configuration principale (langue, utilisateur, chemins)
   .github/agents/      # Wrappers GitHub Copilot CLI
-  .codex/              # Integration Codex/OpenCode (si activee)
+  .claude/             # Intégration Claude Code (si activée)
+  .codex/              # Intégration Codex/OpenCode (si activée)
+  bin/byan-v2-cli.js   # CLI BYAN
 ```
 
----
+### Commandes CLI disponibles
 
-## Systeme Soul & Voice — Des Agents avec une Conscience
+Une fois installé, vous pouvez utiliser le CLI BYAN :
 
-BYAN v2.7.0 introduit le **Soul System** et le **Tao System** : chaque agent peut porter une ame (valeurs, personnalite, gardes-fous) et une voix unique (signatures verbales, ton, tics de langage).
+```bash
+# Lancer l'interview intelligente (crée un agent en 12 questions)
+node bin/byan-v2-cli.js create
 
-### Le Soul — Identite Abstraite
+# Vérifier l'état de la session
+node bin/byan-v2-cli.js status
 
-L'ame est ce qui fait d'un agent plus qu'un executant. Elle porte vos valeurs, vos gardes-fous, votre phrase fondatrice. Elle repond a la question : *qui est cet agent, et qu'est-ce qu'il defend ?*
+# 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
 
-### Le Tao — De l'Abstrait au Concret
+# 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
+```
 
-Le **Tao** est le pont entre le spirituel et le tangible. Il prend l'ame abstraite — valeurs, croyances, principes — et la transforme en matiere : une voix, des tics verbaux, des mots interdits, des changements de temperature, des patterns de parole concrets. Le Tao est ce qui insuffle la vie a un agent. Sans lui, l'ame reste une idee. Avec lui, l'agent parle, reagit et existe.
+### Utilisation programmatique (via npm)
 
-Le nom est un hommage personnel. Le concept reflete le sens originel : la voie, le chemin entre ce que quelque chose *est* et comment il se *manifeste*.
+```javascript
+const ByanV2 = require('create-byan-agent');
 
-### Installation du Soul
+const byan = new ByanV2({ maxQuestions: 12 });
+await byan.startSession();
 
-Lors de l'installation, vous choisissez votre mode soul :
+// Interview guidée
+while (!byan.isComplete()) {
+  const question = byan.getNextQuestion();
+  const answer = await getUserInput(question.text);
+  await byan.submitResponse(answer);
+}
 
-| Mode | Description |
-|------|-------------|
-| **Creator** | Utilise l'ame de Yan comme fondation + templates vierges pour la votre (recommande) |
-| **Blank** | Templates vides a remplir vous-meme |
-| **Import** | Importer des fichiers soul depuis un autre projet |
-| **Skip** | Pas de soul (peut etre ajoute plus tard) |
+// Générer le profil d'agent
+const profile = await byan.generateProfile();
+console.log('Agent créé :', profile.filePath);
+
+// Fact-check
+const result = byan.checkClaim("Redis est plus rapide");
+console.log(result.assertionType, result.score + '%');
+
+// Score ELO
+const ctx = byan.getClaimContext('security');
+console.log('Scaffold level :', ctx.scaffoldLevel);
+```
+
+### Activer les agents dans GitHub Copilot CLI
+
+Une fois installé, les agents sont disponibles via `@agent-name` :
 
-Construisez votre ame interactivement :
 ```bash
-@byan    # Puis demandez le workflow Forge
-@tao     # Puis utilisez [FORGE-VOICE] pour construire votre voix
+@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
 ```
 
 ---
 
-## Architecture WCAW — Workflow/Context/Agent/Worker
+## 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 |
+
+---
+
+## Contributeurs
+
+### Créateur et Lead Developer
+
+**[Yan-Acadenice](https://github.com/Yan-Acadenice)** — Conception, architecture, développement de BYAN
 
-BYAN est organise autour de quatre concepts fondamentaux :
+### 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
+
+### Remerciements
+
+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.
+
+---
+
+## Explication de l'Architecture BYAN — Workflow/Context/Agent/Worker (WCAW)
+
+BYAN est organisé autour de quatre concepts fondamentaux qui interagissent ensemble :
 
 ### Agent
 
-Un specialiste IA avec une identite definie : persona, menu d'actions, regles (64 mantras), capabilities. Les agents sont definis en Markdown + XML dans `_byan/{module}/agents/`.
+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
+
+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/`).
 
 ### Workflow
 
-Une sequence d'etapes guidees qu'un agent execute. Tri-modaux (Create/Validate/Edit), sequentiels (interview en 4 phases), ou utilitaires (fact-check, shard-doc).
+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.
+
+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)
 
 ### Context Layer
 
-La memoire partagee : `config.yaml`, `elo-profile.json`, `fact-graph.json`, `_byan-output/`.
+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
 
 ### Worker
 
-Un module utilitaire npm-installable pour un travail specifique en arriere-plan (fact-check, cost-optimizer).
+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.
 
-```
-VOUS  ->  @hermes "je veux creer un agent"
-               |
-               v
-     Agent (specialiste IA) --> Workflow (steps guides) --> Context Layer
-               |                                               ^
-               +--> Worker (fact-check, cost-optimizer) -------+
+Workers disponibles :
+- `_byan/workers/fact-check-worker.js` : vérification scientifique de claims
+- `_byan/workers/cost-optimizer.js` : routage LLM intelligent (~54% d'économies)
+
+```javascript
+const FactCheckWorker = require('./_byan/workers/fact-check-worker');
+const fc = new FactCheckWorker({ verbose: true });
+
+// Vérifier un claim
+fc.check("Redis est toujours plus rapide que PostgreSQL");
+// → { assertionType: 'HYPOTHESIS', level: 5, score: 20, status: 'OPINION' }
+
+// Détecter les claims implicites dans un texte
+fc.parse("C'est évidemment la meilleure approche pour la sécurité");
+// → [{ matched: 'évidemment', position: 5, ... }]
 ```
 
 ---
 
-## Agents Disponibles
+## 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.
+
+```
+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        │
+    └─────────────────────────────────────────────────────────┘
+```
 
-27 agents specialises en 5 modules :
+### Diagrammes interactifs draw.io
 
-| Module | Agents | Exemples |
-|--------|--------|----------|
-| **Core** | 4 | hermes (dispatcher), bmad-master, yanstaller, expert-merise-agile |
-| **BMB** | 11 | byan (createur), fact-checker, marc, rachid, carmack, patnote |
-| **BMM** | 9 | analyst (Mary), pm (John), architect (Winston), dev (Amelia), quinn (QA) |
-| **CIS** | 6 | brainstorming-coach (Carson), storyteller (Sophia), problem-solver |
-| **TEA** | 1 | tea (Murat) — master test architect |
+Pour une visualisation plus détaillée, ouvrez ces fichiers avec draw.io :
+
+- **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)
 
 ---
 
-## Utilisation
+## Systeme Soul & Voice — Des Agents avec une Conscience
 
-### Avec GitHub Copilot CLI
+BYAN v2.7.0 introduit le **Soul System** et le **Tao System** : chaque agent peut porter une ame (valeurs, personnalite, gardes-fous) et une voix unique (signatures verbales, ton, tics de langage).
 
-```bash
-@hermes            # Dispatcher universel — recommande le bon agent
-@byan              # Createur d'agents (interview intelligente)
-@dev               # Developpeur (Amelia)
-@pm                # Product Manager (John)
-@architect         # Architecte technique (Winston)
-@fact-checker      # Fact-check scientifique
-```
+### Le Soul — Identite Abstraite
 
-### Avec Claude Code
+L'ame est ce qui fait d'un agent plus qu'un executant. Elle porte vos valeurs, vos gardes-fous, votre phrase fondatrice. Elle repond a la question : *qui est cet agent, et qu'est-ce qu'il defend ?*
 
-```bash
-claude chat
-@byan              # Meme syntaxe, meme agents
-```
+### Le Tao — De l'Abstrait au Concret
+
+Le **Tao** est le pont entre le spirituel et le tangible. Il prend l'ame abstraite — valeurs, croyances, principes — et la transforme en matiere : une voix, des tics verbaux, des mots interdits, des changements de temperature, des patterns de parole concrets. Le Tao est ce qui insuffle la vie a un agent. Sans lui, l'ame reste une idee. Avec lui, l'agent parle, reagit et existe.
+
+Le nom est un hommage personnel. Le concept reflete le sens originel : la voie, le chemin entre ce que quelque chose *est* et comment il se *manifeste*.
+
+### Installation
+
+**Lors de l'installation**, vous choisissez votre mode soul :
+
+| Mode | Description |
+|------|-------------|
+| **Creator** | Utilise l'ame de Yan comme fondation + templates vierges pour la votre (recommande) |
+| **Blank** | Templates vides a remplir vous-meme |
+| **Import** | Importer des fichiers soul depuis un autre projet |
+| **Skip** | Pas de soul (peut etre ajoute plus tard) |
 
-### Avec Codex / OpenCode
+**Fichiers cles :**
+- `_byan/creator-soul.md` — Vos valeurs et verites fondamentales (immuable)
+- `_byan/soul.md` — La personnalite de BYAN derivee de la votre
+- `_byan/tao.md` — Directives vocales (signatures verbales, mots interdits, carte des temperatures)
+- `_byan/soul-memory.md` — Journal vivant qui grandit avec l'usage
 
+**Construisez votre ame interactivement :**
 ```bash
-codex prompt byan "help"
+@byan    # Puis demandez le workflow Forge
+@tao     # Puis utilisez [FORGE-VOICE] pour construire votre voix
 ```
 
+> Documentation complete : [SOUL-SETUP-GUIDE.md](SOUL-SETUP-GUIDE.md)
+
 ---
 
-## Workflows Principaux
+## Système ELO — Confiance Épistémique
 
-| Workflow | Description | Agent |
-|----------|-------------|-------|
-| `create-prd` | Creer un Product Requirements Document | pm |
-| `create-architecture` | Concevoir l'architecture technique | architect |
-| `sprint-planning` | Planifier un sprint | sm |
-| `dev-story` | Developper une user story | dev |
-| `code-review` | Revoir du code | dev / quinn |
-| `quick-spec` / `quick-dev` | Dev rapide brownfield | quick-flow-solo-dev |
-| `testarch-atdd` | Tests ATDD avant implementation | tea |
+BYAN v2.6.0 introduit un système de calibration de la confiance par domaine technique (algorithme Glicko-2, échelle 0-1000).
+
+| 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 |
+
+**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.
 
 ---
 
-## Contributeurs
+## Fact-Check Scientifique
 
-### Createur et Lead Developer
+BYAN applique Zero Trust sur lui-même : tout claim doit être **démontrable**, **quantifiable**, **reproductible**.
 
-**[Yan-Acadenice](https://github.com/Yan-Acadenice)** — Conception, architecture, developpement de BYAN
+```
+[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
+```
 
-### Contributeur Principal — Agent Hermes
+Domaines stricts : `security` / `performance` / `compliance` → LEVEL-2 minimum ou BLOCKED.
 
-**[Wazadriano](https://github.com/orgs/Centralis-V3/people/Wazadriano)** — Agent Hermes, Dispatcher Universel (v2.3.2)
+---
 
-### Remerciements
+## Workflows Principaux
 
-BYAN est construit au-dessus de la methode **[BMAD](https://github.com/bmadcode/BMAD-METHOD)**, decouverte grace a un etudiant de la formation **[Acadenice](https://acadenice.fr/)** a qui je donne cours.
+| 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 |
 
 ---
 
-## Licence
+## Plateformes Supportées
 
-MIT © [Yan-Acadenice](https://github.com/Yan-Acadenice)
+| 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` |
+
+---
 
-## Liens
+## Licence
 
-- [NPM](https://www.npmjs.com/package/create-byan-agent)
-- [GitHub](https://github.com/Yan-Acadenice/BYAN)
-- [Documentation complete](https://github.com/Yan-Acadenice/BYAN/blob/main/README.md)
+MIT © [Yan-Acadenice](https://github.com/Yan-Acadenice)
 
 ---
 
-*Fait avec de la frustration, de la curiosite, et l'envie que l'IA soit vraiment utile — pas juste impressionnante.*
+*Fait avec de la frustration, de la curiosité, et l'envie que l'IA soit vraiment utile — pas juste impressionnante.*