create-byan-agent 2.1.0 → 2.1.1

package/README.md

@@ -0,0 +1,361 @@
+# BYAN v2.1.0 - Build Your AI Network
+
+[![npm version](https://img.shields.io/npm/v/create-byan-agent.svg)](https://www.npmjs.com/package/create-byan-agent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-1308%2F1308-brightgreen.svg)](https://github.com/yannsix/byan-v2)
+
+**Intelligent AI Agent Creator** | Powered by Merise Agile + TDD + 64 Mantras
+
+Create custom AI agents through intelligent structured interviews with advanced BMAD (Business Modeling & Agent Development) features.
+
+---
+
+## 🚀 Quick Start
+
+### Install & Run
+
+```bash
+# Using npx (recommended - no installation needed)
+npx create-byan-agent
+
+# Or install globally
+npm install -g create-byan-agent
+
+# Then run
+create-byan-agent
+```
+
+### Programmatic Usage
+
+```javascript
+const ByanV2 = require('create-byan-agent');
+
+const byan = new ByanV2({
+  maxQuestions: 12,
+  outputDir: './_bmad-output'
+});
+
+await byan.startSession();
+
+// Interactive interview (12 questions)
+while (!byan.isComplete()) {
+  const question = byan.getNextQuestion();
+  const answer = await getUserInput(question.text);
+  await byan.submitResponse(answer);
+}
+
+// Generate agent profile
+const profile = await byan.generateProfile();
+console.log('Agent created:', profile.filePath);
+```
+
+---
+
+## ✨ What's New in v2.1.0
+
+### 4 New BMAD Modules
+
+**📚 Glossary Builder** - Auto-builds domain vocabularies
+- Auto-triggers for complex domains (ecommerce, finance, healthcare)
+- Validates definition clarity (min 70%)
+- Suggests related concepts
+
+**🔍 Five Whys Analyzer** - Root cause analysis
+- Detects pain points automatically
+- 5 sequential WHY questions
+- Categorizes causes (technical/process/people/resource)
+
+**👂 Active Listener** - Intelligent response processing
+- Auto-reformulation every 3rd response
+- Validates confirmations
+- Session summaries with insights
+
+**✅ Mantras Validator** - Quality validation
+- 64 BMAD/IA mantras
+- Compliance scoring (target: 80%+)
+- Category-based validation
+
+**417 new tests** | **100% passing** | **95%+ coverage** | **< 10% overhead**
+
+---
+
+## 🎯 Features
+
+### Core Capabilities
+
+- **Intelligent 4-Phase Interview**: Context → Business → Agent Needs → Validation
+- **Automatic Profile Generation**: Creates `.md` agent files with YAML frontmatter
+- **Built-in Validation**: Validates against GitHub Copilot CLI requirements
+- **Template System**: Flexible templates with placeholder resolution
+- **Quality Enforcement**: Zero emoji policy, clean code principles
+- **State Machine Workflow**: INTERVIEW → ANALYSIS → GENERATION → COMPLETED
+
+### Advanced BMAD Features (v2.1.0)
+
+- **Domain Glossaries**: Auto-build glossaries with clarity validation
+- **Root Cause Analysis**: 5 Whys technique for pain point analysis
+- **Active Listening**: Intelligent reformulation and validation
+- **Mantra Validation**: 64 mantras compliance checking
+
+### 100% Backwards Compatible
+
+All v2.0.0 code works unchanged in v2.1.0. BMAD features are opt-in.
+
+---
+
+## 📖 Usage Examples
+
+### Example 1: Basic Agent Creation
+
+```javascript
+const ByanV2 = require('create-byan-agent');
+
+async function createAgent() {
+  const byan = new ByanV2();
+  await byan.startSession();
+  
+  // Answer 12 interview questions
+  await byan.submitResponse('code-review-assistant');
+  await byan.submitResponse('Reviews code for bugs and best practices');
+  // ... 10 more responses
+  
+  const profile = await byan.generateProfile();
+  console.log('✅ Agent created');
+}
+```
+
+### Example 2: With BMAD Features
+
+```javascript
+const ByanV2 = require('create-byan-agent');
+
+async function createWithBMAD() {
+  const byan = new ByanV2({
+    bmad_features: {
+      glossary_builder: { enabled: true },
+      five_whys: { enabled: true },
+      active_listener: { enabled: true },
+      mantras_validator: { enabled: true }
+    }
+  });
+  
+  await byan.startSession();
+  
+  // Glossary auto-triggers for complex domains
+  const glossary = byan.startGlossary('ecommerce');
+  byan.addConcept('Order', 'Customer purchase request...');
+  
+  // Pain point detection
+  const detection = byan.detectPainPoints('Slow checkout');
+  if (detection.needsWhys) {
+    const question = byan.askWhy();
+    // ... 5 Whys analysis
+  }
+  
+  // Generate and validate
+  const profile = await byan.generateProfile();
+  const validation = byan.validateAgent(profile.content);
+  
+  console.log(`Score: ${validation.score * 100}%`);
+}
+```
+
+### Example 3: Validate Existing Agent
+
+```javascript
+const ByanV2 = require('create-byan-agent');
+const fs = require('fs');
+
+const byan = new ByanV2({
+  bmad_features: {
+    mantras_validator: { enabled: true }
+  }
+});
+
+const agentContent = fs.readFileSync('my-agent.md', 'utf-8');
+const validation = byan.validateAgent(agentContent);
+
+console.log(`Compliance: ${validation.score * 100}%`);
+console.log(`Compliant: ${validation.compliant.length}/64`);
+console.log(`Non-compliant: ${validation.nonCompliant.length}/64`);
+```
+
+---
+
+## 🔧 Configuration
+
+### Basic Configuration
+
+```javascript
+const byan = new ByanV2({
+  maxQuestions: 12,
+  outputDir: './_bmad-output/bmb-creations',
+  sessionId: 'my-session'
+});
+```
+
+### BMAD Configuration
+
+```javascript
+const byan = new ByanV2({
+  bmad_features: {
+    glossary_builder: {
+      enabled: true,
+      auto_trigger_domains: ['ecommerce', 'finance', 'healthcare'],
+      min_concepts: 5,
+      clarity_threshold: 0.7
+    },
+    five_whys: {
+      enabled: true,
+      max_depth: 5,
+      auto_trigger: true
+    },
+    active_listener: {
+      enabled: true,
+      reformulation_frequency: 3
+    },
+    mantras_validator: {
+      enabled: true,
+      min_compliance_score: 0.8
+    }
+  }
+});
+```
+
+---
+
+## 📊 Quality Metrics
+
+- **Tests**: 1,308/1,308 passing (100%)
+  - Core v2.0: 891 tests
+  - BMAD v2.1: 417 tests
+- **Coverage**: 95%+
+- **Performance**: < 10% overhead vs v2.0.0
+- **Principles**: KISS, DRY, SOLID, TDD
+- **Standards**: Zero emojis (Mantra IA-23)
+
+---
+
+## 📚 API Reference
+
+### Main Class: ByanV2
+
+#### Core Methods
+
+- `constructor(config)` - Initialize BYAN
+- `startSession()` - Start interview session
+- `getNextQuestion()` - Get next interview question
+- `submitResponse(answer)` - Submit answer
+- `generateProfile()` - Generate agent profile
+- `isComplete()` - Check if interview complete
+
+#### Glossary Builder (BMAD)
+
+- `startGlossary(domain, options)` - Initialize glossary
+- `addConcept(term, definition)` - Add concept
+- `getConcepts()` - Get all concepts
+- `getGlossary()` - Get full glossary
+
+#### Five Whys Analyzer (BMAD)
+
+- `detectPainPoints(response)` - Detect pain points
+- `askWhy()` - Get WHY question
+- `processWhyAnswer(answer)` - Process answer
+- `getRootCause()` - Get root cause analysis
+
+#### Active Listener (BMAD)
+
+- `listen(input, context)` - Process input with listening
+- `reformulate(input, style)` - Reformulate input
+- `validateResponse(input)` - Validate confirmation
+- `summarizeSession()` - Generate session summary
+
+#### Mantras Validator (BMAD)
+
+- `validateAgent(definition)` - Validate against mantras
+- `generateComplianceReport()` - Generate report
+- `validateMantra(mantraId, content)` - Validate specific mantra
+- `getMantras(category)` - Get mantras by category
+
+---
+
+## 🔄 Migration from v2.0.0
+
+**Good news**: Zero breaking changes! Your v2.0.0 code works unchanged.
+
+```javascript
+// v2.0.0 code - still works in v2.1.0
+const ByanV2 = require('create-byan-agent');
+const byan = new ByanV2();
+await byan.startSession();
+// ... your existing workflow
+```
+
+To use new BMAD features, simply enable them in config. See [MIGRATION.md](https://github.com/yannsix/byan-v2/blob/main/MIGRATION-v2.0-to-v2.1.md) for details.
+
+---
+
+## 📖 Documentation
+
+- [Full Documentation](https://github.com/yannsix/byan-v2/blob/main/README-BYAN-V2.md)
+- [CHANGELOG v2.1.0](https://github.com/yannsix/byan-v2/blob/main/CHANGELOG-v2.1.0.md)
+- [Migration Guide](https://github.com/yannsix/byan-v2/blob/main/MIGRATION-v2.0-to-v2.1.md)
+- [Manual Testing Guide](https://github.com/yannsix/byan-v2/blob/main/BYAN-V2.1.0-MANUAL-TEST-PLAN.md)
+- [BMAD Quick Reference](https://github.com/yannsix/byan-v2/blob/main/BMAD-QUICK-REFERENCE.md)
+
+---
+
+## 🤝 Contributing
+
+Contributions welcome! Please read our contributing guidelines and submit pull requests to our [GitHub repository](https://github.com/yannsix/byan-v2).
+
+---
+
+## 📄 License
+
+MIT © Yan
+
+---
+
+## 🆘 Support
+
+- **Issues**: [GitHub Issues](https://github.com/yannsix/byan-v2/issues)
+- **Repository**: [github.com/yannsix/byan-v2](https://github.com/yannsix/byan-v2)
+
+---
+
+## 🎯 Use Cases
+
+### For Solo Developers
+Create specialized agents for your workflow without complex setup.
+
+### For Teams
+Build consistent agent profiles following team standards and mantras.
+
+### For Agencies
+Rapid agent prototyping with built-in quality validation.
+
+### For Open Source
+Generate well-documented agent profiles for public repositories.
+
+---
+
+## 🌟 Highlights
+
+- ✅ **Zero Setup**: Works immediately with npx
+- ✅ **Intelligent**: Smart interview adapts to your answers
+- ✅ **Quality**: Built-in validation against 64 mantras
+- ✅ **Fast**: Create agents in 10-15 minutes
+- ✅ **Flexible**: Use as CLI or programmatically
+- ✅ **Tested**: 1,308 tests, 100% passing
+- ✅ **Compatible**: Works with v2.0.0 code unchanged
+
+---
+
+**Ready to create your first AI agent?**
+
+```bash
+npx create-byan-agent
+```
+
+🚀 Let's build something amazing!

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-byan-agent",
-  "version": "2.1.0",
-  "description": "BYAN v2.0 - Build Your AI Network - Hyper-MVP",
+  "version": "2.1.1",
+  "description": "BYAN v2.1.0 - Intelligent AI agent creator with BMAD features (Glossary, Five Whys, Active Listener, Mantras Validator)",
   "main": "src/index.js",
   "bin": {
     "create-byan-agent": "./install/bin/create-byan-agent-v2.js",
@@ -38,12 +38,14 @@
   },
   "files": [
     "src/",
-    "__tests__/",
-    "_bmad/",
-    ".github/agents/",
     "install/",
     "README.md",
-    "package.json"
+    "CHANGELOG-v2.1.0.md",
+    "MIGRATION-v2.0-to-v2.1.md",
+    "README-BYAN-V2.md",
+    "API-BYAN-V2.md",
+    "BMAD-QUICK-REFERENCE.md",
+    "LICENSE"
   ],
   "dependencies": {
     "chalk": "^4.1.2",

package/.github/agents/bmad-agent-bmad-master.md

@@ -1,40 +0,0 @@
----
-name: 'bmad-master'
-description: 'BMAD Master - Orchestration and platform management expert. Coordinates all BMAD agents and workflows.'
----
-
-## Commands
-- `/agent bmad-master` - Activate BMAD Master agent
-- Access full platform orchestration and management
-
-## What I Do
-- Orchestrate multi-agent workflows across BMAD platform
-- Manage platform configuration and module coordination
-- Provide strategic guidance on agent usage
-- Monitor system health and performance
-- Coordinate complex multi-step processes
-
-## What I DON'T Do (Boundaries)
-- Never modify user data without explicit confirmation
-- Never execute workflows without validation
-- Never bypass security or compliance checks
-- Never make architectural changes without approval
-- Never override module-specific agent decisions
-
-## Quick Start
-1. Activate with `/agent bmad-master`
-2. Request platform status or agent coordination
-3. Initiate complex multi-agent workflows
-
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/core/agents/bmad-master.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmb-agent-builder.md

@@ -1,15 +0,0 @@
----
-name: 'bmb-agent-builder'
-description: 'agent-builder agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmb/agents/agent-builder.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmb-module-builder.md

@@ -1,15 +0,0 @@
----
-name: 'bmb-module-builder'
-description: 'module-builder agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmb/agents/module-builder.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmb-workflow-builder.md

@@ -1,15 +0,0 @@
----
-name: 'bmb-workflow-builder'
-description: 'workflow-builder agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmb/agents/workflow-builder.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmm-analyst.md

@@ -1,15 +0,0 @@
----
-name: 'bmm-analyst'
-description: 'analyst agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/analyst.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmm-architect.md

@@ -1,15 +0,0 @@
----
-name: 'bmm-architect'
-description: 'architect agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/architect.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmm-dev.md

@@ -1,15 +0,0 @@
----
-name: 'bmm-dev'
-description: 'dev agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/dev.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmm-pm.md

@@ -1,15 +0,0 @@
----
-name: 'bmm-pm'
-description: 'pm agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/pm.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmm-quick-flow-solo-dev.md

@@ -1,15 +0,0 @@
----
-name: 'bmm-quick-flow-solo-dev'
-description: 'quick-flow-solo-dev agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/quick-flow-solo-dev.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmm-quinn.md

@@ -1,15 +0,0 @@
----
-name: 'bmm-quinn'
-description: 'quinn agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/quinn.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmm-sm.md

@@ -1,15 +0,0 @@
----
-name: 'bmm-sm'
-description: 'sm agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/sm.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmm-tech-writer.md

@@ -1,15 +0,0 @@
----
-name: 'bmm-tech-writer'
-description: 'tech-writer agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/tech-writer/tech-writer.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-bmm-ux-designer.md

@@ -1,15 +0,0 @@
----
-name: 'bmm-ux-designer'
-description: 'ux-designer agent'
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/ux-designer.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>

package/.github/agents/bmad-agent-byan-test.md

@@ -1,32 +0,0 @@
----
-name: "byan-test"
-description: "BYAN Test - Token Optimized Version (-46%)"
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-<agent-activation CRITICAL="TRUE">
-1. LOAD the FULL agent file from {project-root}/_bmad/bmb/agents/byan-test.md
-2. READ its entire contents - this contains the complete agent persona, menu, and instructions
-3. FOLLOW every step in the <activation> section precisely
-4. DISPLAY the welcome/greeting as instructed
-5. PRESENT the numbered menu
-6. WAIT for user input before proceeding
-</agent-activation>
-
-```xml
-<agent id="byan-test.agent.yaml" name="BYAN-TEST" title="Builder of YAN - Test Version (Optimized)" icon="🏗️">
-<activation critical="MANDATORY">
-  <step n="1">Load persona from {project-root}/_bmad/bmb/agents/byan-test.md</step>
-  <step n="2">Load config from {project-root}/_bmad/bmb/config.yaml - store {user_name}, {communication_language}, {output_folder}</step>
-  <step n="3">Show greeting using {user_name} in {communication_language}, display menu</step>
-  <step n="4">Inform about `/bmad-help` command</step>
-  <step n="5">WAIT for input - accept number, cmd, or fuzzy match</step>
-  <rules>
-    <r>This is a TEST version of BYAN optimized for token reduction (-46%)</r>
-    <r>Full agent: _bmad/bmb/agents/byan-test.md (116 lines vs 215 original)</r>
-    <r>Original BYAN still available via bmad-agent-byan</r>
-  </rules>
-</activation>
-</agent>
-```