create-byan-agent 1.2.6 → 2.0.0-alpha.1

package/README.md

@@ -1,1265 +1,421 @@
-# 🏗️ YANSTALLER - Intelligent BYAN Installer
-
-[![Version](https://img.shields.io/badge/version-1.1.3-blue.svg)](https://www.npmjs.com/package/create-byan-agent)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
-[![Tests](https://img.shields.io/badge/tests-168%20passing-success.svg)](#tests)
-
-**YANSTALLER** est l'installateur intelligent pour l'écosystème **BYAN** (Builder of YAN). Il détecte automatiquement votre environnement de développement, recommande les agents appropriés, et les installe avec support multi-plateforme.
-
-> 📦 **Basé sur [BMAD](https://github.com/yanb94/byan)** - Business Modeling & Agent Development Platform  
-> ✍️ **Made by [Yan de Acadenice](https://acadenice.fr/)**
-
-**Méthodologie :** Merise Agile + TDD + 64 Mantras  
-**Langues :** 🇫🇷 Français | 🇬🇧 English ([See below](#english-version))
-
----
-
-## 📋 Table des matières
-
-1. [Fonctionnalités](#-fonctionnalités)
-2. [Installation](#-installation-rapide)
-3. [Utilisation](#-utilisation)
-4. [Architecture](#-architecture)
-5. [Modules](#-modules)
-6. [API](#-api-reference)
-7. [Tests](#-tests)
-8. [Développement](#-développement)
-9. [Contributing](#-contributing)
-10. [License](#-license)
-
----
-
-## ✨ Fonctionnalités
-
-### 🎯 Intelligence de Détection
-- ✅ **Détection automatique** des plateformes (GitHub Copilot CLI, VSCode, Claude Code, Codex)
-- ✅ **Analyse du projet** via `package.json` (20+ frameworks reconnus)
-- ✅ **Recommandations contextuelles** d'agents basées sur votre stack
-
-### 🤖 Agents Disponibles (29 agents)
-- **BMB (Meta):** BYAN, BYAN-Test, RACHID, MARC, PATNOTE, CARMACK, Agent-Builder, Module-Builder, Workflow-Builder
-- **BMM (SDLC):** Analyst, PM, Architect, Dev, SM, Quinn, UX-Designer, Tech-Writer, Quick-Flow-Solo-Dev
-- **TEA (Tests):** TEA (Test Architecture Expert)
-- **CIS (Innovation):** Brainstorming-Coach, Design-Thinking-Coach, Creative-Problem-Solver, Innovation-Strategist, Presentation-Master, Storyteller
-- **Core:** Party-Mode, BMAD-Master
-
-### 🚀 Installation Intelligente
-- ✅ **Structure BMAD complète** (19 répertoires créés automatiquement)
-- ✅ **Configuration YAML** générée avec métadonnées
-- ✅ **Stubs multi-plateformes** (Copilot CLI, VSCode, Claude Code, Codex)
-- ✅ **MCP Server setup** pour Claude Code
-- ✅ **Manifests CSV** pour tracking des agents
-
-### 🔍 Validation Automatique (10 checks)
-- Vérification structure `_bmad/`
-- Validation fichiers agents
-- Check YAML frontmatter
-- Validation permissions
-- Vérification dépendances npm
-- Tests manifests, workflows, templates
-
-### 🛠️ Troubleshooting Intelligent
-- ✅ **8 patterns d'erreurs** reconnus automatiquement
-- ✅ **Auto-fix** pour permissions, structure corrompue, dépendances
-- ✅ **Diagnostics contextuels** (Node version, Git, espace disque)
-- ✅ **Suggestions d'upgrade** OS-spécifiques
-
-### 💾 Backup & Rollback
-- ✅ **Sauvegarde automatique** avant installation
-- ✅ **Métadonnées** (timestamp, taille, fichiers)
-- ✅ **Restore sécurisé** avec pre-restore backup
-- ✅ **Nettoyage automatique** des anciens backups
-
-### 🧙 Wizard Post-Installation
-- ✅ **Interview en 7 questions** (<5 min)
-- ✅ **Mode conversationnel** avec inquirer
-- ✅ **4 options post-install** : créer agent, tester, docs, exit
-- ✅ **Guide quick-start** interactif
-
----
-
-## 🚀 Installation Rapide
-
-### Prérequis
-- **Node.js** ≥ 18.0.0
-- **Git** installé
-- Au moins **1 plateforme** : GitHub Copilot CLI, VSCode, Claude Code, ou Codex
-
-### Via NPX (recommandé)
-```bash
-# Installation interactive
-npx create-byan-agent
-
-# Suivre l'interview en 7 questions (5 min)
-```
-
-### Via NPM Global
-```bash
-# Installer globalement
-npm install -g create-byan-agent
-
-# Exécuter
-create-byan-agent
-```
-
-### Installation Manuelle
-```bash
-# Cloner le dépôt
-git clone https://github.com/Yan-Acadenice/BYAN.git
-cd BYAN/install
-
-# Installer les dépendances
-npm install
-
-# Lancer l'installateur
-npm start
-```
-
----
-
-## 🎮 Utilisation
-
-### Mode Interview (Recommandé)
-```bash
-npx create-byan-agent
-```
-
-**7 questions interactives :**
-1. Votre nom (pour configuration personnalisée)
-2. Langue de communication (Français/English)
-3. Mode d'installation (Recommandé/Custom/Minimal/Full)
-4. Sélection agents (si Custom)
-5. Plateformes cibles (Copilot/VSCode/Claude/Codex)
-6. Installation agent exemple (oui/non)
-7. Créer backup (oui/non)
-
-### Mode Programmatique
-
-#### API JavaScript
-```javascript
-const yanstaller = require('create-byan-agent');
-
-// Détection
-const detection = await yanstaller.detect({
-  projectRoot: process.cwd()
-});
-console.log(detection.platforms); // ['copilot-cli', 'vscode']
-
-// Recommandation
-const recommendations = await yanstaller.recommend({
-  projectRoot: process.cwd(),
-  detection
-});
-console.log(recommendations.agents); // ['dev', 'architect', 'quinn']
-
-// Installation
-const result = await yanstaller.install({
-  projectRoot: process.cwd(),
-  agents: ['byan', 'dev', 'quinn'],
-  platforms: ['copilot-cli', 'vscode'],
-  userName: 'Yan',
-  language: 'Francais'
-});
-
-// Validation
-const validation = await yanstaller.validate({
-  projectRoot: process.cwd()
-});
-console.log(validation.errors); // []
-```
-
-#### CLI Options
-```bash
-# Installation silencieuse avec agents spécifiques
-create-byan-agent --silent --agents=byan,dev,quinn
-
-# Mode custom avec plateforme spécifique
-create-byan-agent --mode=custom --platforms=copilot-cli
-
-# Installation complète sans backup
-create-byan-agent --mode=full --no-backup
-
-# Dry-run (simulation)
-create-byan-agent --dry-run
-
-# Verbose logging
-create-byan-agent --verbose
-```
-
----
-
-## 🏛️ Architecture
-
-### Structure du Projet
-```
-install/
-├── bin/
-│   └── create-byan-agent.js      # CLI entry point
-├── lib/
-│   ├── yanstaller/                # Core modules
-│   │   ├── detector.js            # Platform & project detection
-│   │   ├── recommender.js         # Agent recommendations
-│   │   ├── installer.js           # Installation orchestration
-│   │   ├── validator.js           # Post-install validation
-│   │   ├── troubleshooter.js      # Error diagnosis & auto-fix
-│   │   ├── backuper.js            # Backup & restore
-│   │   ├── interviewer.js         # Interactive interview
-│   │   └── wizard.js              # Post-install wizard
-│   ├── platforms/                 # Platform adapters
-│   │   ├── copilot-cli.js         # GitHub Copilot CLI
-│   │   ├── vscode.js              # VSCode extension
-│   │   ├── claude-code.js         # Claude Code MCP
-│   │   └── codex.js               # Codex platform
-│   ├── utils/                     # Utilities
-│   │   ├── file-utils.js          # File operations
-│   │   ├── logger.js              # Logging system
-│   │   └── yaml-utils.js          # YAML parsing
-│   ├── errors.js                  # Error definitions
-│   └── exit-codes.js              # Exit code constants
-├── templates/                     # Agent templates
-│   └── _bmad/
-│       ├── core/agents/
-│       ├── bmm/agents/
-│       ├── bmb/agents/
-│       ├── tea/agents/
-│       └── cis/agents/
-├── __tests__/                     # Test suite (168 tests)
-│   ├── recommender.test.js
-│   ├── installer.test.js
-│   ├── validator.test.js
-│   ├── troubleshooter.test.js
-│   ├── backuper.test.js
-│   ├── integration.test.js
-│   ├── e2e.test.js
-│   └── ...
-└── package.json
-```
-
-### Flux d'Installation
-
-```
-┌─────────────────────────────────────────────────────────┐
-│  1. DETECT - Platform & Project Analysis               │
-│     • Scan for Copilot CLI, VSCode, Claude, Codex      │
-│     • Analyze package.json dependencies                 │
-│     • Detect project type & framework                   │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  2. RECOMMEND - Intelligent Agent Selection             │
-│     • Match agents to project type                      │
-│     • Consider detected platforms                       │
-│     • Generate rationale for each recommendation        │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  3. INTERVIEW - User Preferences (7 questions)          │
-│     • Name, language, mode                              │
-│     • Agent selection (if custom)                       │
-│     • Platform targets, backup option                   │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  4. BACKUP - Pre-install Safety (optional)              │
-│     • Create timestamped backup of _bmad/               │
-│     • Save metadata (files, size, version)              │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  5. INSTALL - Core Installation                         │
-│     • Create _bmad/ structure (19 directories)          │
-│     • Copy agent templates from 5 modules               │
-│     • Generate platform stubs (Copilot/VSCode/etc.)     │
-│     • Create module configs (YAML with metadata)        │
-│     • Update manifests (agent-manifest.csv)             │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  6. VALIDATE - 10 Automated Checks                      │
-│     • Structure, agents, stubs, configs                 │
-│     • Permissions, manifests, workflows                 │
-│     • Templates, dependencies                           │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  7. WIZARD - Post-Install Actions                       │
-│     • Summary of installed agents                       │
-│     • Option: Create new agent (launch BYAN)            │
-│     • Option: Test agent                                │
-│     • Option: View documentation                        │
-│     • Quick start guide                                 │
-└─────────────────────────────────────────────────────────┘
-```
-
----
-
-## 📦 Modules
-
-### 1. Detector
-**Fichier :** `lib/yanstaller/detector.js`
-
-**Fonction :** Détecte les plateformes installées et analyse le projet.
-
-**API :**
-```javascript
-const detector = require('./lib/yanstaller/detector');
-
-// Détection complète
-const detection = await detector.detect({
-  projectRoot: '/path/to/project'
-});
-
-/* Retour :
-{
-  platforms: ['copilot-cli', 'vscode'],
-  projectType: 'frontend',
-  framework: 'react',
-  dependencies: { react: '^18.2.0', ... },
-  hasGit: true,
-  hasNpm: true
-}
-*/
-```
-
-**Méthodes :**
-- `detect(options)` - Détection complète
-- `detectPlatforms()` - Scan plateformes disponibles
-- `analyzeProject(projectRoot)` - Analyse `package.json`
-
----
-
-### 2. Recommender
-**Fichier :** `lib/yanstaller/recommender.js`
-
-**Fonction :** Recommande des agents basés sur le contexte du projet.
-
-**API :**
-```javascript
-const recommender = require('./lib/yanstaller/recommender');
-
-const recommendations = await recommender.recommend({
-  projectRoot: '/path/to/project',
-  detection: { projectType: 'frontend', framework: 'react' }
-});
-
-/* Retour :
-{
-  agents: ['dev', 'ux-designer', 'quinn'],
-  rationale: {
-    dev: 'Essential for React component development',
-    'ux-designer': 'UI/UX workflow for frontend projects',
-    quinn: 'QA automation for testing React components'
-  }
-}
-*/
-```
-
-**Reconnaissance :**
-- **Frameworks :** React, Vue, Angular, Svelte, Next.js, Nuxt, Express, NestJS, Fastify, Koa, Django, Flask, Rails, Spring Boot, Laravel
-- **Types de projet :** Frontend, Backend, Fullstack, Library
-- **Outils :** Jest, Vitest, Playwright, Cypress, Webpack, Vite, Rollup
-
----
-
-### 3. Installer
-**Fichier :** `lib/yanstaller/installer.js`
-
-**Fonction :** Installe les agents et configure l'environnement.
-
-**API :**
-```javascript
-const installer = require('./lib/yanstaller/installer');
-
-const result = await installer.install({
-  projectRoot: '/path/to/project',
-  agents: ['byan', 'dev', 'quinn'],
-  platforms: ['copilot-cli', 'vscode'],
-  userName: 'Yan',
-  language: 'Francais'
-});
-
-/* Retour :
-{
-  success: true,
-  installedAgents: ['byan', 'dev', 'quinn'],
-  createdDirectories: 19,
-  generatedStubs: 6,
-  configPath: '_bmad/bmb/config.yaml'
-}
-*/
-```
-
-**Étapes :**
-1. `createBmadStructure()` - Crée 19 répertoires
-2. `copyAgentFile()` - Copie les templates
-3. `generatePlatformStubs()` - Génère les stubs
-4. `createModuleConfig()` - Config YAML
-
----
-
-### 4. Validator
-**Fichier :** `lib/yanstaller/validator.js`
-
-**Fonction :** Valide l'installation avec 10 checks automatisés.
-
-**API :**
-```javascript
-const validator = require('./lib/yanstaller/validator');
-
-const validation = await validator.validate({
-  projectRoot: '/path/to/project'
-});
-
-/* Retour :
-{
-  valid: true,
-  errors: [],
-  warnings: ['Config file missing optional field: document_output_language'],
-  checks: {
-    structure: 'pass',
-    agents: 'pass',
-    stubs: 'pass',
-    configs: 'pass',
-    platforms: 'pass',
-    permissions: 'pass',
-    manifests: 'pass',
-    workflows: 'pass',
-    templates: 'pass',
-    dependencies: 'pass'
-  }
-}
-*/
-```
-
-**10 Checks :**
-1. `checkBmadStructure()` - 9 répertoires requis
-2. `checkAgentFiles()` - Agents copiés
-3. `checkStubsYamlFrontmatter()` - Format YAML/XML
-4. `checkConfigFiles()` - YAML valide
-5. `checkPlatformDetection()` - Plateformes actives
-6. `checkFilePermissions()` - Permissions R/W
-7. `checkManifests()` - CSV valides
-8. `checkWorkflows()` - Workflows accessibles
-9. `checkTemplates()` - Structure templates
-10. `checkDependencies()` - Dépendances npm
-
----
-
-### 5. Troubleshooter
-**Fichier :** `lib/yanstaller/troubleshooter.js`
-
-**Fonction :** Diagnostique et corrige automatiquement les erreurs.
-
-**API :**
-```javascript
-const troubleshooter = require('./lib/yanstaller/troubleshooter');
-
-// Diagnostic seul
-const diagnosis = await troubleshooter.diagnose(error);
-/* Retour :
-{
-  pattern: 'PERMISSION',
-  message: 'Permission denied: /path/to/_bmad',
-  autoFixAvailable: true,
-  fixFunction: 'fixPermissions'
-}
-*/
-
-// Troubleshooting complet
-const result = await troubleshooter.troubleshoot({
-  projectRoot: '/path/to/project'
-});
-/* Retour :
-{
-  issues: [
-    { type: 'permission', path: '_bmad/core', fixed: true }
-  ],
-  autofixed: 1,
-  manualActionRequired: 0
-}
-*/
-```
-
-**8 Patterns d'Erreur :**
-1. `NODE_VERSION` - Node.js obsolète
-2. `PERMISSION` - Permissions insuffisantes
-3. `NOT_FOUND` - Fichier/répertoire manquant
-4. `GIT_MISSING` - Git non installé
-5. `DISK_SPACE` - Espace disque insuffisant
-6. `NETWORK` - Problème réseau
-7. `CORRUPTED` - Structure corrompue
-8. `MISSING_DEP` - Dépendance manquante
-
-**5 Auto-Fix :**
-- `fixPermissions()` - icacls (Windows) / chmod (Unix)
-- `repairStructure()` - Recrée `_bmad/`
-- `resetConfig()` - Config YAML par défaut
-- `reinstallDependencies()` - npm install
-- `reinstallAgents()` - Re-copie templates
-
----
-
-### 6. Backuper
-**Fichier :** `lib/yanstaller/backuper.js`
-
-**Fonction :** Sauvegarde et restaure le répertoire `_bmad/`.
-
-**API :**
-```javascript
-const backuper = require('./lib/yanstaller/backuper');
-
-// Backup
-const backup = await backuper.backup({
-  projectRoot: '/path/to/project'
-});
-/* Retour :
-{
-  backupPath: '_bmad-backup/backup-1706918400000',
-  metadata: {
-    timestamp: 1706918400000,
-    created: '2026-02-03T10:00:00.000Z',
-    source: '/path/to/project/_bmad',
-    files: 42,
-    size: 1048576,
-    version: '1.1.3'
-  }
-}
-*/
-
-// Restore
-const restore = await backuper.restore({
-  projectRoot: '/path/to/project',
-  backupPath: '_bmad-backup/backup-1706918400000'
-});
-/* Retour :
-{
-  success: true,
-  restoredFiles: 42,
-  preRestoreBackup: '_bmad-backup/backup-1706918500000'
-}
-*/
-
-// List backups
-const backups = await backuper.listBackups({
-  projectRoot: '/path/to/project'
-});
-/* Retour : [
-  {
-    path: '_bmad-backup/backup-1706918400000',
-    timestamp: 1706918400000,
-    size: 1048576,
-    files: 42
-  }
-]
-*/
-```
-
-**Format Metadata :**
-```json
-{
-  "timestamp": 1706918400000,
-  "created": "2026-02-03T10:00:00.000Z",
-  "source": "/path/to/project/_bmad",
-  "files": 42,
-  "size": 1048576,
-  "version": "1.1.3"
-}
-```
-
----
-
-### 7. Interviewer
-**Fichier :** `lib/yanstaller/interviewer.js`
-
-**Fonction :** Interview en 7 questions pour personnaliser l'installation.
-
-**API :**
-```javascript
-const interviewer = require('./lib/yanstaller/interviewer');
-
-const answers = await interviewer.ask();
-/* Retour :
-{
-  userName: 'Yan',
-  language: 'Francais',
-  mode: 'recommended',
-  agents: ['byan', 'dev', 'quinn'],
-  platforms: ['copilot-cli', 'vscode'],
-  installSampleAgent: true,
-  createBackup: true
-}
-*/
-```
-
-**7 Questions :**
-1. **Nom** - Personnalisation
-2. **Langue** - Français ou English
-3. **Mode** - Recommended/Custom/Minimal/Full
-4. **Agents** - Sélection manuelle (si Custom)
-5. **Plateformes** - Copilot/VSCode/Claude/Codex
-6. **Agent exemple** - Installer BYAN-Test ?
-7. **Backup** - Créer sauvegarde ?
-
----
-
-### 8. Wizard
-**Fichier :** `lib/yanstaller/wizard.js`
-
-**Fonction :** Wizard post-installation avec 4 options.
-
-**API :**
-```javascript
-const wizard = require('./lib/yanstaller/wizard');
-
-await wizard.show({
-  installedAgents: ['byan', 'dev', 'quinn'],
-  platforms: ['copilot-cli', 'vscode']
-});
-
-// Options interactives :
-// 1. Create new agent (launch BYAN)
-// 2. Test an agent
-// 3. View documentation
-// 4. Exit
-```
-
-**Fonctionnalités :**
-- `launchByanInterview()` - Instructions pour activer BYAN
-- `testAgent()` - Guide de test d'agent
-- `showDocumentation()` - Chemins de documentation
-- `showExitMessage()` - Guide quick-start
-
----
-
-## 🧪 Tests
-
-### Suite de Tests (168 tests)
-
-**Coverage :**
-```bash
-npm test
-```
-
-**Fichiers de test :**
-```
-__tests__/
-├── recommender.test.js         (18 tests) - Recommandations d'agents
-├── installer.test.js           (13 tests) - Installation core
-├── platforms.test.js           (20 tests) - Adapters plateformes
-├── validator.test.js           (24 tests) - Validation 10 checks
-├── integration.test.js         (27 tests) - Tests d'intégration
-├── e2e.test.js                 (16 tests) - Scénarios end-to-end
-├── troubleshooter.test.js      (20 tests) - Diagnostic & auto-fix
-├── backuper.test.js            (20 tests) - Backup & restore
-└── interviewer-wizard.test.js  (10 tests) - Interview & wizard
-```
-
-### Tests E2E Scénarios
-
-**Scénario 1 : Projet React Frontend**
-```javascript
-// Détection → Recommend → Install → Validate
-const project = { dependencies: { react: '^18.2.0' } };
-// Agents recommandés : dev, ux-designer, quinn
-```
-
-**Scénario 2 : API Backend Express**
-```javascript
-const project = { dependencies: { express: '^4.18.2' } };
-// Agents recommandés : dev, architect, quinn
-```
-
-**Scénario 3 : Next.js Fullstack**
-```javascript
-const project = { dependencies: { next: '^14.0.0' } };
-// Agents recommandés : dev, architect, ux-designer, quinn
-```
-
-### Tests d'Intégration
-
-**Performance Benchmarks :**
-- Détection complète : < 2s
-- Installation 5 agents : < 10s
-- Validation 10 checks : < 5s
-- Backup 50 fichiers : < 3s
-
-### Exécution des Tests
-
-```bash
-# Tous les tests
-npm test
-
-# Watch mode
-npm run test:watch
-
-# Coverage
-npm run test:coverage
-
-# Test spécifique
-npm test -- recommender.test.js
-```
-
----
-
-## 🛠️ Développement
-
-### Setup Local
-
-```bash
-# Cloner le dépôt
-git clone https://github.com/Yan-Acadenice/BYAN.git
-cd BYAN/install
-
-# Installer les dépendances
-npm install
-
-# Lancer en mode dev
-npm start
-
-# Tests
-npm test
-
-# Linter
-npm run lint
-```
-
-### Structure de Développement
-
-**Conventions :**
-- **Méthodologie :** Merise Agile + TDD + 64 Mantras
-- **Commits :** `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`
-- **NO EMOJIS** dans commits/code/specs (Mantra IA-23)
-- **Clean Code** - Code auto-documenté (Mantra IA-24)
-- **Test-Driven** - Tests avant implémentation
-
-**Ajouter un Nouveau Module :**
-
-1. Créer `lib/yanstaller/my-module.js`
-2. Créer `__tests__/my-module.test.js`
-3. Écrire les tests (TDD)
-4. Implémenter le module
-5. Exécuter les tests : `npm test`
-6. Commit : `feat: add my-module with X functionality`
-
-**Ajouter une Nouvelle Plateforme :**
-
-1. Créer `lib/platforms/my-platform.js`
-2. Implémenter 3 méthodes :
-   - `detect()` - Détecter la plateforme
-   - `install(agentName)` - Créer l'agent
-   - `generateStub(agentName, config)` - Générer le stub
-3. Ajouter les tests dans `__tests__/platforms.test.js`
-4. Mettre à jour `lib/yanstaller/detector.js`
-
----
-
-## 🤝 Contributing
-
-Les contributions sont les bienvenues ! Merci de suivre ces guidelines :
-
-### Processus de Contribution
-
-1. **Fork** le dépôt
-2. **Créer une branche** : `git checkout -b feature/ma-fonctionnalite`
-3. **Écrire les tests** (TDD obligatoire)
-4. **Implémenter** la fonctionnalité
-5. **Tests verts** : `npm test`
-6. **Commit** : `git commit -m "feat: add ma-fonctionnalite"`
-7. **Push** : `git push origin feature/ma-fonctionnalite`
-8. **Pull Request** avec description détaillée
-
-### Standards de Code
-
-- ✅ **TDD** - Tests avant implémentation
-- ✅ **Clean Code** - Fonctions courtes, noms explicites
-- ✅ **No Emojis** - Code/commits/specs techniques
-- ✅ **Comments** - Uniquement pour le "pourquoi", pas le "quoi"
-- ✅ **Async/Await** - Pas de callbacks
-- ✅ **Error Handling** - Try/catch systématique
-
-### Checklist PR
-
-- [ ] Tests écrits et passants (coverage ≥ 80%)
-- [ ] Documentation mise à jour
-- [ ] Commit messages suivent convention
-- [ ] Code lint sans erreurs
-- [ ] Pas de breaking changes (ou documentées)
-- [ ] PR description complète
-
----
-
-## 📄 License
-
-**MIT License**
-
-Copyright (c) 2026 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
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-## 🌐 Ressources
-
-- **Documentation BMAD :** [GitHub Wiki](https://github.com/Yan-Acadenice/BYAN/wiki)
-- **BYAN Agent :** Créateur d'agents intelligent
-- **RACHID Agent :** Déploiement NPM
-- **MARC Agent :** Intégration GitHub Copilot CLI
-- **PATNOTE Agent :** Gestion des mises à jour
-- **CARMACK Agent :** Optimisation tokens (-46%)
-
----
-
-## 📧 Support
-
-- **Issues :** [GitHub Issues](https://github.com/Yan-Acadenice/BYAN/issues)
-- **Discussions :** [GitHub Discussions](https://github.com/Yan-Acadenice/BYAN/discussions)
-- **Email :** yan@example.com
-
----
-
-# 🇬🇧 ENGLISH VERSION
-
----
-
-# 🏗️ YANSTALLER - Intelligent BYAN Installer
-
-[![Version](https://img.shields.io/badge/version-1.2.3-blue.svg)](https://www.npmjs.com/package/create-byan-agent)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
-[![Tests](https://img.shields.io/badge/tests-168%20passing-success.svg)](#tests)
-
-**YANSTALLER** is the intelligent installer for the **BYAN** (Builder of YAN) ecosystem. It automatically detects your development environment, recommends appropriate agents, and installs them with multi-platform support.
-
-> 📦 **Based on [BMAD](https://github.com/yanb94/byan)** - Business Modeling & Agent Development Platform  
-> ✍️ **Made by [Yan de Acadenice](https://acadenice.fr/)**
-
-**Methodology:** Merise Agile + TDD + 64 Mantras  
-**Languages:** 🇬🇧 English | 🇫🇷 Français
-
----
-
-## 📋 Table of Contents
-
-1. [Features](#-features)
-2. [Installation](#-quick-installation)
-3. [Usage](#-usage)
-4. [Architecture](#-architecture)
-5. [Modules](#-modules)
-6. [API Reference](#-api-reference)
-7. [Tests](#-tests)
-8. [Development](#-development)
-9. [Contributing](#-contributing)
-10. [License](#-license)
-
----
-
-## ✨ Features
-
-### 🎯 Intelligent Detection
-- ✅ **Automatic detection** of platforms (GitHub Copilot CLI, VSCode, Claude Code, Codex)
-- ✅ **Project analysis** via `package.json` (20+ recognized frameworks)
-- ✅ **Contextual recommendations** of agents based on your stack
-
-### 🤖 Available Agents (29 agents)
-- **BMB (Meta):** BYAN, BYAN-Test, RACHID, MARC, PATNOTE, CARMACK, Agent-Builder, Module-Builder, Workflow-Builder
-- **BMM (SDLC):** Analyst, PM, Architect, Dev, SM, Quinn, UX-Designer, Tech-Writer, Quick-Flow-Solo-Dev
-- **TEA (Testing):** TEA (Test Architecture Expert)
-- **CIS (Innovation):** Brainstorming-Coach, Design-Thinking-Coach, Creative-Problem-Solver, Innovation-Strategist, Presentation-Master, Storyteller
-- **Core:** Party-Mode, BMAD-Master
-
-### 🚀 Intelligent Installation
-- ✅ **Complete BMAD structure** (19 directories created automatically)
-- ✅ **Generated YAML configuration** with metadata
-- ✅ **Multi-platform stubs** (Copilot CLI, VSCode, Claude Code, Codex)
-- ✅ **MCP Server setup** for Claude Code
-- ✅ **CSV manifests** for agent tracking
-
-### 🔍 Automated Validation (10 checks)
-- Verify `_bmad/` structure
-- Validate agent files
-- Check YAML frontmatter
-- Validate permissions
-- Verify npm dependencies
-- Test manifests, workflows, templates
-
-### 🛠️ Intelligent Troubleshooting
-- ✅ **8 error patterns** automatically recognized
-- ✅ **Auto-fix** for permissions, corrupted structure, dependencies
-- ✅ **Contextual diagnostics** (Node version, Git, disk space)
-- ✅ **OS-specific upgrade suggestions**
-
-### 💾 Backup & Rollback
-- ✅ **Automatic backup** before installation
-- ✅ **Metadata** (timestamp, size, files)
-- ✅ **Secure restore** with pre-restore backup
-- ✅ **Automatic cleanup** of old backups
-
-### 🧙 Post-Installation Wizard
-- ✅ **7-question interview** (<5 min)
-- ✅ **Conversational mode** with inquirer
-- ✅ **4 post-install options**: create agent, test, docs, exit
-- ✅ **Interactive quick-start guide**
-
----
-
-## 🚀 Quick Installation
-
-### Prerequisites
-- **Node.js** ≥ 18.0.0
-- **Git** installed
-- At least **1 platform**: GitHub Copilot CLI, VSCode, Claude Code, or Codex
-
-### Via NPX (recommended)
-```bash
-# Interactive installation
-npx create-byan-agent
-
-# Follow the 7-question interview (5 min)
-```
-
-### Via NPM Global
-```bash
-# Install globally
-npm install -g create-byan-agent
-
-# Run
-create-byan-agent
-```
-
-### Manual Installation
-```bash
-# Clone the repository
-git clone https://github.com/Yan-Acadenice/BYAN.git
-cd BYAN/install
-
-# Install dependencies
-npm install
-
-# Launch installer
-npm start
-```
-
----
-
-## 🎮 Usage
-
-### Interview Mode (Recommended)
-```bash
-npx create-byan-agent
-```
-
-**7 interactive questions:**
-1. Your name (for personalized configuration)
-2. Communication language (Français/English)
-3. Installation mode (Recommended/Custom/Minimal/Full)
-4. Agent selection (if Custom)
-5. Target platforms (Copilot/VSCode/Claude/Codex)
-6. Install sample agent (yes/no)
-7. Create backup (yes/no)
-
-### Programmatic Mode
-
-#### JavaScript API
-```javascript
-const yanstaller = require('create-byan-agent');
-
-// Detection
-const detection = await yanstaller.detect({
-  projectRoot: process.cwd()
-});
-console.log(detection.platforms); // ['copilot-cli', 'vscode']
-
-// Recommendation
-const recommendations = await yanstaller.recommend({
-  projectRoot: process.cwd(),
-  detection
-});
-console.log(recommendations.agents); // ['dev', 'architect', 'quinn']
-
-// Installation
-const result = await yanstaller.install({
-  projectRoot: process.cwd(),
-  agents: ['byan', 'dev', 'quinn'],
-  platforms: ['copilot-cli', 'vscode'],
-  userName: 'Yan',
-  language: 'English'
-});
-
-// Validation
-const validation = await yanstaller.validate({
-  projectRoot: process.cwd()
-});
-console.log(validation.errors); // []
-```
-
-#### CLI Options
+# BYAN - Builder of YAN
+
+**Version:** 1.1.1  
+**Methodology:** Merise Agile + TDD + 64 Mantras  
+**Agents Included:** BYAN, BYAN-Test, RACHID, MARC, PATNOTE, CARMACK
+
+---
+
+## 📚 Documentation
+
+### 🆕 **[Installation Guide for Beginners](https://github.com/Yan-Acadenice/BYAN/blob/main/install/GUIDE-INSTALLATION-BYAN-SIMPLE.md)** ⭐ NEW!
+Complete step-by-step installation guide for Windows + Linux users:
+- ✅ GitHub Copilot CLI installation (detailed)
+- ✅ Claude Code installation (with MCP)
+- ✅ 10 troubleshooting scenarios
+- ✅ 8 FAQ with solutions
+- ✅ Beginner-friendly explanations
+- ✅ Copy-paste ready commands
+
+**Perfect for:** First-time users, Windows users, troubleshooting installation issues
+
+### ⚡ **[Quickstart Guide - 5 Minutes](https://github.com/Yan-Acadenice/BYAN/blob/main/install/QUICKSTART.md)** 🚀 NEW!
+Ultra-condensed installation for experienced developers:
+- ⚡ Zero explanations, only commands
+- ⚡ 5-minute install promise
+- ⚡ GitHub Copilot CLI + Claude Code
+- ⚡ 1-minute troubleshooting fixes
+- ⚡ Agent reference table
+
+**Perfect for:** Experienced developers, quick setup, command reference
+
+---
+
+## 🏗️ What is BYAN?
+
+**BYAN (Builder of YAN)** is an intelligent agent creator that generates specialized AI agents through structured interviews.
+
+**Key Features:**
+- 30-45 min intelligent interview process
+- Applies 64 mantras systematically
+- Zero Trust philosophy (challenges requirements)
+- Multi-platform support (Copilot, VSCode, Claude, Codex)
+- TDD-driven validation
+- Consequences evaluation before actions
+- **Core Team:** BYAN (creator), RACHID (npm), MARC (copilot), PATNOTE (updates), CARMACK (optimizer)
+- **Optimized:** BYAN-Test version with 46% token reduction
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+**Option 1: NPX (Recommended)**
+```bash
+npx create-byan-agent
+```
+
+**Option 2: Bash Script**
+```bash
+curl -fsSL https://raw.githubusercontent.com/yan/byan/main/install/install.sh | bash
+```
+
+**Option 3: Manual**
+```bash
+git clone https://github.com/yan/byan.git
+cd byan
+./install/install.sh
+```
+
+---
+
+## 📖 Usage
+
+### Activate Agents
+
+**GitHub Copilot CLI:**
+```bash
+copilot
+# In interactive mode:
+/agent
+# Select one of:
+# - byan (create agents - standard version)
+# - byan-test (create agents - optimized 46% fewer tokens)
+# - rachid (NPM deployment specialist)
+# - marc (Copilot CLI integration expert)
+# - patnote (Update manager & conflict resolution)
+# - carmack (Token optimizer for agents)
+```
+
+**VSCode:**
+1. Open Command Palette (Ctrl+Shift+P)
+2. Type: "Activate Agent"
+3. Select from: BYAN, BYAN-Test, RACHID, MARC, PATNOTE, CARMACK
+
+**Claude Code:**
 ```bash
-# Silent installation with specific agents
-create-byan-agent --silent --agents=byan,dev,quinn
-
-# Force interactive prompts (useful inside npm scripts or CI shells without TTY)
-create-byan-agent --interactive
-
-# Custom mode with specific platform
-create-byan-agent --mode=custom --platforms=copilot-cli
-
-# Install on all supported platforms
-create-byan-agent --platforms=all
-
-# Disable agent-assisted interview (fallback to classic prompts)
-create-byan-agent --no-agent-interview
-
-# Agent-assisted interview provider (auto selection)
-# Priority: Copilot CLI → Codex CLI → Claude CLI (if available)
-# Override provider explicitly (if installed):
-# create-byan-agent --agent-provider=codex
-
-# Full installation without backup
-create-byan-agent --mode=full --no-backup
-
-# Dry-run (simulation)
-create-byan-agent --dry-run
-
-# Verbose logging
-create-byan-agent --verbose
-```
-
----
-
-## 🏛️ Architecture
-
-### Project Structure
-```
-install/
-├── bin/
-│   └── create-byan-agent.js      # CLI entry point
-├── lib/
-│   ├── yanstaller/                # Core modules
-│   │   ├── detector.js            # Platform & project detection
-│   │   ├── recommender.js         # Agent recommendations
-│   │   ├── installer.js           # Installation orchestration
-│   │   ├── validator.js           # Post-install validation
-│   │   ├── troubleshooter.js      # Error diagnosis & auto-fix
-│   │   ├── backuper.js            # Backup & restore
-│   │   ├── interviewer.js         # Interactive interview
-│   │   └── wizard.js              # Post-install wizard
-│   ├── platforms/                 # Platform adapters
-│   │   ├── copilot-cli.js         # GitHub Copilot CLI
-│   │   ├── vscode.js              # VSCode extension
-│   │   ├── claude-code.js         # Claude Code MCP
-│   │   └── codex.js               # Codex platform
-│   ├── utils/                     # Utilities
-│   │   ├── file-utils.js          # File operations
-│   │   ├── logger.js              # Logging system
-│   │   └── yaml-utils.js          # YAML parsing
-│   ├── errors.js                  # Error definitions
-│   └── exit-codes.js              # Exit code constants
-├── templates/                     # Agent templates
-│   └── _bmad/
-│       ├── core/agents/
-│       ├── bmm/agents/
-│       ├── bmb/agents/
-│       ├── tea/agents/
-│       └── cis/agents/
-├── __tests__/                     # Test suite (168 tests)
-└── package.json
-```
-
-### Installation Flow
-
-```
-┌─────────────────────────────────────────────────────────┐
-│  1. DETECT - Platform & Project Analysis               │
-│     • Scan for Copilot CLI, VSCode, Claude, Codex      │
-│     • Analyze package.json dependencies                 │
-│     • Detect project type & framework                   │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  2. RECOMMEND - Intelligent Agent Selection             │
-│     • Match agents to project type                      │
-│     • Consider detected platforms                       │
-│     • Generate rationale for each recommendation        │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  3. INTERVIEW - User Preferences (7 questions)          │
-│     • Name, language, mode                              │
-│     • Agent selection (if custom)                       │
-│     • Platform targets, backup option                   │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  4. BACKUP - Pre-install Safety (optional)              │
-│     • Create timestamped backup of _bmad/               │
-│     • Save metadata (files, size, version)              │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  5. INSTALL - Core Installation                         │
-│     • Create _bmad/ structure (19 directories)          │
-│     • Copy agent templates from 5 modules               │
-│     • Generate platform stubs (Copilot/VSCode/etc.)     │
-│     • Create module configs (YAML with metadata)        │
-│     • Update manifests (agent-manifest.csv)             │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  6. VALIDATE - 10 Automated Checks                      │
-│     • Structure, agents, stubs, configs                 │
-│     • Permissions, manifests, workflows                 │
-│     • Templates, dependencies                           │
-└────────────────────┬────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────┐
-│  7. WIZARD - Post-Install Actions                       │
-│     • Summary of installed agents                       │
-│     • Option: Create new agent (launch BYAN)            │
-│     • Option: Test agent                                │
-│     • Option: View documentation                        │
-│     • Quick start guide                                 │
-└─────────────────────────────────────────────────────────┘
-```
-
----
-
-## 📦 Modules
-
-_(Same detailed module documentation as French version, translated to English)_
-
-### 1. Detector
-**File:** `lib/yanstaller/detector.js`
-
-**Purpose:** Detects installed platforms and analyzes the project.
-
-**API:** _(Same as French version)_
-
-### 2-8. _(Other modules follow same structure as French version)_
-
----
-
-## 🧪 Tests
-
-### Test Suite (168 tests)
-
-**Coverage:**
-```bash
-npm test
-```
-
-**Test files:**
-```
-__tests__/
-├── recommender.test.js         (18 tests) - Agent recommendations
-├── installer.test.js           (13 tests) - Core installation
-├── platforms.test.js           (20 tests) - Platform adapters
-├── validator.test.js           (24 tests) - 10-check validation
-├── integration.test.js         (27 tests) - Integration tests
-├── e2e.test.js                 (16 tests) - End-to-end scenarios
-├── troubleshooter.test.js      (20 tests) - Diagnostic & auto-fix
-├── backuper.test.js            (20 tests) - Backup & restore
-└── interviewer-wizard.test.js  (10 tests) - Interview & wizard
-```
-
----
-
-## 🛠️ Development
-
-### Local Setup
-
-```bash
-# Clone repository
-git clone https://github.com/Yan-Acadenice/BYAN.git
-cd BYAN/install
-
-# Install dependencies
-npm install
-
-# Run in dev mode
-npm start
-
-# Tests
-npm test
-
-# Linter
-npm run lint
-```
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! Please follow these guidelines:
-
-### Contribution Process
-
-1. **Fork** the repository
-2. **Create a branch**: `git checkout -b feature/my-feature`
-3. **Write tests** (TDD mandatory)
-4. **Implement** the feature
-5. **Tests pass**: `npm test`
-6. **Commit**: `git commit -m "feat: add my-feature"`
-7. **Push**: `git push origin feature/my-feature`
-8. **Pull Request** with detailed description
-
----
-
-## 📄 License
-
-**MIT License**
-
-Copyright (c) 2026 Yan
-
-_(Full MIT license text as in French version)_
-
----
-
-## 🌐 Resources
-
-- **BMAD Documentation:** [GitHub Wiki](https://github.com/Yan-Acadenice/BYAN/wiki)
-- **BYAN Agent:** Intelligent agent creator
-- **RACHID Agent:** NPM deployment
-- **MARC Agent:** GitHub Copilot CLI integration
-- **PATNOTE Agent:** Update management
-- **CARMACK Agent:** Token optimization (-46%)
-
----
-
-## 📧 Support
-
-- **Issues:** [GitHub Issues](https://github.com/Yan-Acadenice/BYAN/issues)
-- **Discussions:** [GitHub Discussions](https://github.com/Yan-Acadenice/BYAN/discussions)
-- **Email:** yan@example.com
-
----
-
-**Made with ❤️ by Yan | Merise Agile + TDD + 64 Mantras**
+# Choose your agent:
+claude chat --agent byan          # Full-featured creator
+claude chat --agent byan-test     # Optimized creator (46% fewer tokens)
+claude chat --agent rachid        # NPM deployment
+claude chat --agent marc          # Copilot CLI integration
+claude chat --agent patnote       # Update manager
+claude chat --agent carmack       # Token optimizer
+```
+
+### Create Your First Agent
+
+**Full Interview (30-45 min):**
+```
+[INT] Start Intelligent Interview
+```
+Best for: First agent, critical agents, complex requirements
+
+**Quick Create (10 min):**
+```
+[QC] Quick Create
+```
+Best for: Additional agents, clear requirements, existing project context
+
+---
+
+## 🎯 Five Specialized Agents
+
+### 1. BYAN & BYAN-Test - Agent Creators
+
+**BYAN (Standard)** - Full-featured agent creator with rich documentation
+**BYAN-Test (Optimized)** - Token-optimized version (-46% tokens, same capabilities)
+
+**Full Interview (30-45 min):**
+```
+[INT] Start Intelligent Interview
+```
+Best for: First agent, critical agents, complex requirements
+
+**Quick Create (10 min):**
+```
+[QC] Quick Create
+```
+Best for: Additional agents, clear requirements, existing project context
+
+**Role:** Intelligent agent creation through structured interviews. Applies 64 mantras systematically, Zero Trust philosophy, and consequences evaluation.
+
+---
+
+### 2. RACHID - NPM/NPX Deployment Specialist 📦
+
+**Deploy to NPM:**
+```
+[PUBLISH] Publish to npm
+[VALIDATE] Validate _bmad structure
+[TEST-NPX] Test npx installation
+[AUDIT] Security audit
+[FIX-DEPS] Fix dependencies
+```
+
+**Role:** Elite Node.js deployment specialist. Masters npm/npx, package.json, create-* CLI patterns. Ensures dependency integrity and secure installations. Trust But Verify philosophy on all packages.
+
+**Best for:** Package deployment, dependency management, npm workflows, version bumps, publishing to npm registry.
+
+---
+
+### 3. MARC - GitHub Copilot CLI Integration Expert 🔧
+
+**Copilot Integration:**
+```
+[VALIDATE] Validate .github/agents/
+[TEST] Test /agent detection
+[CREATE-STUB] Create agent stub
+[FIX-YAML] Fix YAML frontmatter
+[MCP-CONFIG] Configure MCP server
+```
+
+**Role:** GitHub Copilot CLI integration specialist. Ensures agents are properly detected by `/agent` command. Masters YAML frontmatter, MCP configuration, and Copilot CLI debugging.
+
+**Best for:** GitHub Copilot CLI integration, agent detection issues, MCP server configuration, YAML validation.
+
+---
+
+### 4. PATNOTE - Update Manager & Conflict Resolution Specialist 📝
+
+**Update Management:**
+```
+[UPDATE-AGENT] Update existing agent
+[MERGE-VERSIONS] Merge agent versions
+[DETECT-CONFLICTS] Detect conflicts
+[BACKUP-RESTORE] Backup/Restore agents
+[CHANGELOG] Generate changelog
+```
+
+**Role:** Guardian of BYAN updates. Detects conflicts between versions, merges changes intelligently, preserves user customizations. Tracks all modifications in detailed changelogs. Never loses data.
+
+**Best for:** Updating existing agents, merging BYAN versions, resolving conflicts, maintaining agent history.
+
+---
+
+### 5. CARMACK - Token Optimizer for BMAD/BYAN Agents ⚡
+
+**Token Optimization:**
+```
+[OPTIMIZE] Optimize agent for tokens
+[ANALYZE] Analyze token usage
+[VALIDATE] Validate optimized agent
+[COMPARE] Compare before/after
+[BATCH] Batch optimize multiple agents
+```
+
+**Role:** Token optimization expert inspired by John Carmack's efficiency principles. Reduces token usage by 40-50% while preserving functionality. Surgical precision in removing redundancy, restructuring content, and optimizing prompts.
+
+**Best for:** Reducing LLM token costs, optimizing agent performance, batch processing large agent sets, maintaining quality while cutting tokens.
+
+---
+
+## 🎯 BYAN Menu
+
+| Command | Description | Duration |
+|---------|-------------|----------|
+| **[INT]** | Intelligent Interview | 30-45 min |
+| **[QC]** | Quick Create | 10 min |
+| **[LA]** | List all agents | Instant |
+| **[EA]** | Edit existing agent | 10-20 min |
+| **[VA]** | Validate agent (64 mantras) | 5-10 min |
+| **[DA-AGENT]** | Delete agent (with backup) | 5 min |
+| **[PC]** | Show project context | Instant |
+| **[MAN]** | Display 64 mantras | Instant |
+
+---
+
+## 📚 Methodology
+
+BYAN applies **Merise Agile + TDD** with 64 mantras:
+
+### 39 Conception Mantras
+- Philosophy: Model serves business, not reverse
+- Agility: User stories → Entities (bottom-up)
+- Quality: KISS, DRY, YAGNI
+- Tests: TDD is not optional
+- Merise Rigor: Data Dictionary First, MCD ⇄ MCT
+- Problem Solving: Ockham's Razor, Inversion techniques
+- **Consequences: Evaluate 10 dimensions before action**
+
+### 25 AI Agent Mantras
+- Intelligence: Trust But Verify, Context is King
+- **Validation: Challenge Before Confirm**
+- Autonomy: Self-Aware Agent
+- **Code Quality: No Emoji Pollution, Clean Code**
+
+Full list: `_bmad/bmb/workflows/byan/data/mantras.yaml`
+
+---
+
+## 🔧 Project Structure
+
+```
+your-project/
+├── _bmad/
+│   ├── bmb/                      # BYAN Module
+│   │   ├── agents/
+│   │   │   └── byan.md          # BYAN agent definition
+│   │   ├── workflows/
+│   │   │   └── byan/
+│   │   │       ├── interview-workflow.md
+│   │   │       ├── quick-create-workflow.md
+│   │   │       ├── edit-agent-workflow.md
+│   │   │       ├── validate-agent-workflow.md
+│   │   │       ├── delete-agent-workflow.md
+│   │   │       ├── templates/
+│   │   │       │   └── base-agent-template.md
+│   │   │       └── data/
+│   │   │           ├── mantras.yaml
+│   │   │           └── templates.yaml
+│   │   └── config.yaml           # Module configuration
+│   ├── core/                     # BMAD Core
+│   ├── _output/                  # Generated files
+│   └── {your-module}/
+│       └── agents/               # Your generated agents
+└── install/
+    ├── install.sh               # Bash installer
+    ├── package.json             # NPX package
+    └── bin/
+        └── create-byan-agent.js # NPX installer script
+```
+
+---
+
+## 🎓 Interview Process
+
+BYAN conducts a 4-phase interview:
+
+### Phase 1: Project Context (15-30 min)
+- Project name, description, domain
+- Technical stack and constraints
+- Team size, skills, maturity
+- **Pain points (5 Whys on main pain)**
+- Goals and success criteria
+
+### Phase 2: Business/Domain (15-20 min)
+- Business domain deep dive
+- **Interactive glossary (minimum 5 concepts)**
+- Actors, processes, business rules
+- Edge cases and constraints
+- Regulatory requirements
+
+### Phase 3: Agent Needs (10-15 min)
+- Agent role and responsibilities
+- Required knowledge (business + technical)
+- **Capabilities (minimum 3)**
+- **Mantras to prioritize (minimum 5)**
+- Communication style
+- **Use cases (minimum 3)**
+
+### Phase 4: Validation (10 min)
+- Complete synthesis
+- **Challenge inconsistencies**
+- Validate with user
+- Create ProjectContext
+- Finalize AgentSpec
+
+---
+
+## ✅ Validation
+
+BYAN validates agents against:
+- Business rules (RG-AGT-001 to RG-DEL-002)
+- 64 Mantras compliance
+- BMAD format standards
+- Best practices
+
+**Validation Levels:**
+- 🔴 CRITICAL: Must pass (deployment blocked)
+- 🟡 IMPORTANT: Should pass (warnings)
+- 🟢 SUGGESTIONS: Nice to have
+
+**Grading:**
+- A+ (95-100): Exemplary
+- A (90-94): Excellent
+- B (80-89): Good
+- C (70-79): Acceptable
+- D (60-69): Needs improvement
+- F (<60): Failing
+
+---
+
+## 🛡️ Zero Trust Philosophy
+
+BYAN never blindly accepts requirements:
+
+**Challenge Before Confirm:**
+- Detects inconsistencies
+- Questions assumptions
+- Plays devil's advocate
+- Signals problems early
+
+**Trust But Verify:**
+- Validates all inputs
+- Cross-checks data
+- Ensures coherence
+
+**Example:**
+```
+User: "I need an agent that does everything"
+BYAN: "I'm challenging that requirement. Wouldn't a specialized 
+agent that does ONE thing exceptionally well be more valuable? 
+What's the ONE most critical capability you need?"
+```
+
+---
+
+## 📊 Consequences Evaluation
+
+Before any important action, BYAN evaluates 10 dimensions:
+
+1. **Scope:** Components affected
+2. **Data:** Database impacts
+3. **Code:** Files to modify
+4. **Team:** People affected
+5. **Clients:** User workflows
+6. **Legal:** Compliance
+7. **Operations:** Deployment complexity
+8. **Dependencies:** Systems impacted
+9. **Time:** Duration estimates
+10. **Alternatives:** Other options
+
+**Risk Levels:**
+- 🟢 LOW: Safe to proceed
+- 🟡 MEDIUM: Caution required
+- 🔴 HIGH: Team approval needed
+- 🔥 CRITICAL: Requires migration plan
+
+---
+
+## 📝 Configuration
+
+Edit `_bmad/bmb/config.yaml`:
+
+```yaml
+user_name: Your Name
+communication_language: Francais|English
+document_output_language: Francais|English
+output_folder: "{project-root}/_bmad-output"
+platform: copilot|vscode|claude|codex
+```
+
+---
+
+## 📄 License
+
+MIT License - See LICENSE file
+
+---
+
+## 🙏 Credits
+
+**Created by:** Yan + Carson (Brainstorming Coach)  
+**Methodology:** Merise Agile + TDD  
+**Mantras:** 64 principles from 2-hour brainstorming session  
+**Date:** 2026-02-02
+
+---
+
+**Happy agent building!** 🏗️