create-byan-agent 2.1.1 → 2.2.2

package/install/GUIDE-INSTALLATION-BYAN-SIMPLE.md

@@ -167,9 +167,9 @@ npx create-byan-agent@1.1.1
    - **Dossier de sortie ?** → Laissez par défaut (Entrée)
 
 2. Le script va créer :
-   - `_bmad/` → Agents et workflows
+   - `_byan/` → Agents et workflows
    - `.github/agents/` → Agents pour Copilot CLI
-   - `_bmad-output/` → Sorties générées
+   - `_byan-output/` → Sorties générées
 
 **⏱️ Temps estimé :** 2-3 minutes
 
@@ -305,9 +305,9 @@ Copiez-collez ce JSON dans le fichier :
   "mcpServers": {
     "byan-agents": {
       "command": "node",
-      "args": ["/chemin/vers/votre/projet/_bmad/mcp-server.js"],
+      "args": ["/chemin/vers/votre/projet/_byan/mcp-server.js"],
       "env": {
-        "BMAD_ROOT": "/chemin/vers/votre/projet/_bmad"
+        "BMAD_ROOT": "/chemin/vers/votre/projet/_byan"
       }
     }
   }
@@ -318,17 +318,17 @@ Copiez-collez ce JSON dans le fichier :
 
 **Windows exemple :**
 ```json
-"args": ["C:\\Users\\Yan\\conception\\_bmad\\mcp-server.js"],
+"args": ["C:\\Users\\Yan\\conception\\_byan\\mcp-server.js"],
 "env": {
-  "BMAD_ROOT": "C:\\Users\\Yan\\conception\\_bmad"
+  "BMAD_ROOT": "C:\\Users\\Yan\\conception\\_byan"
 }
 ```
 
 **Linux exemple :**
 ```json
-"args": ["/home/yan/conception/_bmad/mcp-server.js"],
+"args": ["/home/yan/conception/_byan/mcp-server.js"],
 "env": {
-  "BMAD_ROOT": "/home/yan/conception/_bmad"
+  "BMAD_ROOT": "/home/yan/conception/_byan"
 }
 ```
 
@@ -336,17 +336,17 @@ Copiez-collez ce JSON dans le fichier :
 
 **Étape 3 : Créez le script MCP serveur**
 
-**Créez le fichier `_bmad/mcp-server.js` :**
+**Créez le fichier `_byan/mcp-server.js` :**
 
 **Windows :**
 ```powershell
-cd $HOME\conception\_bmad
+cd $HOME\conception\_byan
 notepad mcp-server.js
 ```
 
 **Linux :**
 ```bash
-cd ~/conception/_bmad
+cd ~/conception/_byan
 nano mcp-server.js
 ```
 
@@ -434,7 +434,7 @@ gh copilot --agent=byan-test
 # Plus rapide, consomme 46% moins de tokens
 ```
 
-**Résultat :** Un agent personnalisé dans `_bmad-output/bmb-creations/`
+**Résultat :** Un agent personnalisé dans `_byan-output/bmb-creations/`
 
 ---
 
@@ -564,7 +564,7 @@ npx create-byan-agent@1.1.1
 **Réponse :** Le fichier `config.yaml` n'a pas été correctement initialisé.
 
 **Solution :**
-Éditez `_bmad/bmb/config.yaml` :
+Éditez `_byan/bmb/config.yaml` :
 ```yaml
 communication_language: Francais
 document_output_language: Francais
@@ -600,14 +600,14 @@ document_output_language: Francais
 **Réponse :**
 ```bash
 # Supprimez les dossiers créés
-rm -rf _bmad/
+rm -rf _byan/
 rm -rf .github/agents/
-rm -rf _bmad-output/
+rm -rf _byan-output/
 
 # Sur Windows :
-# rmdir /s _bmad
+# rmdir /s _byan
 # rmdir /s .github\agents
-# rmdir /s _bmad-output
+# rmdir /s _byan-output
 ```
 
 ---
