create-byan-agent 2.1.1 → 2.2.2

package/install/MARC-COPILOT-CLI-TEST-GUIDE.md

@@ -0,0 +1,441 @@
+# 🧪 MARC - Quick Test Guide for Copilot CLI Integration
+
+**Package:** create-byan-agent v1.0.4  
+**Test Duration:** 10 minutes  
+**Tester:** Rachid (ou tout utilisateur)
+
+---
+
+## 🎯 OBJECTIF
+
+Valider que les agents BYAN, RACHID et MARC sont correctement détectés et activables dans GitHub Copilot CLI.
+
+---
+
+## 📋 PRÉREQUIS
+
+- ✅ GitHub Copilot CLI installé
+- ✅ Package `create-byan-agent` installé dans un projet test
+- ✅ Projet Git initialisé (recommandé)
+
+**Installation:**
+```bash
+mkdir /tmp/test-copilot-integration
+cd /tmp/test-copilot-integration
+git init
+npx create-byan-agent
+# Suivre l'installation interactive
+```
+
+---
+
+## 🧪 TEST 1: Détection Agents (3 min)
+
+### Commande
+
+```bash
+copilot
+```
+
+**Dans le prompt Copilot, taper:**
+```
+/agent
+```
+
+### Résultat Attendu
+
+Une liste d'agents devrait s'afficher incluant :
+
+```
+Available agents:
+- bmad-agent-byan - byan agent
+- bmad-agent-rachid - NPM/NPX deployment specialist for BYAN installation
+- bmad-agent-marc - GitHub Copilot CLI integration specialist for BMAD agents
+[... autres agents si présents ...]
+```
+
+### ✅ PASS SI:
+- [ ] Les 3 agents (byan, rachid, marc) apparaissent dans la liste
+- [ ] Les noms commencent par `bmad-agent-`
+- [ ] Les descriptions sont affichées
+
+### ❌ FAIL SI:
+- [ ] Aucun agent n'apparaît
+- [ ] Un ou plusieurs agents manquent
+- [ ] Erreur de parsing YAML
+
+**Diagnostic si FAIL:**
+```bash
+# Vérifier présence des fichiers
+ls -la .github/agents/bmad-agent-*.md
+
+# Vérifier YAML frontmatter
+head -n 5 .github/agents/bmad-agent-byan.md
+# Doit commencer par:
+# ---
+# name: 'bmad-agent-byan'
+# description: '...'
+# ---
+```
+
+---
+
+## 🧪 TEST 2: Activation BYAN (2 min)
+
+### Commande
+
+**Dans le prompt Copilot, taper:**
+```
+@byan
+```
+
+OU sélectionner dans le menu `/agent` puis choisir `bmad-agent-byan`.
+
+### Résultat Attendu
+
+```
+🏗️ BYAN - Builder of YAN - Agent Creator Specialist
+
+Bonjour [VotreNom] ! Je suis BYAN, votre assistant pour créer des agents IA personnalisés...
+
+MENU PRINCIPAL:
+1. [MH] Redisplay Menu Help
+2. [CH] Chat with BYAN
+3. [INT] Start Intelligent Interview
+4. [QC] Quick Create agent
+5. [LA] List all agents
+6. [EA] Edit existing agent
+7. [VA] Validate agent
+8. [DA] Delete agent
+9. [PC] Show Project Context
+10. [MAN] Display 64 Mantras
+11. [PM] Start Party Mode
+12. [EXIT] Dismiss BYAN Agent
+
+Tapez /bmad-help à tout moment pour obtenir de l'aide.
+
+Que voulez-vous faire ?
+```
+
+### ✅ PASS SI:
+- [ ] Greeting BYAN s'affiche avec nom utilisateur (depuis config.yaml)
+- [ ] Menu complet avec 12 items visible
+- [ ] `/bmad-help` mentionné
+- [ ] Agent attend input
+
+### ❌ FAIL SI:
+- [ ] Erreur "agent not found"
+- [ ] Erreur de chargement du fichier source
+- [ ] Greeting incomplet ou manquant
+- [ ] Menu non affiché
+
+**Diagnostic si FAIL:**
+```bash
+# Vérifier agent source
+cat _byan/bmb/agents/byan.md | head -30
+
+# Vérifier stub
+cat .github/agents/bmad-agent-byan.md | head -20
+
+# Vérifier config
+cat _byan/bmb/config.yaml
+```
+
+**Tester une commande:**
+```
+LA
+```
+
+**Résultat attendu:** Liste des agents dans `_byan/bmb/agents/`
+
+---
+
+## 🧪 TEST 3: Activation RACHID (2 min)
+
+### Commande
+
+**Dans Copilot prompt:**
+```
+@rachid
+```
+
+### Résultat Attendu
+
+```
+📦 RACHID - NPM/NPX Deployment Specialist
+
+Salut [VotreNom] ! Je suis RACHID, expert en déploiement npm/npx...
+
+MENU PRINCIPAL:
+1. [INSTALL] Install BYAN via npx
+2. [VALIDATE] Validate _byan structure
+3. [FIX-DEPS] Fix npm dependencies
+4. [UPDATE-PKG] Update package.json
+5. [PUBLISH] Publish to npm
+6. [TEST-NPX] Test npx installation
+7. [AUDIT] Security audit
+8. [HELP] NPM Help
+9. [EXIT] Exit RACHID
+
+Que puis-je faire pour toi ?
+```
+
+### ✅ PASS SI:
+- [ ] Greeting RACHID s'affiche
+- [ ] Menu NPM/NPX visible (9 items)
+- [ ] Agent répond en français (si configuré)
+
+### ❌ FAIL SI:
+- [ ] Agent non trouvé
+- [ ] Menu incomplet
+- [ ] Erreur de chargement
+
+---
+
+## 🧪 TEST 4: Activation MARC (2 min)
+
+### Commande
+
+**Dans Copilot prompt:**
+```
+@marc
+```
+
+### Résultat Attendu
+
+```
+🤖 MARC - GitHub Copilot CLI Integration Specialist
+
+Hello [VotreNom]! I'm MARC, your GitHub Copilot CLI integration expert...
+
+MAIN MENU:
+1. [VALIDATE] Validate .github/agents/
+2. [TEST] Test /agent detection
+3. [CREATE-STUB] Create agent stub
+4. [FIX-YAML] Fix YAML frontmatter
+5. [MCP] Configure MCP server
+6. [TEST-INVOKE] Test agent invocation
+7. [OPTIMIZE] Optimize context
+8. [HELP] Copilot CLI Help
+9. [EXIT] Exit Marc
+
+What can I help you with?
+```
+
+### ✅ PASS SI:
+- [ ] Greeting MARC s'affiche
+- [ ] Menu Copilot CLI visible (9 items)
+- [ ] Agent répond correctement
+
+### ❌ FAIL SI:
+- [ ] Agent non détecté
+- [ ] Menu manquant
+- [ ] Erreur activation
+
+---
+
+## 🧪 TEST 5: Invocation Directe (1 min)
+
+### Test @byan avec Prompt
+
+**Commande:**
+```bash
+copilot --agent=bmad-agent-byan --prompt "List all agents in this project"
+```
+
+### Résultat Attendu
+
+Agent BYAN s'active et répond avec la liste des agents dans `_byan/bmb/agents/`.
+
+### ✅ PASS SI:
+- [ ] Agent BYAN activé directement
+- [ ] Prompt traité
+- [ ] Réponse pertinente
+
+### ❌ FAIL SI:
+- [ ] Erreur "agent not found"
+- [ ] Nom agent non reconnu
+
+**Note:** Si erreur, essayer avec le nom exact du fichier:
+```bash
+copilot --agent=bmad-agent-byan
+```
+
+---
+
+## 📊 RÉSULTATS TESTS
+
+### Score Global
+
+| Test | Status | Notes |
+|------|--------|-------|
+| 1. Détection Agents | ☐ PASS / ☐ FAIL | ___ agents détectés |
+| 2. Activation BYAN | ☐ PASS / ☐ FAIL | Menu complet: Oui/Non |
+| 3. Activation RACHID | ☐ PASS / ☐ FAIL | Menu complet: Oui/Non |
+| 4. Activation MARC | ☐ PASS / ☐ FAIL | Menu complet: Oui/Non |
+| 5. Invocation Directe | ☐ PASS / ☐ FAIL | Prompt traité: Oui/Non |
+
+### Verdict Final
+
+- [ ] ✅ **TOUS LES TESTS PASSÉS** → Prêt pour publication
+- [ ] ⚠️ **1-2 TESTS ÉCHOUÉS** → Corrections mineures nécessaires
+- [ ] ❌ **3+ TESTS ÉCHOUÉS** → Révision majeure requise
+
+---
+
+## 🐛 TROUBLESHOOTING
+
+### Problème: Aucun agent détecté
+
+**Causes possibles:**
+1. `.github/agents/` directory manquant
+2. YAML frontmatter invalide
+3. Permissions fichiers incorrectes
+4. Copilot CLI cache obsolète
+
+**Solutions:**
+```bash
+# Vérifier structure
+ls -la .github/agents/
+
+# Vérifier YAML
+cat .github/agents/bmad-agent-byan.md | head -5
+
+# Clear Copilot cache (si nécessaire)
+rm -rf ~/.copilot/cache/
+
+# Relancer Copilot
+copilot
+```
+
+---
+
+### Problème: Agent détecté mais ne charge pas
+
+**Causes possibles:**
+1. Fichier source `_byan/bmb/agents/*.md` manquant
+2. Erreur dans `<agent-activation>` block
+3. Chemin `{project-root}` mal résolu
+4. Config.yaml manquant
+
+**Solutions:**
+```bash
+# Vérifier agents sources
+ls -la _byan/bmb/agents/
+
+# Vérifier config
+cat _byan/bmb/config.yaml
+
+# Tester résolution path
+pwd
+# Doit correspondre au {project-root}
+```
+
+---
+
+### Problème: Menu incomplet ou manquant
+
+**Causes possibles:**
+1. Agent source corrompu
+2. Section `<menu>` mal formatée
+3. Erreur parsing XML
+
+**Solutions:**
+```bash
+# Réinstaller l'agent
+npx create-byan-agent
+# Répondre "Yes" pour overwrite
+
+# Ou restaurer depuis template
+cp templates/_byan/bmb/agents/byan.md _byan/bmb/agents/
+```
+
+---
+
+### Problème: Langue incorrecte
+
+**Cause:** `communication_language` dans config.yaml
+
+**Solution:**
+```bash
+# Éditer config
+nano _byan/bmb/config.yaml
+
+# Changer:
+communication_language: Francais  # ou English
+
+# Sauvegarder et relancer agent
+```
+
+---
+
+## 🎯 VALIDATION FINALE
+
+### Checklist de Clôture
+
+- [ ] Tous les tests passés (5/5)
+- [ ] Les 3 agents (BYAN, RACHID, MARC) fonctionnels
+- [ ] Menu complet sur chaque agent
+- [ ] Greeting personnalisé avec nom utilisateur
+- [ ] Commandes de menu répondent correctement
+
+### Si TOUS LES TESTS PASSENT:
+
+**✅ VALIDATION COMPLÈTE**
+
+L'intégration GitHub Copilot CLI est **FONCTIONNELLE** et **PRÊTE POUR PUBLICATION**.
+
+**Prochaines étapes:**
+1. Publier sur npm : `npm publish --access public`
+2. Tester installation publique
+3. Documenter et partager
+
+---
+
+### Si DES TESTS ÉCHOUENT:
+
+**⚠️ CORRECTIONS NÉCESSAIRES**
+
+Avant publication npm:
+1. Identifier causes des échecs (voir Troubleshooting)
+2. Corriger les problèmes
+3. Re-tester complètement
+4. Valider avec MARC
+
+**Ne pas publier tant que Score < 4/5**
+
+---
+
+## 📝 RAPPORT DE TEST
+
+**Testeur:** _______________  
+**Date:** _______________  
+**Environnement:**
+- OS: _______________
+- Node.js version: _______________
+- Copilot CLI version: _______________
+- Package version: 1.0.4
+
+**Tests Effectués:**
+- [ ] Test 1: Détection Agents
+- [ ] Test 2: Activation BYAN
+- [ ] Test 3: Activation RACHID
+- [ ] Test 4: Activation MARC
+- [ ] Test 5: Invocation Directe
+
+**Score:** ___/5
+
+**Verdict:** ☐ PASS / ☐ FAIL
+
+**Notes supplémentaires:**
+_________________________________
+_________________________________
+_________________________________
+
+**Signature Validation:** _______________
+
+---
+
+**Guide créé par:** MARC - GitHub Copilot CLI Integration Specialist  
+**Méthodologie:** Test-Driven Validation  
+**Contact:** Via agents BYAN/RACHID/MARC