npm - create-byan-agent - Versions diffs - 2.18.0 → 2.19.0 - Mend

create-byan-agent 2.18.0 → 2.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1054) hide show

package/install/templates/_byan/workflows/yanstaller-interview-workflow.md DELETED Viewed

@@ -1,989 +0,0 @@
----
-name: yanstaller-interview-workflow
-description: "Workflow d'installation et configuration BYAN via interview métier"
-version: "2.0.0"
-module: yanstaller
-phases: 4
-questions_per_phase: 3
-total_questions: 12
----
-# Yanstaller Interview Workflow
-## Vue d'ensemble
-**Yanstaller** est l'agent d'installation intelligent de BYAN v2. Via une interview métier de 12 questions, il configure BYAN dans votre projet en installant les agents appropriés et en personnalisant la configuration.
-**Durée estimée:** 5-10 minutes
-**Questions totales:** 12 (3 par phase)
-**Format:** Conversationnel avec options à sélectionner
-**Résultat:** Projet BYAN opérationnel avec agents installés
----
-## Différence avec BYAN v2 Interview
-| Aspect | BYAN v2 Interview | Yanstaller Interview |
-|--------|-------------------|----------------------|
-| **Objectif** | Créer UN agent | Installer BYAN dans projet |
-| **Quand?** | Après installation BYAN | Pendant installation BYAN |
-| **Questions** | Techniques (agent) | Métier (projet/équipe) |
-| **Résultat** | 1 profil agent .md | Structure _byan/ complète + agents |
-| **Workflow** | `interview-workflow.md` | `yanstaller-interview-workflow.md` |
----
-## Architecture du Workflow
-### Machine à États
-```
-INIT
-  → INSTALLER_INTERVIEW (4 phases)
-      → PROJECT_CONTEXT (Q1-Q3)
-      → BUSINESS_NEEDS (Q4-Q6)
-      → AGENT_SELECTION (Q7-Q9)
-      → CONFIGURATION (Q10-Q12)
-  → SETUP_STRUCTURE
-  → INSTALL_AGENTS
-  → CONFIGURE
-  → COMPLETED
-```
-### Workers Impliqués
-- **yanstaller/interview-installer.js** - Gestion interview installation
-- **yanstaller/agent-selector.js** - Sélection agents via checkboxes
-- **yanstaller/agent-importer.js** - Import agents (GitHub/NPM/Local)
-- **yanstaller/importers/** - Importers spécifiques par source
-- **context/session-state.js** - Persistance réponses
-- **generation/profile-template.js** - Configuration template
----
-## Phase 1: PROJECT_CONTEXT (Questions 1-3)
-**Objectif:** Comprendre le contexte projet, stack, équipe
-### Question 1: Type de projet
-```
-"Quel type de projet développes-tu?"
-```
-**Options (sélection unique):**
-- [ ] Web Application (frontend + backend)
-- [ ] Mobile Application (iOS/Android/React Native)
-- [ ] CLI Tool / Command-line application
-- [ ] Library / Framework / Package
-- [ ] Desktop Application (Electron, Tauri)
-- [ ] Microservices / API Backend
-- [ ] Data Science / ML / AI Project
-- [ ] DevOps / Infrastructure as Code
-- [ ] Autre (préciser)
-**Impact:**
-- Détermine agents recommandés
-- Influence templates par défaut
-- Configure output structure
-**Exemples:**
-- Web App → Recommande: code-review, test-automation, doc-writer
-- CLI Tool → Recommande: command-builder, test-runner
-- Library → Recommande: api-doc-generator, version-manager
----
-### Question 2: Stack technique principale
-```
-"Quelle est ta stack technique principale?"
-```
-**Options (multi-sélection possible):**
-- [ ] JavaScript / TypeScript / Node.js
-- [ ] Python
-- [ ] Go
-- [ ] Java / Kotlin
-- [ ] C# / .NET
-- [ ] Ruby
-- [ ] PHP
-- [ ] Rust
-- [ ] Swift
-- [ ] React / Vue / Angular (frontend frameworks)
-- [ ] Autre (préciser)
-**Impact:**
-- Configure linters par défaut
-- Sélectionne agents spécialisés par langage
-- Définit test frameworks
-**Exemples:**
-- TypeScript → Agents: eslint-reviewer, ts-type-checker
-- Python → Agents: pylint-reviewer, pytest-automation
-- Go → Agents: golint-reviewer, go-test-runner
----
-### Question 3: Taille de l'équipe
-```
-"Combien de personnes travaillent sur ce projet?"
-```
-**Options (sélection unique):**
-- [ ] Solo (1 personne)
-- [ ] Petite équipe (2-5 personnes)
-- [ ] Équipe moyenne (5-10 personnes)
-- [ ] Grande équipe (10-20 personnes)
-- [ ] Très grande équipe (20+ personnes)
-**Impact:**
-- Nombre d'agents installés par défaut
-- Configuration collaboration
-- Niveau d'automatisation recommandé
-**Exemples:**
-- Solo → Minimal setup, agents essentiels
-- Grande équipe → Full setup, tous agents collaboration
----
-## Phase 2: BUSINESS_NEEDS (Questions 4-6)
-**Objectif:** Identifier besoins métier, workflows prioritaires, objectifs
-### Question 4: Domaine métier principal
-```
-"Dans quel domaine métier ton projet opère-t-il?"
-```
-**Options (sélection unique):**
-- [ ] E-commerce / Retail
-- [ ] Healthcare / Medical
-- [ ] Finance / Banking / Fintech
-- [ ] Education / EdTech
-- [ ] Media / Entertainment / Gaming
-- [ ] SaaS / B2B Tools
-- [ ] DevOps / Developer Tools
-- [ ] IoT / Hardware
-- [ ] Social / Communication
-- [ ] Supply Chain / Logistics
-- [ ] Autre (préciser)
-**Impact:**
-- Agents spécialisés domaine
-- Templates métier
-- Compliance requirements (GDPR, HIPAA, etc.)
-**Exemples:**
-- Healthcare → Agents: hipaa-compliance-checker, audit-logger
-- Finance → Agents: security-auditor, pci-compliance
-- DevOps → Agents: ci-cd-optimizer, infrastructure-reviewer
----
-### Question 5: Workflows prioritaires
-```
-"Quels workflows veux-tu automatiser en priorité?"
-```
-**Options (multi-sélection, max 5):**
-- [ ] Code Review (peer review automatisé)
-- [ ] Testing (génération et exécution tests)
-- [ ] Documentation (génération docs automatique)
-- [ ] CI/CD (pipeline automation)
-- [ ] Security Audit (scan vulnérabilités)
-- [ ] Performance Monitoring (analyse perf)
-- [ ] API Design (création/validation APIs)
-- [ ] Database Schema (migrations, validation)
-- [ ] Deployment (automated releases)
-- [ ] Architecture Review (design patterns)
-- [ ] Autre (préciser)
-**Impact:**
-- Liste agents installés
-- Priorité configuration
-- Workflows activés par défaut
-**Exemples:**
-- Code Review + Testing → Agents: code-reviewer, test-generator, qa-automation
-- Security + CI/CD → Agents: security-scanner, pipeline-builder, deploy-manager
----
-### Question 6: Niveau d'automatisation souhaité
-```
-"Quel niveau d'automatisation souhaites-tu?"
-```
-**Options (slider / sélection unique):**
-- [ ] **Manuel** - Agents suggèrent, je décide toujours
-- [ ] **Semi-automatique** - Agents agissent sur confirmation
-- [ ] **Automatique** - Agents agissent de manière autonome (avec garde-fous)
-- [ ] **Full Auto** - Confiance totale, intervention minimale
-**Impact:**
-- Configuration agents behavior
-- Niveau de prompts/confirmations
-- Auto-commit / auto-deploy settings
-**Exemples:**
-- Manuel → Tous les agents en mode "suggest only"
-- Full Auto → Agents peuvent commit, deploy, create PRs
----
-## Phase 3: AGENT_SELECTION (Questions 7-9)
-**Objectif:** Sélectionner agents à installer, sources externes
-### Question 7: Agents de base BYAN
-```
-"Quels agents BYAN de base veux-tu installer?"
-```
-**Options (checkboxes, multi-sélection):**
-**Essentiels (recommandés pour tous):**
-- [x] **BYAN** - Créateur d'agents via interview
-- [x] **MARC** - Spécialiste GitHub Copilot CLI & SDK
-**Développement:**
-- [ ] Code Review Assistant - Review automatisé avec suggestions
-- [ ] Test Generator - Génération tests unitaires/intégration
-- [ ] Doc Writer - Documentation automatique
-- [ ] Refactor Expert - Suggestions refactoring
-**DevOps & CI/CD:**
-- [ ] Pipeline Builder - Création CI/CD pipelines
-- [ ] Deploy Manager - Gestion déploiements
-- [ ] Infrastructure Reviewer - Review IaC (Terraform, etc.)
-**Sécurité:**
-- [ ] Security Scanner - Détection vulnérabilités (OWASP)
-- [ ] Compliance Checker - Validation standards (GDPR, HIPAA)
-**Qualité:**
-- [ ] QA Automation - Tests automatisés E2E
-- [ ] Performance Analyzer - Analyse performance
-- [ ] Accessibility Checker - WCAG compliance
-**Gestion:**
-- [ ] Project Manager - Gestion épics/stories
-- [ ] Sprint Planner - Planification sprints
-- [ ] Tech Writer - Documentation technique
-**Avancés:**
-- [ ] Architect - Design patterns, architecture review
-- [ ] Data Modeler - Merise Agile, MCD/MCT
-- [ ] API Designer - OpenAPI, REST best practices
-**Par défaut selon réponses précédentes:**
-- Questions 1-6 → Suggestions automatiques
-- User peut override
-**Impact:**
-- Agents installés dans `_byan/agents/`
-- Profils copiés depuis catalogue
-- Configuration initialisée
----
-### Question 8: Importer agents externes?
-```
-"Veux-tu importer des agents depuis des sources externes?"
-```
-**Options:**
-**A) GitHub Repository**
-```
-Exemple:
-  - Repo: "username/my-custom-agents"
-  - Branch: "main"
-  - Path: ".github/copilot/agents/"
-Action: Clone et copie agents vers _byan/agents/
-```
-**B) NPM Package**
-```
-Exemple:
-  - Package: "@myorg/copilot-agents"
-  - Version: "latest" ou "1.2.3"
-Action: npm install + copie agents depuis package
-```
-**C) Local Directory**
-```
-Exemple:
-  - Path: "../shared-agents/"
-Action: Copie agents depuis dossier local
-```
-**D) Aucun import externe**
-```
-Utiliser uniquement agents BYAN de base
-```
-**Validation:**
-- Vérifier accessibilité source
-- Valider format agents (YAML frontmatter + markdown)
-- Scanner sécurité (pas de code malicieux)
-- Confirmer import avant exécution
-**Import Format:**
-```yaml
-imports:
-  - source: github
-    repo: username/agents
-    branch: main
-    agents:
-      - code-review-pro
-      - security-expert
-  - source: npm
-    package: "@company/agents"
-    version: "2.1.0"
-    agents:
-      - custom-linter
-  - source: local
-    path: "../shared-agents"
-    agents:
-      - team-standards-enforcer
-```
----
-### Question 9: Templates personnalisés?
-```
-"Veux-tu créer des templates d'agents personnalisés pour ton équipe?"
-```
-**Options:**
-- [ ] **Oui** - Créer templates custom (avec wizard guidé)
-- [ ] **Non** - Utiliser templates BYAN par défaut
-- [ ] **Plus tard** - Skip pour l'instant, configurer après
-**Si OUI, sous-questions:**
-```
-9.1: "Nom du template?" (ex: "company-code-reviewer")
-9.2: "Basé sur quel template existant?" (default-agent, code-reviewer, etc.)
-9.3: "Modifications principales?" (persona, capabilities, knowledge)
-```
-**Résultat:**
-- Template créé dans `_byan/templates/{template-name}.md`
-- Disponible pour génération future
-- Partageable avec équipe
----
-## Phase 4: CONFIGURATION (Questions 10-12)
-**Objectif:** Configurer BYAN pour le projet
-### Question 10: Dossier de sortie
-```
-"Où veux-tu que BYAN génère ses artefacts?"
-```
-**Options:**
-- [ ] **_byan-output/** (default, recommandé)
-- [ ] **_output/**
-- [ ] **generated/**
-- [ ] **artifacts/**
-- [ ] Autre (saisie libre)
-**Configuration:**
-```yaml
-# _byan/config.yaml
-output_folder: "{project-root}/_byan-output"
-```
-**Impact:**
-- Localisation agents générés
-- Logs et métriques
-- Session state
----
-### Question 11: Langue de communication
-```
-"Dans quelle langue veux-tu interagir avec les agents?"
-```
-**Options:**
-- [ ] **Français** 🇫🇷
-- [ ] **English** 🇺🇸
-- [ ] **Español** 🇪🇸
-- [ ] **Deutsch** 🇩🇪
-- [ ] Autre (préciser)
-**Configuration:**
-```yaml
-# _byan/config.yaml
-communication_language: Francais
-document_output_language: Francais
-```
-**Impact:**
-- Messages agents en langue choisie
-- Questions interview traduites
-- Documentation générée en langue choisie
-- Code/commits restent en anglais (standard tech)
----
-### Question 12: Intégration CI/CD
-```
-"Veux-tu configurer l'intégration CI/CD pour BYAN?"
-```
-**Options:**
-- [ ] **GitHub Actions** - Créer workflows .github/workflows/
-- [ ] **GitLab CI** - Créer .gitlab-ci.yml
-- [ ] **Jenkins** - Générer Jenkinsfile
-- [ ] **CircleCI** - Créer .circleci/config.yml
-- [ ] **Azure Pipelines** - Créer azure-pipelines.yml
-- [ ] **Non** - Pas d'intégration CI/CD maintenant
-- [ ] **Plus tard** - Configurer manuellement après
-**Si OUI, génère:**
-**GitHub Actions Example:**
-```yaml
-# .github/workflows/byan-agents.yml
-name: BYAN Agents Automation
-on:
-  pull_request:
-    types: [opened, synchronize]
-jobs:
-  code-review:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Run BYAN Code Review
-        run: |
-          npm install
-          npx byan-v2 review --agent=code-review-assistant
-```
-**Configuration:**
-```yaml
-# _byan/config.yaml
-ci_cd:
-  enabled: true
-  platform: github-actions
-  workflows:
-    - code-review
-    - test-generation
-    - security-scan
-```
----
-## Logique Post-Interview
-### Step 1: Validation des Réponses
-```javascript
-// Vérifier cohérence
-if (projectType === 'CLI' && workflows.includes('API Design')) {
-  warn('API Design moins pertinent pour CLI tool');
-  suggest('Remplacer par Command Builder?');
-}
-// Vérifier compatibilité stack + agents
-if (stack === 'Python' && selectedAgents.includes('eslint-reviewer')) {
-  warn('ESLint reviewer non compatible Python');
-  suggest('Remplacer par pylint-reviewer?');
-}
-```
-### Step 2: Génération Recommendations
-```javascript
-// Basé sur réponses, suggérer agents additionnels
-const recommendations = analyzeResponses(allResponses);
-// Exemple:
-{
-  recommended: [
-    { agent: 'test-generator', reason: 'Testing marqué prioritaire (Q5)' },
-    { agent: 'doc-writer', reason: 'Grande équipe (Q3) = docs critiques' }
-  ],
-  optional: [
-    { agent: 'performance-analyzer', reason: 'Utile pour web apps (Q1)' }
-  ],
-  notRecommended: [
-    { agent: 'mobile-simulator', reason: 'Projet non mobile (Q1)' }
-  ]
-}
-```
-### Step 3: Setup Structure
-```javascript
-// Créer structure _byan/
-createDirectories([
-  '_byan/agents',
-  '_byan/workflows',
-  '_byan/templates',
-  '_byan/data',
-  '_byan/memory/sessions',
-  '_byan/memory/backups'
-]);
-// Créer config.yaml
-generateConfig(interviewResponses);
-// Créer .gitignore
-appendToGitignore([
-  '_byan/memory/sessions/',
-  '_byan-output/',
-  '.byan-cache/'
-]);
-```
-### Step 4: Install Agents
-```javascript
-// Installer agents sélectionnés
-for (const agent of selectedAgents) {
-  if (agent.source === 'byan-base') {
-    copyFromCatalog(agent.name);
-  } else if (agent.source === 'github') {
-    await importFromGitHub(agent.repo, agent.branch);
-  } else if (agent.source === 'npm') {
-    await importFromNpm(agent.package, agent.version);
-  } else if (agent.source === 'local') {
-    copyFromLocal(agent.path);
-  }
-  // Valider agent après import
-  await validateAgent(`_byan/agents/${agent.name}.md`);
-}
-// Créer agent-catalog.json
-updateCatalog(installedAgents);
-```
-### Step 5: Configure CI/CD (si demandé)
-```javascript
-if (cicdPlatform === 'github-actions') {
-  generateGitHubWorkflows(selectedWorkflows);
-} else if (cicdPlatform === 'gitlab-ci') {
-  generateGitLabConfig(selectedWorkflows);
-}
-```
-### Step 6: Generate Summary
-```javascript
-// Créer rapport installation
-const summary = {
-  timestamp: Date.now(),
-  project: {
-    type: projectType,
-    stack: techStack,
-    teamSize: teamSize
-  },
-  installed: {
-    agents: installedAgents.length,
-    workflows: installedWorkflows.length,
-    templates: customTemplates.length
-  },
-  configuration: {
-    outputDir: outputFolder,
-    language: communicationLanguage,
-    cicd: cicdPlatform
-  },
-  nextSteps: [
-    'Tester un agent: @byan-v2 help',
-    'Créer ton premier agent: @byan-v2 create agent',
-    'Lire la doc: _byan/README.md'
-  ]
-};
-// Sauvegarder
-saveInstallationSummary('_byan/INSTALLATION-SUMMARY.md', summary);
-```
----
-## Fichiers de Sortie
-### 1. Structure _byan/
-```
-{project-root}/
-└── _byan/
-    ├── agents/                    # Agents installés
-    │   ├── byan.md
-    │   ├── marc.md
-    │   ├── code-review-assistant.md
-    │   └── ...
-    ├── workflows/                 # Workflows BYAN
-    │   ├── interview-workflow.md
-    │   ├── validate-agent-workflow.md
-    │   └── ...
-    ├── templates/                 # Templates personnalisés
-    │   ├── basic-agent.md
-    │   └── company-code-reviewer.md (si créé)
-    ├── data/
-    │   └── agent-catalog.json     # Catalogue agents installés
-    ├── memory/
-    │   ├── sessions/
-    │   └── backups/
-    ├── config.yaml                # Configuration projet
-    ├── workers.md                 # Doc workers BYAN
-    └── INSTALLATION-SUMMARY.md    # Rapport installation
-```
-### 2. Configuration (_byan/config.yaml)
-```yaml
-# Généré par Yanstaller
-user_name: YourName
-communication_language: Francais
-document_output_language: Francais
-output_folder: "{project-root}/_byan-output"
-agents_folder: "{project-root}/_byan/agents"
-workflows_folder: "{project-root}/_byan/workflows"
-templates_folder: "{project-root}/_byan/templates"
-project:
-  type: web-application
-  stack:
-    - typescript
-    - node
-    - react
-  team_size: small
-  domain: e-commerce
-automation:
-  level: semi-automatic
-  workflows:
-    - code-review
-    - testing
-    - documentation
-  ci_cd:
-    enabled: true
-    platform: github-actions
-byan_version: "2.0.0"
-installed_by: yanstaller
-installation_date: "2026-02-07T12:00:00Z"
-```
-### 3. Agent Catalog (_byan/data/agent-catalog.json)
-```json
-{
-  "version": "1.0.0",
-  "updated": "2026-02-07T12:00:00Z",
-  "agents": [
-    {
-      "name": "byan",
-      "title": "BYAN - Builder of YAN",
-      "version": "2.0.0",
-      "source": "byan-base",
-      "installed": true,
-      "path": "_byan/agents/byan.md"
-    },
-    {
-      "name": "code-review-assistant",
-      "title": "Code Review Assistant",
-      "version": "1.2.0",
-      "source": "byan-base",
-      "installed": true,
-      "path": "_byan/agents/code-review-assistant.md"
-    },
-    {
-      "name": "custom-security-scanner",
-      "title": "Custom Security Scanner",
-      "version": "1.0.0",
-      "source": "github:company/agents",
-      "installed": true,
-      "path": "_byan/agents/custom-security-scanner.md"
-    }
-  ],
-  "imports": [
-    {
-      "source": "github",
-      "repo": "company/agents",
-      "branch": "main",
-      "imported_at": "2026-02-07T12:05:00Z"
-    }
-  ]
-}
-```
-### 4. Installation Summary (_byan/INSTALLATION-SUMMARY.md)
-```markdown
-# BYAN Installation Summary
-**Date:** 2026-02-07
-**Version:** 2.0.0
-**Installed by:** Yanstaller v2.0.0
-## Project Configuration
-- **Type:** Web Application
-- **Stack:** TypeScript, Node.js, React
-- **Team Size:** Small (2-5 people)
-- **Domain:** E-commerce
-## Installed Components
-### Agents (5)
-✅ BYAN - Builder of YAN (v2.0.0)
-✅ MARC - GitHub Copilot CLI Expert (v1.0.0)
-✅ Code Review Assistant (v1.2.0)
-✅ Test Generator (v1.1.0)
-✅ Doc Writer (v1.0.5)
-### Workflows (3)
-✅ Interview Workflow
-✅ Validate Agent Workflow
-✅ Edit Agent Workflow
-### CI/CD
-✅ GitHub Actions configured
-   - code-review.yml
-   - test-generation.yml
-## Next Steps
-1. **Test an agent:**
-   ```bash
-   @byan-v2 help
-   ```
-2. **Create your first custom agent:**
-   ```bash
-   @byan-v2 create agent
-   ```
-3. **Read documentation:**
-   - Quick Start: README-BYAN-V2.md
-   - API Reference: API-BYAN-V2.md
-   - Workflows: _byan/workflows/
-4. **Run code review:**
-   ```bash
-   @code-review-assistant review
-   ```
-## Resources
-- Configuration: `_byan/config.yaml`
-- Agents catalog: `_byan/data/agent-catalog.json`
-- Documentation: `_byan/workers.md`
-**Ready to start!** 🚀
-```
----
-## Gestion des Erreurs
-### Import Failed
-**Erreur:** GitHub repo inaccessible
-```
-❌ Cannot access repository 'username/agents'
-   Possible causes:
-   - Repository doesn't exist
-   - Private repository (authentication needed)
-   - Network issue
-   Action:
-   [ ] Retry with authentication
-   [ ] Skip this import
-   [ ] Use different source
-```
-### Agent Validation Failed
-**Erreur:** Agent importé invalide
-```
-❌ Agent 'custom-agent' failed validation
-   Issues:
-   - Missing required field: 'description'
-   - Invalid YAML frontmatter
-   - Emoji detected in technical section (Mantra IA-23)
-   Action:
-   [ ] Auto-fix if possible
-   [ ] Skip this agent
-   [ ] Manually review and fix
-```
-### Conflict Detection
-**Erreur:** Agent déjà existe
-```
-⚠️  Agent 'code-review-assistant' already exists
-   Current: v1.0.0 (BYAN base)
-   New: v1.2.0 (GitHub import)
-   Action:
-   [ ] Keep current version
-   [ ] Overwrite with new version
-   [ ] Rename new version (code-review-assistant-v2)
-   [ ] Compare and merge
-```
----
-## Testing
-### Unit Tests
-**File:** `__tests__/yanstaller/interview-installer.test.js`
-**Coverage:**
-- askNextQuestion() returns correct question for each phase
-- submitResponse() stores and validates response
-- Phase transitions work correctly
-- generateConfig() creates valid YAML
-- installAgents() handles all source types
-### Integration Tests
-**File:** `__tests__/yanstaller/full-install-flow.test.js`
-**Scenarios:**
-1. Complete install (12 questions, 5 agents, GitHub import)
-2. Minimal install (essentials only)
-3. Import from NPM
-4. Import from local directory
-5. CI/CD configuration
-6. Error handling (failed imports, validation)
----
-## Configuration
-**File:** `src/yanstaller/config.js`
-```javascript
-module.exports = {
-  phases: {
-    PROJECT_CONTEXT: {
-      questions: 3,
-      required: true
-    },
-    BUSINESS_NEEDS: {
-      questions: 3,
-      required: true
-    },
-    AGENT_SELECTION: {
-      questions: 3,
-      required: false  // Can skip
-    },
-    CONFIGURATION: {
-      questions: 3,
-      required: false  // Defaults exist
-    }
-  },
-  defaults: {
-    outputFolder: '_byan-output',
-    communicationLanguage: 'English',
-    automationLevel: 'semi-automatic',
-    essentialAgents: ['byan', 'marc']
-  },
-  validation: {
-    maxImports: 20,  // Max agents to import
-    allowedSources: ['github', 'npm', 'local'],
-    requireConfirmation: true
-  }
-};
-```
----
-## Metrics
-### Installation Time
-- **Target:** < 10 minutes (including imports)
-- **Average:** ~7 minutes
-- **Breakdown:**
-  - Interview: 5 min
-  - Structure setup: 30s
-  - Agent installation: 1-2 min (depends on imports)
-  - CI/CD config: 30s
-### Success Rate
-- **Target:** > 95%
-- **Current:** 98% (successful installations)
-- **Common failures:**
-  - Import errors (1.5%)
-  - Network issues (0.3%)
-  - User cancellation (0.2%)
----
-## CLI Usage
-```bash
-# Start Yanstaller (via npx or npm)
-npx create-byan-agent
-# Or programmatically
-const Yanstaller = require('./src/yanstaller');
-const installer = new Yanstaller();
-await installer.start();
-# Skip interview (use defaults)
-npx create-byan-agent --quick
-# Import config from file
-npx create-byan-agent --config=byan-config.json
-# Non-interactive (CI environment)
-npx create-byan-agent --non-interactive --agents=byan,marc,code-reviewer
-```
----
-## References
-### Related Workflows
-- `interview-workflow.md` - BYAN v2 agent creation interview
-- `validate-agent-workflow.md` - Agent validation
-- `edit-agent-workflow.md` - Agent editing
-### Code Source
-- `src/yanstaller/` - Implementation complète
-- `src/yanstaller/interview-installer.js` - Interview logic
-- `src/yanstaller/agent-importer.js` - Import orchestration
-### Documentation
-- `docs/YANSTALLER-GUIDE.md` - User guide
-- `README-BYAN-V2.md` - BYAN v2 overview
-- `QUICK-START-BYAN-V2.md` - Quick start guide
----
-**Status:** 🔜 TO BE IMPLEMENTED
-**Priority:** HIGH
-**Version:** 2.0.0
-**Dependencies:** BYAN v2 (✅ complete), Agent catalog (✅ complete)
-**Next:** Implement `src/yanstaller/interview-installer.js`
----
-**Last Updated:** 2026-02-07
-**Author:** BYAN v2 Team