create-byan-agent 2.6.2 → 2.7.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Yan
+Copyright (c) 2025 Yan
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,60 +1,57 @@
-# BYAN v2.6.1 — Build Your AI Network
+# BYAN v2.7.0 — Build Your AI Network
 
 [![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)
 
-**Créateur intelligent d'agents IA** | Merise Agile + TDD + 64 Mantras
-
-> Documentation en anglais disponible ici : [README-EN.md](./README-EN.md)
+**Createur intelligent d'agents IA** | Merise Agile + TDD + 64 Mantras
 
 ---
 
 ## Bonjour
 
-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.
+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.
 
-> **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.
+> **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.
 
 ### 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.
+Pour comprendre le contexte de BYAN, il faut comprendre pourquoi j'ai decide de le creer. La problematique de base est simple.
 
-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.
+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.
 
-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.
+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.
 
-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 ?**
+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 ?**
 
-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.
+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.
 
-Maintenant, la problématique se pose en multi-agents : comment faire pour que tous mes agents aient bien ces bonnes pratiques et règles ?
+Maintenant, la problematique se pose en multi-agents : comment faire pour que tous mes agents aient bien ces bonnes pratiques et regles ?
 
-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.
+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.
 
 ### 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, éprouver votre problème et votre solution — mais mal utilisé, il ne résoudra pas vos problèmes 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, eprouver votre probleme et votre solution — mais mal utilise, il ne resoudra pas vos problemes comme par magie.
 
-C'est juste un agent intelligent avec les bons softskills et hardskills pour vous accompagner dans la réalisation de vos projets.
+C'est juste un agent intelligent avec les bons softskills et hardskills pour vous accompagner dans la realisation de vos projets.
 
 ---
 
 ## Installation
 
-### Prérequis
+### Prerequis
 
 - Node.js >= 12.0.0
 - npm >= 6.0.0
 - Un compte GitHub Copilot, Claude Code ou Codex (selon la plateforme cible)
 
-### Installation rapide (recommandée)
+### Installation rapide (recommandee)
 
-Aucune installation préalable n'est nécessaire. Lancez simplement :
+Aucune installation prealable n'est necessaire. Lancez simplement :
 
 ```bash
-# Crée un nouveau projet BYAN (via npx, sans installation préalable)
+# Cree un nouveau projet BYAN (via npx, sans installation prealable)
 npx create-byan-agent
 
 # Ou installation globale
@@ -62,342 +59,171 @@ npm install -g create-byan-agent
 create-byan-agent
 ```
 
-L'installeur (Yanstaller) vous guide interactivement à travers le processus :
+L'installeur (Yanstaller) vous guide interactivement a 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 système ELO de confiance ? [Y/n]
-? Optimiser les coûts LLM automatiquement (~54% d'économies) ? [Y/n]
+? Activer le systeme ELO de confiance ? [Y/n]
+? Optimiser les couts LLM automatiquement (~54% d'economies) ? [Y/n]
 ```
 
-### Structure du projet après installation
+### Structure du projet apres installation
 
-À la fin de l'installation, votre projet contient :
+A la fin de l'installation, votre projet contient :
 
 ```
 votre-projet/
-  _byan/               # Plateforme BYAN — cœur du système
+  _byan/               # Plateforme BYAN — coeur du systeme
     _config/           # Manifestes des agents et workflows
-    _memory/           # Mémoire persistante (ELO, fact-graph, session-state)
+    _memory/           # Memoire 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)
+    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
     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
+  .codex/              # Integration Codex/OpenCode (si activee)
 ```
 
-### Commandes CLI disponibles
-
-Une fois installé, vous pouvez utiliser le CLI BYAN :
-
-```bash
-# Lancer l'interview intelligente (crée un agent en 12 questions)
-node bin/byan-v2-cli.js create
-
-# Vérifier l'état de la session
-node bin/byan-v2-cli.js status
-
-# 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
+---
 
-# 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
-```
+## Systeme Soul & Voice — Des Agents avec une Conscience
 
-### Utilisation programmatique (via npm)
+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).
 
-```javascript
-const ByanV2 = require('create-byan-agent');
+### Le Soul — Identite Abstraite
 
-const byan = new ByanV2({ maxQuestions: 12 });
-await byan.startSession();
+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 ?*
 
-// Interview guidée
-while (!byan.isComplete()) {
-  const question = byan.getNextQuestion();
-  const answer = await getUserInput(question.text);
-  await byan.submitResponse(answer);
-}
+### Le Tao — De l'Abstrait au Concret
 
-// Générer le profil d'agent
-const profile = await byan.generateProfile();
-console.log('Agent créé :', profile.filePath);
+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.
 
-// Fact-check
-const result = byan.checkClaim("Redis est plus rapide");
-console.log(result.assertionType, result.score + '%');
+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*.
 
-// Score ELO
-const ctx = byan.getClaimContext('security');
-console.log('Scaffold level :', ctx.scaffoldLevel);
-```
+### Installation du Soul
 
-### Activer les agents dans GitHub Copilot CLI
+Lors de l'installation, vous choisissez votre mode soul :
 
-Une fois installé, les agents sont disponibles via `@agent-name` :
+| 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) |
 
+Construisez votre ame interactivement :
 ```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
+@byan    # Puis demandez le workflow Forge
+@tao     # Puis utilisez [FORGE-VOICE] pour construire votre voix
 ```
 
 ---
 
-## 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 |
-| **mike** | Mike | Gestionnaire de projet Leantime — Projets, Tâches, Sprints, Milestones, Commentaires via API JSON-RPC 2.0 | Créer un sprint, assigner des tâches, suivre l'avancement d'un projet |
-
----
-
-## Contributeurs
-
-### Créateur et Lead Developer
-
-**[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
-
-### 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.
-
----
+## Architecture WCAW — Workflow/Context/Agent/Worker
 
-## Explication de l'Architecture BYAN — Workflow/Context/Agent/Worker (WCAW)
-
-BYAN est organisé autour de quatre concepts fondamentaux qui interagissent ensemble :
+BYAN est organise autour de quatre concepts fondamentaux :
 
 ### Agent
 
-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/`).
+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/`.
 
 ### Workflow
 
-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)
+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).
 
 ### Context Layer
 
-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
+La memoire partagee : `config.yaml`, `elo-profile.json`, `fact-graph.json`, `_byan-output/`.
 
 ### Worker
 
-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)
+Un module utilitaire npm-installable pour un travail specifique en arriere-plan (fact-check, cost-optimizer).
 
-```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, ... }]
+```
+VOUS  ->  @hermes "je veux creer un agent"
+               |
+               v
+     Agent (specialiste IA) --> Workflow (steps guides) --> Context Layer
+               |                                               ^
+               +--> Worker (fact-check, cost-optimizer) -------+
 ```
 
 ---
 