@@ -782,18 +782,18 @@ npm install
    ```
 
 2. Vérifiez les chemins :
-   - `args` doit pointer vers `_bmad/mcp-server.js` (chemin absolu)
-   - `BMAD_ROOT` doit pointer vers `_bmad/` (chemin absolu)
+   - `args` doit pointer vers `_byan/mcp-server.js` (chemin absolu)
+   - `BMAD_ROOT` doit pointer vers `_byan/` (chemin absolu)
 
 3. Testez le serveur MCP manuellement :
    ```bash
-   node _bmad/mcp-server.js
+   node _byan/mcp-server.js
    ```
    
    **✅ Vous devriez voir :**
    ```
    BYAN MCP Server started
-   BMAD_ROOT: /home/yan/conception/_bmad
+   BMAD_ROOT: /home/yan/conception/_byan
    Agents disponibles: byan, byan-test, marc, rachid, patnote, carmack
    ```
 
@@ -875,9 +875,9 @@ Cochez chaque élément pour valider votre installation :
 
 ### Installation BYAN
 - [ ] NPX exécuté sans erreur (`npx create-byan-agent@1.1.1`)
-- [ ] Dossier `_bmad/` créé
+- [ ] Dossier `_byan/` créé
 - [ ] Dossier `.github/agents/` créé avec 27 fichiers
-- [ ] Fichier `_bmad/bmb/config.yaml` existe
+- [ ] Fichier `_byan/bmb/config.yaml` existe
 
 ### Tests Fonctionnels
 - [ ] `gh copilot` démarre sans erreur
@@ -929,7 +929,7 @@ gh copilot --agent=marc
 
 ```
 votre-projet/
-├── _bmad/                          # Platform code
+├── _byan/                          # Platform code
 │   ├── bmb/                        # BYAN Module
 │   │   ├── agents/
 │   │   │   ├── byan.md             # ✅ Agent BYAN standard
@@ -955,7 +955,7 @@ votre-projet/
 │       ├── bmad-agent-patnote.md   # ✅
 │       ├── bmad-agent-carmack.md   # ✅
 │       └── ... (21 autres agents BMAD)
-└── _bmad-output/                   # Generated artifacts
+└── _byan-output/                   # Generated artifacts
     ├── bmb-creations/              # Vos agents créés
     └── planning-artifacts/
 ```
@@ -998,13 +998,13 @@ npm view create-byan-agent  # Infos package npm
 
 ### Annexe C : Variables de Configuration
 
-**Fichier : `_bmad/bmb/config.yaml`**
+**Fichier : `_byan/bmb/config.yaml`**
 
 ```yaml
 user_name: Yan                      # Votre nom/prénom
 communication_language: Francais    # Francais ou English
 document_output_language: Francais  # Francais ou English
