create-byan-agent 2.6.2 → 2.7.0

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,410 +1,298 @@
-# BYAN v2.6.1 — Build Your AI Network
+# BYAN - Intelligent AI Agent Creator
 
-[![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)
+**Create custom AI agents in 15 minutes** | GitHub Copilot CLI, VSCode, Claude Code
 
-**Créateur intelligent d'agents IA** | Merise Agile + TDD + 64 Mantras
+## Quick Start
 
-> Documentation en anglais disponible ici : [README-EN.md](./README-EN.md)
-
----
-
-## 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.
-
-> **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.
+```bash
+npx create-byan-agent
+```
 
-### Pourquoi BYAN existe
+That's it! The installer launches automatically.
 
-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.
+## What is BYAN?
 
-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.
+BYAN guides you through an intelligent interview to create personalized AI agents:
 
-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.
+1. ✅ Answer 12-15 simple questions (15-30 min)
+2. ✅ BYAN analyzes your needs
+3. ✅ Custom agent generated automatically
+4. ✅ Ready to use immediately
 
-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 ?**
+## Installation
 
-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.
+### Option 1: NPX (Recommended)
 
-Maintenant, la problématique se pose en multi-agents : comment faire pour que tous mes agents aient bien ces bonnes pratiques et règles ?
+```bash
+npx create-byan-agent
+```
 
-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.
+### Option 2: Global Install
 
-### Ce que BYAN n'est pas
+```bash
+npm install -g create-byan-agent
+create-byan-agent
+```
 
-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.
+## Create Your First Agent
 
-C'est juste un agent intelligent avec les bons softskills et hardskills pour vous accompagner dans la réalisation de vos projets.
+### 1. Launch BYAN
 
----
+**GitHub Copilot CLI:**
+```bash
+gh copilot
+@byan
+```
 
-## Installation
+**Command Line:**
+```bash
+npx create-byan-agent
+```
 
-### Prérequis
+### 2. Choose Mode
 
-- Node.js >= 12.0.0
-- npm >= 6.0.0
-- Un compte GitHub Copilot, Claude Code ou Codex (selon la plateforme cible)
+**🎤 Full Interview (15-30 min)** - Recommended for first agent
+- 12-15 questions
+- In-depth analysis
+- Ultra-personalized agent
 
-### Installation rapide (recommandée)
+**⚡ Quick Create (5 min)** - For experienced users
+- 3-5 essential questions
+- Functional agent quickly
 
-Aucune installation préalable n'est nécessaire. Lancez simplement :
+### 3. Answer Questions
 
-```bash
-# Crée un nouveau projet BYAN (via npx, sans installation préalable)
-npx create-byan-agent
+BYAN asks questions in 4 categories:
 
-# Ou installation globale
-npm install -g create-byan-agent
-create-byan-agent
-```
+1. **Context**: Your project, goals
+2. **Business**: Domain, constraints
+3. **Agent**: Desired skills, tasks
+4. **Validation**: Confirmation, adjustments
 
-L'installeur (Yanstaller) vous guide interactivement à travers le processus :
+### 4. Automatic Generation
 
 ```
-? 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]
+✅ Complete analysis
+✅ Agent created: my-dev-agent.md
+✅ Validated and ready
 ```
 
-### Structure du projet après installation
+Agent saved to:
+- GitHub Copilot: `.github/copilot/agents/`
+- Other platforms: `.codex/prompts/`
 
-À la fin de l'installation, votre projet contient :
+## Usage Examples
 
-```
-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
-```
-
-### Commandes CLI disponibles
-
-Une fois installé, vous pouvez utiliser le CLI BYAN :
+### Code Review Agent
 
 ```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
+npx 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
+# BYAN asks:
+# Purpose? → "Review JavaScript code"
+# Tasks? → "Detect bugs, suggest optimizations"
+# Constraints? → "Follow our style guide"
 
-# 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
+# Result: code-reviewer.md created in 2 seconds
 ```
 
-### Utilisation programmatique (via npm)
-
-```javascript
-const ByanV2 = require('create-byan-agent');
-
-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);
-}
+### Documentation Agent
 
-// Générer le profil d'agent
-const profile = await byan.generateProfile();
-console.log('Agent créé :', profile.filePath);
+```bash
+npx create-byan-agent
 
-// Fact-check
-const result = byan.checkClaim("Redis est plus rapide");
-console.log(result.assertionType, result.score + '%');
+# Purpose? → "Generate API documentation"
+# Tech? → "Node.js, Express, MongoDB"
+# Format? → "Markdown with examples"
 
-// Score ELO
-const ctx = byan.getClaimContext('security');
-console.log('Scaffold level :', ctx.scaffoldLevel);
+# Result: doc-generator.md ready
 ```
 
-### Activer les agents dans GitHub Copilot CLI
+## Use Your Agent
 
-Une fois installé, les agents sont disponibles via `@agent-name` :
+### With GitHub Copilot CLI
 
 ```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
+gh copilot
+@my-dev-agent
+# Your agent responds!
 ```
 
----
+### With VSCode
 
-## 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 |
+1. Command Palette (Ctrl+Shift+P)
+2. "GitHub Copilot: Chat"
+3. Type `@my-dev-agent`
 
----
+### With Claude Code
 
-## Contributeurs
+```bash
+claude chat --agent my-dev-agent
+```
 
-### Créateur et Lead Developer
+## Key Concepts (v2.0)
 
-**[Yan-Acadenice](https://github.com/Yan-Acadenice)** — Conception, architecture, développement de BYAN
+### 1. Intelligent Interview (4 phases)
 
-### Contributeur Principal — Agent Hermes
+```
+CONTEXT → BUSINESS → AGENT → VALIDATION
+```
 
-**[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
+Minimum 3 questions per phase = 12 total
 
-### Remerciements
+### 2. State Machine
 
-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.
+```
+INTERVIEW → ANALYSIS → GENERATION → COMPLETED
+```
 
----
+### 3. Template System
 
-## Explication de l'Architecture BYAN — Workflow/Context/Agent/Worker (WCAW)
+Agents generated from professional templates with YAML frontmatter + XML structure.
 
-BYAN est organisé autour de quatre concepts fondamentaux qui interagissent ensemble :
+### 4. Automatic Validation
 
-### Agent
+- ✅ Correct YAML format
+- ✅ Valid XML structure
+- ✅ No emojis in code (Mantra IA-23)
+- ✅ Valid agent name
+- ✅ Clear description
 
-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
+### 5. Methodology: 64 Mantras
 
-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/`).
+Quality principles applied:
+- **#37 Ockham's Razor**: Simplicity first
+- **IA-1 Trust But Verify**: Verify user needs
+- **IA-23 No Emoji Pollution**: Clean code
+- **IA-24 Clean Code**: Self-documenting
 