-## 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        │
-    └─────────────────────────────────────────────────────────┘
-```
-
-### Diagrammes interactifs draw.io
+## Agents Disponibles
 
-Pour une visualisation plus détaillée, ouvrez ces fichiers avec draw.io :
+27 agents specialises en 5 modules :
 
-- **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)
+| 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 |
 
 ---
 
-## Système ELO — Confiance Épistémique
+## Utilisation
 
-BYAN v2.6.1 introduit un système de calibration de la confiance par domaine technique (algorithme Glicko-2, échelle 0-1000).
+### Avec GitHub Copilot CLI
 
-| 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.
+```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
+```
 
----
+### Avec Claude Code
 
-## Fact-Check Scientifique
+```bash
+claude chat
+@byan              # Meme syntaxe, meme agents
+```
 
-BYAN applique Zero Trust sur lui-même : tout claim doit être **démontrable**, **quantifiable**, **reproductible**.
+### Avec Codex / OpenCode
 
-```
-[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
+```bash
+codex prompt byan "help"
 ```
 
-Domaines stricts : `security` / `performance` / `compliance` → LEVEL-2 minimum ou BLOCKED.
-
 ---
 
 ## Workflows Principaux
 
-| Workflow | Description | Agent principal |
-|----------|-------------|-----------------|
-| `create-prd` | Créer un Product Requirements Document | pm |
+| Workflow | Description | Agent |
+|----------|-------------|-------|
+| `create-prd` | Creer 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 |
+| `dev-story` | Developper 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 |
+| `quick-spec` / `quick-dev` | Dev rapide brownfield | quick-flow-solo-dev |
+| `testarch-atdd` | Tests ATDD avant implementation | tea |
 
 ---
 
-## Plateformes Supportées
+## Contributeurs
+
+### Createur et Lead Developer
+
+**[Yan-Acadenice](https://github.com/Yan-Acadenice)** — Conception, architecture, developpement de BYAN
 
-| 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` |
+### Contributeur Principal — Agent Hermes
+
+**[Wazadriano](https://github.com/orgs/Centralis-V3/people/Wazadriano)** — Agent Hermes, Dispatcher Universel (v2.3.2)
+
+### Remerciements
+
+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.
 
 ---
 
@@ -405,6 +231,12 @@ Domaines stricts : `security` / `performance` / `compliance` → LEVEL-2 minimum
 
 MIT © [Yan-Acadenice](https://github.com/Yan-Acadenice)
 
+## Liens
+
+- [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)
+
 ---
 
-*Fait avec de la frustration, de la curiosité, et l'envie que l'IA soit vraiment utile — pas juste impressionnante.*
+*Fait avec de la frustration, de la curiosite, et l'envie que l'IA soit vraiment utile — pas juste impressionnante.*