-output_folder: "{project-root}/_bmad-output"
+output_folder: "{project-root}/_byan-output"
 ```
 
 **Variables dynamiques :**

package/install/GUIDE-INSTALLATION-SIMPLE.md

@@ -0,0 +1,344 @@
+# Guide d'Installation BYAN - Version Simplifiée
+
+**Version:** 1.0.4  
+**Date:** 2 février 2026  
+**Pour:** Utilisateurs finaux
+
+---
+
+## 🎯 Installation en 3 Minutes
+
+### Prérequis
+
+- **Node.js 18+** installé
+- **Projet avec Git** (recommandé)
+- **GitHub Copilot CLI** activé (pour utilisation avec Copilot)
+
+### Installation via NPX (Recommandé)
+
+```bash
+npx create-byan-agent
+```
+
+**C'est tout !** L'installeur interactif vous guide :
+
+1. ✅ Détecte votre projet
+2. ✅ Choisissez votre plateforme (Copilot CLI / VSCode / Claude / Codex / Toutes)
+3. ✅ Configurez votre nom et langue
+4. ✅ Installe automatiquement tous les fichiers
+5. ✅ Vérifie l'installation
+
+---
+
+## 🚀 Utilisation Immédiate
+
+### Avec GitHub Copilot CLI
+
+```bash
+# Lancer Copilot
+copilot
+
+# Dans le prompt, taper:
+@byan
+
+# Ou bien activer via menu:
+/agent
+# Puis sélectionner: byan, rachid, ou marc
+```
+
+### Avec VSCode
+
+1. **Ouvrir Command Palette** : `Ctrl+Shift+P` (ou `Cmd+Shift+P` sur Mac)
+2. **Taper** : `Activate Agent`
+3. **Sélectionner** : `BYAN`, `RACHID`, ou `MARC`
+
+### Avec Claude Code
+
+```bash
+claude chat --agent byan
+# ou
+claude chat --agent rachid
+# ou
+claude chat --agent marc
+```
+
+---
+
+## 🏗️ Les 3 Agents BYAN
+
+### 1. BYAN - Créateur d'Agents
+
+**Quand l'utiliser :** Créer de nouveaux agents IA personnalisés
+
+**Menu Principal :**
+- `[INT]` Interview Intelligente (30-45 min) - Pour agents critiques
+- `[QC]` Quick Create (10 min) - Pour agents simples
+- `[EDIT]` Éditer un agent existant
+- `[VAL]` Valider un agent
+- `[DEL]` Supprimer un agent
+
+**Exemple d'utilisation :**
+```
+1. Activer BYAN
+2. Choisir [INT] pour interview complète
+3. Répondre aux questions guidées
+4. BYAN génère l'agent automatiquement
+```
+
+### 2. RACHID - Expert Déploiement NPM
+
+**Quand l'utiliser :** Publier/déployer sur npm, gérer dépendances
+
+**Menu Principal :**
+- `[INSTALL]` Installer BYAN via NPX
+- `[VALIDATE]` Valider structure _byan
+- `[FIX-DEPS]` Corriger dépendances npm
+- `[UPDATE-PKG]` Mettre à jour package.json
+- `[PUBLISH]` Publier sur npm
+- `[TEST-NPX]` Tester installation npx
+- `[AUDIT]` Audit de sécurité
+- `[HELP]` Aide NPM
+
+**Exemple d'utilisation :**
+```
+1. Activer RACHID
+2. Choisir [VALIDATE] pour vérifier installation
+3. Choisir [PUBLISH] pour publier sur npm
+```
+
+### 3. MARC - Expert GitHub Copilot CLI
+
+**Quand l'utiliser :** Intégrer agents avec GitHub Copilot CLI
+
+**Menu Principal :**
+- `[INSTALL]` Installer agent dans .github/agents/
+- `[TEST]` Tester détection agent
+- `[FIX]` Corriger problèmes détection
+- `[LIST]` Lister agents installés
+- `[DOC]` Documentation Copilot CLI
+- `[HELP]` Aide intégration
+
+**Exemple d'utilisation :**
+```
+1. Activer MARC
+2. Choisir [INSTALL] pour installer un agent
+3. Choisir [TEST] pour vérifier détection
+```
+
+---
+
+## 📁 Structure Installée
+
+Après installation, votre projet contient :
+
+```
+votre-projet/
+├── _byan/                          # Dossier BMAD principal
+│   ├── bmb/                        # Module BMB (BYAN)
+│   │   ├── agents/                 # Agents sources
+│   │   │   ├── byan.md
+│   │   │   ├── rachid.md
+│   │   │   └── marc.md
+│   │   ├── workflows/              # Workflows BYAN
+│   │   │   └── byan/
+│   │   │       ├── interview-workflow.md
+│   │   │       ├── quick-create-workflow.md
+│   │   │       ├── edit-agent-workflow.md
+│   │   │       ├── validate-agent-workflow.md
+│   │   │       ├── templates/
+│   │   │       └── data/
+│   │   └── config.yaml             # Configuration BYAN
+│   ├── _config/                    # Manifests agents/workflows
+│   └── _memory/                    # Mémoire persistante agents
+│
+├── .github/
+│   └── agents/                     # Agents pour Copilot CLI
+│       ├── bmad-agent-byan.md
+│       ├── bmad-agent-rachid.md
+│       └── bmad-agent-marc.md
+│
+└── _byan-output/                   # Agents créés par BYAN
+    └── bmb-creations/
+```
+
+---
+
+## 🎓 Workflow Typique
+
+### Scénario : Créer un agent de backend Node.js
+
+1. **Activer BYAN**
+   ```bash
+   copilot
+   @byan
+   ```
+
+2. **Lancer Interview**
+   ```
+   [INT] Start Intelligent Interview
+   ```
+
+3. **Répondre aux Questions**
+   - Nom de l'agent : `backend-expert`
+   - Rôle : Expert Node.js backend
+   - Capacités : API REST, database, auth
+   - Mantras principaux : KISS, YAGNI, Trust But Verify
+   - etc.
+
+4. **BYAN génère l'agent**
+   - Créé dans `_byan-output/bmb-creations/backend-expert.md`
+
+5. **Installer avec MARC**
+   ```
+   @marc
+   [INSTALL]
+   ```
+
+6. **Utiliser votre agent**
+   ```bash
+   copilot
+   @backend-expert
+   ```
+
+---
+
+## ⚙️ Configuration
+
+Le fichier `_byan/bmb/config.yaml` contient :
+
+```yaml
+# Dossier de sortie pour créations BYAN
+bmb_creations_output_folder: "{project-root}/_byan-output/bmb-creations"
+
+# Votre nom (utilisé par agents)
+user_name: VotreNom
+
+# Langue de communication avec agents
+communication_language: Francais  # ou English
+
+# Langue des documents générés
+document_output_language: Francais  # ou English
+
+# Dossier de sortie général
+output_folder: "{project-root}/_byan-output"
+
+# Plateforme cible
+platform: copilot  # ou vscode, claude, codex, all
+```
+
+**Modifier la configuration :** Éditez `config.yaml` directement.
+
+---
+
+## 🆘 Dépannage Rapide
+
+### Agent non détecté dans Copilot CLI
+
+**Solution avec MARC :**
+```
+@marc
+[TEST]  # Teste la détection
+[FIX]   # Corrige automatiquement
+```
+
+### Installation incomplète
+
+**Solution avec RACHID :**
+```
+@rachid
+[VALIDATE]  # Vérifie structure
+```
+
+### Erreur de dépendances npm
+
+**Solution avec RACHID :**
+```
+@rachid
+[FIX-DEPS]  # Corrige dépendances
+```
+
+### Agent créé mais ne fonctionne pas
+
+**Solution avec BYAN :**
+```
+@byan
+[VAL]  # Valide l'agent
+```
+
+---
+
+## 🔄 Mise à Jour BYAN
+
+Pour mettre à jour vers la dernière version :
+
+```bash
+# Réinstaller via NPX
+npx create-byan-agent
+
+# L'installeur détecte installation existante et propose mise à jour
+```
+
+---
+
+## 📚 Ressources
+
+- **README complet** : `/install/README.md`
+- **Changelog** : `/install/CHANGELOG.md`
+- **Guide publication** : `/install/PUBLISH-GUIDE.md`
+- **Checklist publication** : `/install/PUBLICATION-CHECKLIST.md`
+
+---
+
+## 💡 Conseils Pro
+
+1. **Premier agent** : Utilisez `[INT]` interview complète (30-45 min)
+2. **Agents suivants** : `[QC]` Quick Create suffit (10 min)
+3. **Testez toujours** : Validez avec `[VAL]` avant utilisation
+4. **Documentation** : BYAN génère automatiquement la doc de l'agent
+5. **Itération** : Utilisez `[EDIT]` pour améliorer agents existants
+
+---
+
+## 🎯 Cas d'Usage Populaires
+
+### Agent pour Tests Automatisés
+```
+@byan
+[INT]
+- Rôle: Expert QA automation
+- Capacités: Playwright, Cypress, Jest
+- Focus: Tests E2E, intégration, unitaires
+```
+
+### Agent pour Documentation
+```
+@byan
+[INT]
+- Rôle: Technical Writer
+- Capacités: Markdown, API docs, guides
+- Focus: Clarity, examples, structure
+```
+
+### Agent pour Architecture
+```
+@byan
+[INT]
+- Rôle: Solution Architect
+- Capacités: System design, scalability, patterns
+- Focus: Clean architecture, SOLID, DDD
+```
+
+---
+
+## 🤝 Support
+
+**Questions ?** Activez n'importe quel agent et tapez :
+```
+/bmad-help Votre question ici
+```
+
+**Bugs/Suggestions :** Ouvrir une issue sur le repo GitHub
+
+---
+
+**Bon agent building ! 🏗️**

package/install/INSTALLER-V2-CHANGES.md

@@ -10,7 +10,7 @@
 ## 🎯 Objective
 
 Adapt the Yanstaller (BYAN installer) to support the new BYAN v2.0 architecture, which includes both:
-- **Platform assets** (`_bmad/` structure - existing v1.0)
+- **Platform assets** (`_byan/` structure - existing v1.0)
 - **Runtime components** (`src/`, `__tests__/` - new v2.0)
 
 ---
@@ -116,14 +116,14 @@ The installer intelligently merges `package.json`:
 
 ### 5. Configuration Updates
 
-The `_bmad/bmb/config.yaml` now includes version tracking:
+The `_byan/bmb/config.yaml` now includes version tracking:
 
 ```yaml