-### Workflow
+## Advanced Configuration
 
-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.
+### Customize Output
 
-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)
+```javascript
+const ByanV2 = require('create-byan-agent');
 
-### Context Layer
+const byan = new ByanV2({
+  outputFolder: './my-agents',
+  language: 'en',
+  template: 'custom'
+});
+```
 
-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
+### Programmatic Usage
 
-### Worker
+```javascript
+const ByanV2 = require('create-byan-agent');
 
-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.
+async function createAgent() {
+  const byan = new ByanV2();
+  await byan.startSession();
+  
+  const responses = [
+    'Backend development agent',
+    'REST API in Node.js',
+    'Tests, docs, deployment',
+    // ... 12 responses total
+  ];
+  
+  for (const response of responses) {
+    await byan.getNextQuestion();
+    await byan.submitResponse(response);
+  }
+  
+  const profile = await byan.generateProfile();
+  console.log('Agent created:', profile);
+}
+```
 
-Workers disponibles :
-- `_byan/workers/fact-check-worker.js` : vérification scientifique de claims
-- `_byan/workers/cost-optimizer.js` : routage LLM intelligent (~54% d'économies)
+## Useful Commands
 
-```javascript
-const FactCheckWorker = require('./_byan/workers/fact-check-worker');
-const fc = new FactCheckWorker({ verbose: true });
+```bash
+# List agents
+ls .github/copilot/agents/
 
-// Vérifier un claim
-fc.check("Redis est toujours plus rapide que PostgreSQL");
-// → { assertionType: 'HYPOTHESIS', level: 5, score: 20, status: 'OPINION' }
+# Edit agent
+code .github/copilot/agents/my-agent.md
 
-// Détecter les claims implicites dans un texte
-fc.parse("C'est évidemment la meilleure approche pour la sécurité");
-// → [{ matched: 'évidemment', position: 5, ... }]
-```
+# Validate agent
+npx create-byan-agent --validate my-agent.md
 
----
+# Version
+npx create-byan-agent --version
+```
 
-## Schéma de Fonctionnement — Architecture WCAW
+## Help & Support
 
-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.
+### Get Help
 
 ```
-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        │
-    └─────────────────────────────────────────────────────────┘
+/bmad-help
 ```
 
-### Diagrammes interactifs draw.io
-
-Pour une visualisation plus détaillée, ouvrez ces fichiers avec draw.io :
+### Documentation
 
-- **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)
+- [Full Guide](https://github.com/Yan-Acadenice/BYAN/blob/main/GUIDE-UTILISATION.md)
+- [API Reference](https://github.com/Yan-Acadenice/BYAN/blob/main/API-BYAN-V2.md)
+- [Examples](https://github.com/Yan-Acadenice/BYAN/tree/main/examples)
 
----
-
-## Système ELO — Confiance Épistémique
+### Common Issues
 
-BYAN v2.6.1 introduit un système de calibration de la confiance par domaine technique (algorithme Glicko-2, échelle 0-1000).
+**Agent doesn't appear in Copilot**
+```bash
+cat .github/copilot/agents/my-agent.md
+gh copilot quit && gh copilot
+```
 
-| 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 |
+**"Node version too old"**
+```bash
+node --version  # Must be >= 18
+nvm install 18 && nvm use 18
+```
 
-**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.
+**Tests fail**
+```bash
+rm -rf node_modules package-lock.json
+npm install && npm test
+```
 
----
+## Stats (v2.0)
 
-## Fact-Check Scientifique
+- ✅ **881/881 tests passing (100%)**
+- ✅ **14 modules**
+- ✅ **77 Story Points delivered**
+- ✅ **Agent in < 2 seconds** after interview
+- ✅ **64 mantras** applied automatically
 
-BYAN applique Zero Trust sur lui-même : tout claim doit être **démontrable**, **quantifiable**, **reproductible**.
+## Use Cases
 
-```
-[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
-```
+**Developers**: Code review, test generation, refactoring, security analysis
 
-Domaines stricts : `security` / `performance` / `compliance` → LEVEL-2 minimum ou BLOCKED.
+**Writers**: Documentation, proofreading, translation, content creation
 
----
+**Project Managers**: Ticket analysis, reports, planning, prioritization
 
-## 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 |
+**Designers**: UI components, accessibility, CSS optimization, design systems
 
----
+## License
 
-## Plateformes Supportées
+MIT License
 
-| 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` |
+## Contributors
 
----
+**Core Team:**
+- **BYAN**: Intelligent agent creator
+- **RACHID**: NPM/NPX deployment specialist
+- **MARC**: GitHub Copilot CLI integration expert
+- **PATNOTE**: Update manager
+- **CARMACK**: Token optimizer
 
-## Licence
+## Links
 
-MIT © [Yan-Acadenice](https://github.com/Yan-Acadenice)
+- 📦 [NPM](https://www.npmjs.com/package/create-byan-agent)
+- 🐙 [GitHub](https://github.com/Yan-Acadenice/BYAN)
+- 📚 [Full Docs](https://github.com/Yan-Acadenice/BYAN/blob/main/install/README.md)
 
 ---
 
-*Fait avec de la frustration, de la curiosité, et l'envie que l'IA soit vraiment utile — pas juste impressionnante.*
+**BYAN v2.0** - Create professional AI agents in 15 minutes 🚀