-bmb_creations_output_folder: "{project-root}/_bmad-output/bmb-creations"
+bmb_creations_output_folder: "{project-root}/_byan-output/bmb-creations"
 user_name: Yan
 communication_language: Francais
 document_output_language: Francais
-output_folder: "{project-root}/_bmad-output"
+output_folder: "{project-root}/_byan-output"
 platform: copilot
 byan_version: "2.0.0-alpha.1"  # ← NEW: Version tracking
 ```
@@ -197,7 +197,7 @@ byan_version: "2.0.0-alpha.1"  # ← NEW: Version tracking
   - Still functional
   - Kept as fallback
 
-- **`_bmad/`** structure (PRESERVED)
+- **`_byan/`** structure (PRESERVED)
   - No changes to platform assets
   - Agents still work
   - Workflows still work
@@ -269,7 +269,7 @@ create-byan-agent
 
 | Feature | v1.0 | v2.0 |
 |---------|------|------|
-| Platform Assets (`_bmad/`) | ✅ | ✅ |
+| Platform Assets (`_byan/`) | ✅ | ✅ |
 | Runtime Components (`src/`) | ❌ | ✅ |
 | Test Suite (`__tests__/`) | ❌ | ✅ |
 | Entry Point (`src/index.js`) | ❌ | ✅ |
@@ -291,7 +291,7 @@ create-byan-agent
 
 1. **Backup your configuration:**
    ```bash
-   cp _bmad/bmb/config.yaml _bmad/bmb/config.yaml.backup
+   cp _byan/bmb/config.yaml _byan/bmb/config.yaml.backup
    ```
 
 2. **Run v2.0 installer:**
@@ -365,7 +365,7 @@ create-byan-agent
 2. **Test installer in real scenarios:**
    - New project (no package.json)
    - Existing Node project (has package.json)
-   - Existing BYAN v1.0 project (has _bmad/)
+   - Existing BYAN v1.0 project (has _byan/)
 
 3. **Update documentation:**
    - README.md in install/ directory
@@ -454,7 +454,7 @@ create-byan-agent
 - Verify source files: `ls -la src/ __tests__/`
 
 **Questions?**
-- BYAN Documentation: `_bmad-output/`
+- BYAN Documentation: `_byan-output/`
 - Installer code: `install/bin/create-byan-agent-v2.js`
 - This document: `install/INSTALLER-V2-CHANGES.md`