agentic-qe 1.6.0 → 1.7.0

package/dist/cli/commands/init.js

@@ -43,6 +43,7 @@ const inquirer_1 = __importDefault(require("inquirer"));
 const ora_1 = __importDefault(require("ora"));
 const fs = __importStar(require("fs-extra"));
 const path = __importStar(require("path"));
+const init_claude_md_template_1 = require("./init-claude-md-template");
 // Import version from package.json to maintain consistency
 const packageJson = require('../../../package.json');
 const PACKAGE_VERSION = packageJson.version;
@@ -782,13 +783,13 @@ For full capabilities, install the complete agentic-qe package.
         return files.filter(f => f.endsWith('.md')).length;
     }
     /**
-     * Copy all 35 QE Fleet skills (filters out Claude Flow skills)
+     * Copy all 37 QE Fleet skills (filters out Claude Flow skills)
      */
     static async copySkillTemplates() {
         console.log(chalk_1.default.cyan('  🎯 Initializing QE Fleet skills...'));
-        // Define all 34 QE Fleet skills (Phase 1: 17 original + Phase 2: 17 new = 34 total)
+        // Define all 37 QE Fleet skills (Phase 1: 18 + Phase 2: 16 + Phase 3: 3 = 37 total)
         const QE_FLEET_SKILLS = [
-            // Phase 1: Original Quality Practices (17 skills)
+            // Phase 1: Original Quality Practices (18 skills)
             // Core Quality Practices (3)
             'agentic-quality-engineering',
             'context-driven-testing',
@@ -811,7 +812,7 @@ For full capabilities, install the complete agentic-qe package.
             'bug-reporting-excellence',
             'technical-writing',
             'consultancy-practices',
-            // Phase 2: Expanded QE Skills Library (17 skills)
+            // Phase 2: Expanded QE Skills Library (16 skills)
             // Testing Methodologies (6)
             'regression-testing',
             'shift-left-testing',
@@ -829,9 +830,14 @@ For full capabilities, install the complete agentic-qe package.
             'localization-testing',
             'compliance-testing',
             'visual-testing-advanced',
-            // Testing Infrastructure (2)
+            // Testing Infrastructure (1)
             'test-environment-management',
-            'test-reporting-analytics'
+            'test-reporting-analytics',
+            // Phase 3: Advanced Quality Engineering Skills (3 skills)
+            // Strategic Testing Methodologies (3)
+            'six-thinking-hats',
+            'brutal-honesty-review',
+            'cicd-pipeline-qe-orchestrator'
         ];
         // Find the agentic-qe package location
         const possiblePaths = [
@@ -856,15 +862,19 @@ For full capabilities, install the complete agentic-qe package.
         console.log(chalk_1.default.green(`  ✓ Found skill templates at: ${sourcePath}`));
         // List all available skills
         const availableDirs = await fs.readdir(sourcePath);
-        const availableSkills = availableDirs.filter(name => {
+        const availableSkills = [];
+        for (const name of availableDirs) {
             const skillPath = path.join(sourcePath, name);
             try {
-                return fs.statSync(skillPath).isDirectory();
+                const stats = await fs.stat(skillPath);
+                if (stats.isDirectory()) {
+                    availableSkills.push(name);
+                }
             }
             catch {
-                return false;
+                // Skip items that can't be stat'd
             }
-        });
+        }
         console.log(chalk_1.default.cyan(`  📦 Found ${availableSkills.length} total skills in source`));
         // Filter to only QE Fleet skills
         const qeSkillsToConfig = availableSkills.filter(skill => QE_FLEET_SKILLS.includes(skill));
@@ -894,15 +904,22 @@ For full capabilities, install the complete agentic-qe package.
             console.log(chalk_1.default.green('  ✓ All QE skills already present'));
         }
         console.log(chalk_1.default.cyan(`  📋 Total QE skills initialized: ${finalSkillCount}`));
-        // Verify we have exactly 34 QE skills
-        if (finalSkillCount === 34) {
-            console.log(chalk_1.default.green('  ✅ All 34 QE Fleet skills successfully initialized'));
+        // Verify we have exactly 37 QE skills
+        if (finalSkillCount === 37) {
+            console.log(chalk_1.default.green('  ✅ All 37 QE Fleet skills successfully initialized'));
         }
-        else if (finalSkillCount < 34) {
-            console.warn(chalk_1.default.yellow(`  ⚠️  Expected 34 QE skills, found ${finalSkillCount}`));
-            const missingSkills = QE_FLEET_SKILLS.filter(skill => {
-                return !fs.existsSync(path.join(targetPath, skill));
-            });
+        else if (finalSkillCount < 37) {
+            console.warn(chalk_1.default.yellow(`  ⚠️  Expected 37 QE skills, found ${finalSkillCount}`));
+            // Check missing skills asynchronously
+            const missingSkills = [];
+            for (const skill of QE_FLEET_SKILLS) {
+                try {
+                    await fs.access(path.join(targetPath, skill));
+                }
+                catch {
+                    missingSkills.push(skill);
+                }
+            }
             console.warn(chalk_1.default.yellow(`  ℹ️  Missing skills: ${missingSkills.join(', ')}`));
         }
     }
@@ -917,7 +934,8 @@ For full capabilities, install the complete agentic-qe package.
         for (const item of items) {
             const itemPath = path.join(dirPath, item);
             try {
-                if (fs.statSync(itemPath).isDirectory()) {
+                const stats = await fs.stat(itemPath);
+                if (stats.isDirectory()) {
                     count++;
                 }
             }
@@ -1313,457 +1331,469 @@ echo "[AQE] Post-execution coordination complete"
                 appendPosition = position;
             }
         }
+        // Generate condensed CLAUDE.md using template
+        const claudeMdContent = (0, init_claude_md_template_1.generateCondensedClaudeMd)({
+            agentCount,
+            topology: config.topology,
+            maxAgents: config.maxAgents,
+            testingFocus: config.testingFocus,
+            environments: config.environments,
+            frameworks: config.frameworks,
+            routing: config.routing,
+            streaming: config.streaming,
+        }, PACKAGE_VERSION);
+        /* OLD TEMPLATE - Replaced with condensed version
         const claudeMdContent = `# Claude Code Configuration - Agentic QE Fleet
-
-## 🤖 Agentic Quality Engineering Fleet
-
-This project uses the **Agentic QE Fleet** - a distributed swarm of ${agentCount} AI agents for comprehensive software testing and quality assurance.
-
-### Available Agents
-
-#### Core Testing (5 agents)
-- **qe-test-generator**: AI-powered test generation with sublinear optimization
-- **qe-test-executor**: Multi-framework test execution with parallel processing
-- **qe-coverage-analyzer**: Real-time gap detection with O(log n) algorithms
-- **qe-quality-gate**: Intelligent quality gate with risk assessment
-- **qe-quality-analyzer**: Comprehensive quality metrics analysis
-
-#### Performance & Security (2 agents)
-- **qe-performance-tester**: Load testing with k6, JMeter, Gatling integration
-- **qe-security-scanner**: Multi-layer security with SAST/DAST scanning
-
-#### Strategic Planning (3 agents)
-- **qe-requirements-validator**: INVEST criteria validation and BDD generation
-- **qe-production-intelligence**: Production data to test scenarios conversion
-- **qe-fleet-commander**: Hierarchical fleet coordination (50+ agents)
-
-#### Deployment (1 agent)
-- **qe-deployment-readiness**: Multi-factor risk assessment for deployments
-
-#### Advanced Testing (4 agents)
-- **qe-regression-risk-analyzer**: Smart test selection with ML patterns
-- **qe-test-data-architect**: High-speed realistic data generation (10k+ records/sec)
-- **qe-api-contract-validator**: Breaking change detection across API versions
-- **qe-flaky-test-hunter**: Statistical flakiness detection and auto-stabilization
-
-#### Specialized (2 agents)
-- **qe-visual-tester**: Visual regression with AI-powered comparison
-- **qe-chaos-engineer**: Resilience testing with controlled fault injection
-
-## 🚀 Quick Start
-
-### Using Agents via Claude Code Task Tool (Recommended)
-
-\\\`\\\`\\\`javascript
-// Spawn agents directly in Claude Code
-Task("Generate tests", "Create comprehensive test suite for UserService", "qe-test-generator")
-Task("Analyze coverage", "Find gaps using O(log n) algorithms", "qe-coverage-analyzer")
-Task("Quality check", "Run quality gate validation", "qe-quality-gate")
-\\\`\\\`\\\`
-
-### Using MCP Tools
-
-\\\`\\\`\\\`bash
-# Check MCP connection
-claude mcp list
-# Should show: agentic-qe: npm run mcp:start - ✓ Connected
-
-# Use MCP tools in Claude Code
-mcp__agentic_qe__test_generate({ type: "unit", framework: "${config.frameworks?.[0] || 'jest'}" })
-mcp__agentic_qe__test_execute({ parallel: true, coverage: true })
-mcp__agentic_qe__quality_analyze({ scope: "full" })
-\\\`\\\`\\\`
-
-### Using CLI
-
-\\\`\\\`\\\`bash
-# Quick commands
-aqe test <module-name>        # Generate tests
-aqe coverage                   # Analyze coverage
-aqe quality                    # Run quality gate
-aqe status                     # Check fleet status
-\\\`\\\`\\\`
-
-## 🔄 Agent Coordination
-
-All agents coordinate through **AQE hooks** (Agentic QE native hooks - zero external dependencies, 100-500x faster):
-
-### Automatic Lifecycle Hooks
-
-Agents extend \\\`BaseAgent\\\` and override lifecycle methods:
-
-\\\`\\\`\\\`typescript
-protected async onPreTask(data: { assignment: TaskAssignment }): Promise<void> {
-  // Load context before task execution
-  const context = await this.memoryStore.retrieve('aqe/context', {
-    partition: 'coordination'
-  });
-
-  this.logger.info('Pre-task hook complete');
-}
-
-protected async onPostTask(data: { assignment: TaskAssignment; result: any }): Promise<void> {
-  // Store results after task completion
-  await this.memoryStore.store('aqe/' + this.agentId.type + '/results', data.result, {
-    partition: 'agent_results',
-    ttl: 86400 // 24 hours
-  });
-
-  // Emit completion event
-  this.eventBus.emit('task:completed', {
-    agentId: this.agentId,
-    result: data.result
-  });
-
-  this.logger.info('Post-task hook complete');
-}
-
-protected async onTaskError(data: { assignment: TaskAssignment; error: Error }): Promise<void> {
-  // Handle task errors
-  await this.memoryStore.store('aqe/errors/' + data.assignment.id, {
-    error: data.error.message,
-    stack: data.error.stack,
-    timestamp: Date.now()
-  }, {
-    partition: 'errors',
-    ttl: 604800 // 7 days
-  });
-
-  this.logger.error('Task failed', { error: data.error });
-}
-\\\`\\\`\\\`
-
-### Performance Comparison
-
-| Feature | AQE Hooks | External Hooks |
-|---------|-----------|----------------|
-| **Speed** | <1ms | 100-500ms |
-| **Dependencies** | Zero | External package |
-| **Type Safety** | Full TypeScript | Shell strings |
-| **Integration** | Direct API | Shell commands |
-| **Performance** | 100-500x faster | Baseline |
-
-## 📋 Memory Namespace
-
-Agents share state through the **\\\`aqe/*\\\` memory namespace**:
-
-- \\\`aqe/test-plan/*\\\` - Test planning and requirements
-- \\\`aqe/coverage/*\\\` - Coverage analysis and gaps
-- \\\`aqe/quality/*\\\` - Quality metrics and gates
-- \\\`aqe/performance/*\\\` - Performance test results
-- \\\`aqe/security/*\\\` - Security scan findings
-- \\\`aqe/swarm/coordination\\\` - Cross-agent coordination
-
-## 🎯 Fleet Configuration
-
-**Topology**: ${config.topology}
-**Max Agents**: ${config.maxAgents}
-**Testing Focus**: ${config.testingFocus?.join(', ') || 'All areas'}
-**Environments**: ${config.environments?.join(', ') || 'Not specified'}
-**Frameworks**: ${config.frameworks?.join(', ') || 'jest'}
-
-## 💰 Multi-Model Router (v${PACKAGE_VERSION})
-
-**Status**: ${config.routing?.enabled ? '✅ Enabled' : '⚠️  Disabled (opt-in)'}
-
-The Multi-Model Router provides **70-81% cost savings** by intelligently selecting AI models based on task complexity.
-
-### Features
-
-- ✅ Intelligent model selection (GPT-3.5, GPT-4, Claude Sonnet 4.5, Claude Haiku)
-- ✅ Real-time cost tracking and aggregation
-- ✅ Automatic fallback chains for resilience
-- ✅ Feature flags for safe rollout
-- ✅ Zero breaking changes (disabled by default)
-
-### Enabling Routing
-
-**Option 1: Via Configuration**
-\\\`\\\`\\\`json
-// .agentic-qe/config/routing.json
-{
-  "multiModelRouter": {
-    "enabled": true
-  }
-}
-\\\`\\\`\\\`
-
-**Option 2: Via Environment Variable**
-\\\`\\\`\\\`bash
-export AQE_ROUTING_ENABLED=true
-\\\`\\\`\\\`
-
-### Model Selection Rules
-
-| Task Complexity | Model | Est. Cost | Use Case |
-|----------------|-------|-----------|----------|
-| **Simple** | GPT-3.5 | $0.0004 | Unit tests, basic validation |
-| **Moderate** | GPT-3.5 | $0.0008 | Integration tests, mocks |
-| **Complex** | GPT-4 | $0.0048 | Property-based, edge cases |
-| **Critical** | Claude Sonnet 4.5 | $0.0065 | Security, architecture review |
-
-### Cost Savings Example
-
-**Before Routing** (always GPT-4):
-- 100 simple tasks: $0.48
-- 50 complex tasks: $0.24
-- **Total**: $0.72
-
-**After Routing**:
-- 100 simple → GPT-3.5: $0.04
-- 50 complex → GPT-4: $0.24
-- **Total**: $0.28
-- **Savings**: $0.44 (61%)
-
-### Monitoring Costs
-
-\\\`\\\`\\\`bash
-# View cost dashboard
-aqe routing dashboard
-
-# Export cost report
-aqe routing report --format json
-
-# Check savings
-aqe routing stats
-\\\`\\\`\\\`
-
-## 📊 Streaming Progress (v${PACKAGE_VERSION})
-
-**Status**: ${config.streaming?.enabled ? '✅ Enabled' : '⚠️  Disabled'}
-
-Real-time progress updates for long-running operations using AsyncGenerator pattern.
-
-### Features
-
-- ✅ Real-time progress percentage
-- ✅ Current operation visibility
-- ✅ for-await-of compatibility
-- ✅ Backward compatible (non-streaming still works)
-
-### Example Usage
-
-\\\`\\\`\\\`javascript
-// Using streaming MCP tool
-const handler = new TestExecuteStreamHandler();
-
-for await (const event of handler.execute(params)) {
-  if (event.type === 'progress') {
-    console.log(\\\`Progress: \\\${event.percent}% - \\\${event.message}\\\`);
-  } else if (event.type === 'result') {
-    console.log('Completed:', event.data);
-  }
-}
-\\\`\\\`\\\`
-
-### Supported Operations
-
-- ✅ Test execution (test-by-test progress)
-- ✅ Coverage analysis (incremental gap detection)
-- ⚠️  Test generation (coming in v1.1.0)
-- ⚠️  Security scanning (coming in v1.1.0)
-
-## 🎯 Claude Code Skills Integration
-
-This fleet includes **34 specialized QE skills** that agents can use:
-
-### Phase 1: Original Quality Engineering Skills (17 skills)
-
-#### Core Testing (3 skills)
-- **agentic-quality-engineering**: Using AI agents as force multipliers in quality work - autonomous testing systems, PACT principles, scaling quality engineering with intelligent agents
-- **context-driven-testing**: Apply context-driven testing principles where practices are chosen based on project context, not universal "best practices"
-- **holistic-testing-pact**: Apply the Holistic Testing Model evolved with PACT (Proactive, Autonomous, Collaborative, Targeted) principles
-
-#### Testing Methodologies (4 skills)
-- **tdd-london-chicago**: Apply both London and Chicago school TDD approaches - understanding different TDD philosophies and choosing the right testing style
-- **xp-practices**: Apply XP practices including pair programming, ensemble programming, continuous integration, and sustainable pace
-- **risk-based-testing**: Focus testing effort on highest-risk areas using risk assessment and prioritization
-- **test-automation-strategy**: Design and implement comprehensive test automation strategies
-
-#### Testing Techniques (4 skills)
-- **api-testing-patterns**: Comprehensive API testing patterns including contract testing, REST/GraphQL testing, and integration testing
-- **exploratory-testing-advanced**: Advanced exploratory testing techniques with Session-Based Test Management (SBTM), RST heuristics, and test tours
-- **performance-testing**: Test application performance, scalability, and resilience with load testing and stress testing
-- **security-testing**: Test for security vulnerabilities using OWASP principles and security testing techniques
-
-#### Code Quality (3 skills)
-- **code-review-quality**: Conduct context-driven code reviews focusing on quality, testability, and maintainability
-- **refactoring-patterns**: Apply safe refactoring patterns to improve code structure without changing behavior
-- **quality-metrics**: Measure quality effectively with actionable metrics and KPIs
-
-#### Communication (3 skills)
-- **bug-reporting-excellence**: Write high-quality bug reports that get fixed quickly - includes templates, examples, and best practices
-- **technical-writing**: Create clear, concise technical documentation
-- **consultancy-practices**: Apply effective software quality consultancy practices
-
-### Phase 2: Expanded QE Skills Library (17 skills)
-
-#### Testing Methodologies (6 skills)
-- **regression-testing**: Strategic regression testing with test selection, impact analysis, and continuous regression management
-- **shift-left-testing**: Move testing activities earlier in development lifecycle with TDD, BDD, and design for testability
-- **shift-right-testing**: Testing in production with feature flags, canary deployments, synthetic monitoring, and chaos engineering
-- **test-design-techniques**: Advanced test design using equivalence partitioning, boundary value analysis, and decision tables
-- **mutation-testing**: Test quality validation through mutation testing and measuring test suite effectiveness
-- **test-data-management**: Realistic test data generation, GDPR compliance, and data masking strategies
-
-#### Specialized Testing (9 skills)
-- **accessibility-testing**: WCAG 2.2 compliance testing, screen reader validation, and inclusive design verification
-- **mobile-testing**: Comprehensive mobile testing for iOS and Android including gestures, sensors, and device fragmentation
-- **database-testing**: Database schema validation, data integrity testing, migration testing, and query performance
-- **contract-testing**: Consumer-driven contract testing for microservices using Pact and API versioning
-- **chaos-engineering-resilience**: Chaos engineering principles, controlled failure injection, and resilience testing
-- **compatibility-testing**: Cross-browser, cross-platform, and cross-device compatibility testing
-- **localization-testing**: Internationalization (i18n) and localization (l10n) testing for global products
-- **compliance-testing**: Regulatory compliance testing for GDPR, CCPA, HIPAA, SOC2, and PCI-DSS
-- **visual-testing-advanced**: Advanced visual regression testing with AI-powered screenshot comparison and UI validation
-
-#### Testing Infrastructure (2 skills)
-- **test-environment-management**: Manage test environments, infrastructure as code, and environment provisioning
-- **test-reporting-analytics**: Comprehensive test reporting with metrics, trends, and actionable insights
-
-### Using Skills
-
-#### Via CLI
-\\\`\\\`\\\`bash
-# List all available skills
-aqe skills list
-
-# Search for specific skills
-aqe skills search "testing"
-
-# Show skill details
-aqe skills show agentic-quality-engineering
-
-# Show skill statistics
-aqe skills stats
-\\\`\\\`\\\`
-
-#### Via Skill Tool in Claude Code
-\\\`\\\`\\\`javascript
-// Execute a skill
-Skill("agentic-quality-engineering")
-Skill("tdd-london-chicago")
-Skill("api-testing-patterns")
-\\\`\\\`\\\`
-
-#### Integration with Agents
-All QE agents automatically have access to relevant skills based on their specialization:
-- **Test generators** use: agentic-quality-engineering, api-testing-patterns, tdd-london-chicago
-- **Coverage analyzers** use: agentic-quality-engineering, quality-metrics, risk-based-testing
-- **Flaky test hunters** use: agentic-quality-engineering, exploratory-testing-advanced
-- **Performance testers** use: agentic-quality-engineering, performance-testing, quality-metrics
-- **Security scanners** use: agentic-quality-engineering, security-testing, risk-based-testing
-
-## 🧠 Q-Learning Integration (Phase 2)
-
-All agents automatically learn from task execution through Q-learning:
-
-### Observability
-\\\`\\\`\\\`bash
-# Check learning status
-aqe learn status --agent test-gen
-
-# View learned patterns
-aqe learn history --agent test-gen --limit 50
-
-# Export learning data
-aqe learn export --agent test-gen --output learning.json
-\\\`\\\`\\\`
-
-### Pattern Management
-\\\`\\\`\\\`bash
-# List test patterns
-aqe patterns list --framework jest
-
-# Search patterns
-aqe patterns search "api validation"
-
-# Extract patterns from tests
-aqe patterns extract ./tests --framework jest
-\\\`\\\`\\\`
-
-### Improvement Loop
-\\\`\\\`\\\`bash
-# Start continuous improvement
-aqe improve start
-
-# Check improvement status
-aqe improve status
-
-# Run single improvement cycle
-aqe improve cycle
-\\\`\\\`\\\`
-
-## 📚 Documentation
-
-- **Agent Definitions**: \\\`.claude/agents/\\\` - ${agentCount} specialized QE agents (18 main + 8 TDD subagents)
-- **Subagent Definitions**: \\\`.claude/agents/subagents/\\\` - 8 specialized TDD subagents for test generation workflow
-- **Skills**: \\\`.claude/skills/\\\` - 34 specialized QE skills for agents (Phase 1: 17 + Phase 2: 17)
-- **Fleet Config**: \\\`.agentic-qe/config/fleet.json\\\`
-- **Routing Config**: \\\`.agentic-qe/config/routing.json\\\` (Multi-Model Router settings)
-- **AQE Hooks Config**: \\\`.agentic-qe/config/aqe-hooks.json\\\` (zero dependencies, 100-500x faster)
-
-## 🔧 Advanced Usage
-
-### Parallel Agent Execution
-
-\\\`\\\`\\\`javascript
-// Execute multiple agents concurrently
-Task("Test Generation", "Generate unit tests", "qe-test-generator")
-Task("Coverage Analysis", "Analyze current coverage", "qe-coverage-analyzer")
-Task("Security Scan", "Run security checks", "qe-security-scanner")
-Task("Performance Test", "Load test critical paths", "qe-performance-tester")
-\\\`\\\`\\\`
-
-### Agent Coordination Example
-
-\\\`\\\`\\\`javascript
-// Test generator stores results
-Task("Generate tests", "Create tests and store in memory at aqe/test-plan/generated", "qe-test-generator")
-
-// Test executor reads from memory
-Task("Execute tests", "Read test plan from aqe/test-plan/generated and execute", "qe-test-executor")
-
-// Coverage analyzer processes results
-Task("Analyze coverage", "Check coverage from aqe/coverage/results", "qe-coverage-analyzer")
-\\\`\\\`\\\`
-
-## 💡 Best Practices
-
-1. **Use Task Tool**: Claude Code's Task tool is the primary way to spawn agents
-2. **Batch Operations**: Always spawn multiple related agents in a single message
-3. **Memory Keys**: Use the \\\`aqe/*\\\` namespace for agent coordination
-4. **AQE Hooks**: Agents automatically use native AQE hooks for coordination (100-500x faster)
-5. **Parallel Execution**: Leverage concurrent agent execution for speed
-
-## 🆘 Troubleshooting
-
-### Check MCP Connection
-\\\`\\\`\\\`bash
-claude mcp list
-\\\`\\\`\\\`
-
-### View Agent Definitions
-\\\`\\\`\\\`bash
-ls -la .claude/agents/
-\\\`\\\`\\\`
-
-### Check Fleet Status
-\\\`\\\`\\\`bash
-aqe status --verbose
-\\\`\\\`\\\`
-
-### View Logs
-\\\`\\\`\\\`bash
-tail -f .agentic-qe/logs/fleet.log
-\\\`\\\`\\\`
-
----
-
-**Generated by**: Agentic QE Fleet v${PACKAGE_VERSION}
-**Initialization Date**: ${new Date().toISOString()}
-**Fleet Topology**: ${config.topology}
-`;
+    
+    ## 🤖 Agentic Quality Engineering Fleet
+    
+    This project uses the **Agentic QE Fleet** - a distributed swarm of ${agentCount} AI agents for comprehensive software testing and quality assurance.
+    
+    ### Available Agents
+    
+    #### Core Testing (5 agents)
+    - **qe-test-generator**: AI-powered test generation with sublinear optimization
+    - **qe-test-executor**: Multi-framework test execution with parallel processing
+    - **qe-coverage-analyzer**: Real-time gap detection with O(log n) algorithms
+    - **qe-quality-gate**: Intelligent quality gate with risk assessment
+    - **qe-quality-analyzer**: Comprehensive quality metrics analysis
+    
+    #### Performance & Security (2 agents)
+    - **qe-performance-tester**: Load testing with k6, JMeter, Gatling integration
+    - **qe-security-scanner**: Multi-layer security with SAST/DAST scanning
+    
+    #### Strategic Planning (3 agents)
+    - **qe-requirements-validator**: INVEST criteria validation and BDD generation
+    - **qe-production-intelligence**: Production data to test scenarios conversion
+    - **qe-fleet-commander**: Hierarchical fleet coordination (50+ agents)
+    
+    #### Deployment (1 agent)
+    - **qe-deployment-readiness**: Multi-factor risk assessment for deployments
+    
+    #### Advanced Testing (4 agents)
+    - **qe-regression-risk-analyzer**: Smart test selection with ML patterns
+    - **qe-test-data-architect**: High-speed realistic data generation (10k+ records/sec)
+    - **qe-api-contract-validator**: Breaking change detection across API versions
+    - **qe-flaky-test-hunter**: Statistical flakiness detection and auto-stabilization
+    
+    #### Specialized (2 agents)
+    - **qe-visual-tester**: Visual regression with AI-powered comparison
+    - **qe-chaos-engineer**: Resilience testing with controlled fault injection
+    
+    ## 🚀 Quick Start
+    
+    ### Using Agents via Claude Code Task Tool (Recommended)
+    
+    \\\`\\\`\\\`javascript
+    // Spawn agents directly in Claude Code
+    Task("Generate tests", "Create comprehensive test suite for UserService", "qe-test-generator")
+    Task("Analyze coverage", "Find gaps using O(log n) algorithms", "qe-coverage-analyzer")
+    Task("Quality check", "Run quality gate validation", "qe-quality-gate")
+    \\\`\\\`\\\`
+    
+    ### Using MCP Tools
+    
+    \\\`\\\`\\\`bash
+    # Check MCP connection
+    claude mcp list
+    # Should show: agentic-qe: npm run mcp:start - ✓ Connected
+    
+    # Use MCP tools in Claude Code
+    mcp__agentic_qe__test_generate({ type: "unit", framework: "${config.frameworks?.[0] || 'jest'}" })
+    mcp__agentic_qe__test_execute({ parallel: true, coverage: true })
+    mcp__agentic_qe__quality_analyze({ scope: "full" })
+    \\\`\\\`\\\`
+    
+    ### Using CLI
+    
+    \\\`\\\`\\\`bash
+    # Quick commands
+    aqe test <module-name>        # Generate tests
+    aqe coverage                   # Analyze coverage
+    aqe quality                    # Run quality gate
+    aqe status                     # Check fleet status
+    \\\`\\\`\\\`
+    
+    ## 🔄 Agent Coordination
+    
+    All agents coordinate through **AQE hooks** (Agentic QE native hooks - zero external dependencies, 100-500x faster):
+    
+    ### Automatic Lifecycle Hooks
+    
+    Agents extend \\\`BaseAgent\\\` and override lifecycle methods:
+    
+    \\\`\\\`\\\`typescript
+    protected async onPreTask(data: { assignment: TaskAssignment }): Promise<void> {
+      // Load context before task execution
+      const context = await this.memoryStore.retrieve('aqe/context', {
+        partition: 'coordination'
+      });
+    
+      this.logger.info('Pre-task hook complete');
+    }
+    
+    protected async onPostTask(data: { assignment: TaskAssignment; result: any }): Promise<void> {
+      // Store results after task completion
+      await this.memoryStore.store('aqe/' + this.agentId.type + '/results', data.result, {
+        partition: 'agent_results',
+        ttl: 86400 // 24 hours
+      });
+    
+      // Emit completion event
+      this.eventBus.emit('task:completed', {
+        agentId: this.agentId,
+        result: data.result
+      });
+    
+      this.logger.info('Post-task hook complete');
+    }
+    
+    protected async onTaskError(data: { assignment: TaskAssignment; error: Error }): Promise<void> {
+      // Handle task errors
+      await this.memoryStore.store('aqe/errors/' + data.assignment.id, {
+        error: data.error.message,
+        stack: data.error.stack,
+        timestamp: Date.now()
+      }, {
+        partition: 'errors',
+        ttl: 604800 // 7 days
+      });
+    
+      this.logger.error('Task failed', { error: data.error });
+    }
+    \\\`\\\`\\\`
+    
+    ### Performance Comparison
+    
+    | Feature | AQE Hooks | External Hooks |
+    |---------|-----------|----------------|
+    | **Speed** | <1ms | 100-500ms |
+    | **Dependencies** | Zero | External package |
+    | **Type Safety** | Full TypeScript | Shell strings |
+    | **Integration** | Direct API | Shell commands |
+    | **Performance** | 100-500x faster | Baseline |
+    
+    ## 📋 Memory Namespace
+    
+    Agents share state through the **\\\`aqe/*\\\` memory namespace**:
+    
+    - \\\`aqe/test-plan/*\\\` - Test planning and requirements
+    - \\\`aqe/coverage/*\\\` - Coverage analysis and gaps
+    - \\\`aqe/quality/*\\\` - Quality metrics and gates
+    - \\\`aqe/performance/*\\\` - Performance test results
+    - \\\`aqe/security/*\\\` - Security scan findings
+    - \\\`aqe/swarm/coordination\\\` - Cross-agent coordination
+    
+    ## 🎯 Fleet Configuration
+    
+    **Topology**: ${config.topology}
+    **Max Agents**: ${config.maxAgents}
+    **Testing Focus**: ${config.testingFocus?.join(', ') || 'All areas'}
+    **Environments**: ${config.environments?.join(', ') || 'Not specified'}
+    **Frameworks**: ${config.frameworks?.join(', ') || 'jest'}
+    
+    ## 💰 Multi-Model Router (v${PACKAGE_VERSION})
+    
+    **Status**: ${config.routing?.enabled ? '✅ Enabled' : '⚠️  Disabled (opt-in)'}
+    
+    The Multi-Model Router provides **70-81% cost savings** by intelligently selecting AI models based on task complexity.
+    
+    ### Features
+    
+    - ✅ Intelligent model selection (GPT-3.5, GPT-4, Claude Sonnet 4.5, Claude Haiku)
+    - ✅ Real-time cost tracking and aggregation
+    - ✅ Automatic fallback chains for resilience
+    - ✅ Feature flags for safe rollout
+    - ✅ Zero breaking changes (disabled by default)
+    
+    ### Enabling Routing
+    
+    **Option 1: Via Configuration**
+    \\\`\\\`\\\`json
+    // .agentic-qe/config/routing.json
+    {
+      "multiModelRouter": {
+        "enabled": true
+      }
+    }
+    \\\`\\\`\\\`
+    
+    **Option 2: Via Environment Variable**
+    \\\`\\\`\\\`bash
+    export AQE_ROUTING_ENABLED=true
+    \\\`\\\`\\\`
+    
+    ### Model Selection Rules
+    
+    | Task Complexity | Model | Est. Cost | Use Case |
+    |----------------|-------|-----------|----------|
+    | **Simple** | GPT-3.5 | $0.0004 | Unit tests, basic validation |
+    | **Moderate** | GPT-3.5 | $0.0008 | Integration tests, mocks |
+    | **Complex** | GPT-4 | $0.0048 | Property-based, edge cases |
+    | **Critical** | Claude Sonnet 4.5 | $0.0065 | Security, architecture review |
+    
+    ### Cost Savings Example
+    
+    **Before Routing** (always GPT-4):
+    - 100 simple tasks: $0.48
+    - 50 complex tasks: $0.24
+    - **Total**: $0.72
+    
+    **After Routing**:
+    - 100 simple → GPT-3.5: $0.04
+    - 50 complex → GPT-4: $0.24
+    - **Total**: $0.28
+    - **Savings**: $0.44 (61%)
+    
+    ### Monitoring Costs
+    
+    \\\`\\\`\\\`bash
+    # View cost dashboard
+    aqe routing dashboard
+    
+    # Export cost report
+    aqe routing report --format json
+    
+    # Check savings
+    aqe routing stats
+    \\\`\\\`\\\`
+    
+    ## 📊 Streaming Progress (v${PACKAGE_VERSION})
+    
+    **Status**: ${config.streaming?.enabled ? '✅ Enabled' : '⚠️  Disabled'}
+    
+    Real-time progress updates for long-running operations using AsyncGenerator pattern.
+    
+    ### Features
+    
+    - ✅ Real-time progress percentage
+    - ✅ Current operation visibility
+    - ✅ for-await-of compatibility
+    - ✅ Backward compatible (non-streaming still works)
+    
+    ### Example Usage
+    
+    \\\`\\\`\\\`javascript
+    // Using streaming MCP tool
+    const handler = new TestExecuteStreamHandler();
+    
+    for await (const event of handler.execute(params)) {
+      if (event.type === 'progress') {
+        console.log(\\\`Progress: \\\${event.percent}% - \\\${event.message}\\\`);
+      } else if (event.type === 'result') {
+        console.log('Completed:', event.data);
+      }
+    }
+    \\\`\\\`\\\`
+    
+    ### Supported Operations
+    
+    - ✅ Test execution (test-by-test progress)
+    - ✅ Coverage analysis (incremental gap detection)
+    - ⚠️  Test generation (coming in v1.1.0)
+    - ⚠️  Security scanning (coming in v1.1.0)
+    
+    ## 🎯 Claude Code Skills Integration
+    
+    This fleet includes **37 specialized QE skills** that agents can use:
+    
+    ### Phase 1: Original Quality Engineering Skills (18 skills)
+    
+    #### Core Testing (3 skills)
+    - **agentic-quality-engineering**: Using AI agents as force multipliers in quality work - autonomous testing systems, PACT principles, scaling quality engineering with intelligent agents
+    - **context-driven-testing**: Apply context-driven testing principles where practices are chosen based on project context, not universal "best practices"
+    - **holistic-testing-pact**: Apply the Holistic Testing Model evolved with PACT (Proactive, Autonomous, Collaborative, Targeted) principles
+    
+    #### Testing Methodologies (4 skills)
+    - **tdd-london-chicago**: Apply both London and Chicago school TDD approaches - understanding different TDD philosophies and choosing the right testing style
+    - **xp-practices**: Apply XP practices including pair programming, ensemble programming, continuous integration, and sustainable pace
+    - **risk-based-testing**: Focus testing effort on highest-risk areas using risk assessment and prioritization
+    - **test-automation-strategy**: Design and implement comprehensive test automation strategies
+    
+    #### Testing Techniques (4 skills)
+    - **api-testing-patterns**: Comprehensive API testing patterns including contract testing, REST/GraphQL testing, and integration testing
+    - **exploratory-testing-advanced**: Advanced exploratory testing techniques with Session-Based Test Management (SBTM), RST heuristics, and test tours
+    - **performance-testing**: Test application performance, scalability, and resilience with load testing and stress testing
+    - **security-testing**: Test for security vulnerabilities using OWASP principles and security testing techniques
+    
+    #### Code Quality (3 skills)
+    - **code-review-quality**: Conduct context-driven code reviews focusing on quality, testability, and maintainability
+    - **refactoring-patterns**: Apply safe refactoring patterns to improve code structure without changing behavior
+    - **quality-metrics**: Measure quality effectively with actionable metrics and KPIs
+    
+    #### Communication (3 skills)
+    - **bug-reporting-excellence**: Write high-quality bug reports that get fixed quickly - includes templates, examples, and best practices
+    - **technical-writing**: Create clear, concise technical documentation
+    - **consultancy-practices**: Apply effective software quality consultancy practices
+    
+    ### Phase 2: Expanded QE Skills Library (17 skills)
+    
+    #### Testing Methodologies (6 skills)
+    - **regression-testing**: Strategic regression testing with test selection, impact analysis, and continuous regression management
+    - **shift-left-testing**: Move testing activities earlier in development lifecycle with TDD, BDD, and design for testability
+    - **shift-right-testing**: Testing in production with feature flags, canary deployments, synthetic monitoring, and chaos engineering
+    - **test-design-techniques**: Advanced test design using equivalence partitioning, boundary value analysis, and decision tables
+    - **mutation-testing**: Test quality validation through mutation testing and measuring test suite effectiveness
+    - **test-data-management**: Realistic test data generation, GDPR compliance, and data masking strategies
+    
+    #### Specialized Testing (9 skills)
+    - **accessibility-testing**: WCAG 2.2 compliance testing, screen reader validation, and inclusive design verification
+    - **mobile-testing**: Comprehensive mobile testing for iOS and Android including gestures, sensors, and device fragmentation
+    - **database-testing**: Database schema validation, data integrity testing, migration testing, and query performance
+    - **contract-testing**: Consumer-driven contract testing for microservices using Pact and API versioning
+    - **chaos-engineering-resilience**: Chaos engineering principles, controlled failure injection, and resilience testing
+    - **compatibility-testing**: Cross-browser, cross-platform, and cross-device compatibility testing
+    - **localization-testing**: Internationalization (i18n) and localization (l10n) testing for global products
+    - **compliance-testing**: Regulatory compliance testing for GDPR, CCPA, HIPAA, SOC2, and PCI-DSS
+    - **visual-testing-advanced**: Advanced visual regression testing with AI-powered screenshot comparison and UI validation
+    
+    #### Testing Infrastructure (2 skills)
+    - **test-environment-management**: Manage test environments, infrastructure as code, and environment provisioning
+    - **test-reporting-analytics**: Comprehensive test reporting with metrics, trends, and actionable insights
+    
+    ### Using Skills
+    
+    #### Via CLI
+    \\\`\\\`\\\`bash
+    # List all available skills
+    aqe skills list
+    
+    # Search for specific skills
+    aqe skills search "testing"
+    
+    # Show skill details
+    aqe skills show agentic-quality-engineering
+    
+    # Show skill statistics
+    aqe skills stats
+    \\\`\\\`\\\`
+    
+    #### Via Skill Tool in Claude Code
+    \\\`\\\`\\\`javascript
+    // Execute a skill
+    Skill("agentic-quality-engineering")
+    Skill("tdd-london-chicago")
+    Skill("api-testing-patterns")
+    \\\`\\\`\\\`
+    
+    #### Integration with Agents
+    All QE agents automatically have access to relevant skills based on their specialization:
+    - **Test generators** use: agentic-quality-engineering, api-testing-patterns, tdd-london-chicago
+    - **Coverage analyzers** use: agentic-quality-engineering, quality-metrics, risk-based-testing
+    - **Flaky test hunters** use: agentic-quality-engineering, exploratory-testing-advanced
+    - **Performance testers** use: agentic-quality-engineering, performance-testing, quality-metrics
+    - **Security scanners** use: agentic-quality-engineering, security-testing, risk-based-testing
+    
+    ## 🧠 Q-Learning Integration (Phase 2)
+    
+    All agents automatically learn from task execution through Q-learning:
+    
+    ### Observability
+    \\\`\\\`\\\`bash
+    # Check learning status
+    aqe learn status --agent test-gen
+    
+    # View learned patterns
+    aqe learn history --agent test-gen --limit 50
+    
+    # Export learning data
+    aqe learn export --agent test-gen --output learning.json
+    \\\`\\\`\\\`
+    
+    ### Pattern Management
+    \\\`\\\`\\\`bash
+    # List test patterns
+    aqe patterns list --framework jest
+    
+    # Search patterns
+    aqe patterns search "api validation"
+    
+    # Extract patterns from tests
+    aqe patterns extract ./tests --framework jest
+    \\\`\\\`\\\`
+    
+    ### Improvement Loop
+    \\\`\\\`\\\`bash
+    # Start continuous improvement
+    aqe improve start
+    
+    # Check improvement status
+    aqe improve status
+    
+    # Run single improvement cycle
+    aqe improve cycle
+    \\\`\\\`\\\`
+    
+    ## 📚 Documentation
+    
+    - **Agent Definitions**: \\\`.claude/agents/\\\` - ${agentCount} specialized QE agents (18 main + 8 TDD subagents)
+    - **Subagent Definitions**: \\\`.claude/agents/subagents/\\\` - 8 specialized TDD subagents for test generation workflow
+    - **Skills**: \\\`.claude/skills/\\\` - 37 specialized QE skills for agents (Phase 1: 18 + Phase 2: 16 + Phase 3: 3)
+    - **Fleet Config**: \\\`.agentic-qe/config/fleet.json\\\`
+    - **Routing Config**: \\\`.agentic-qe/config/routing.json\\\` (Multi-Model Router settings)
+    - **AQE Hooks Config**: \\\`.agentic-qe/config/aqe-hooks.json\\\` (zero dependencies, 100-500x faster)
+    
+    ## 🔧 Advanced Usage
+    
+    ### Parallel Agent Execution
+    
+    \\\`\\\`\\\`javascript
+    // Execute multiple agents concurrently
+    Task("Test Generation", "Generate unit tests", "qe-test-generator")
+    Task("Coverage Analysis", "Analyze current coverage", "qe-coverage-analyzer")
+    Task("Security Scan", "Run security checks", "qe-security-scanner")
+    Task("Performance Test", "Load test critical paths", "qe-performance-tester")
+    \\\`\\\`\\\`
+    
+    ### Agent Coordination Example
+    
+    \\\`\\\`\\\`javascript
+    // Test generator stores results
+    Task("Generate tests", "Create tests and store in memory at aqe/test-plan/generated", "qe-test-generator")
+    
+    // Test executor reads from memory
+    Task("Execute tests", "Read test plan from aqe/test-plan/generated and execute", "qe-test-executor")
+    
+    // Coverage analyzer processes results
+    Task("Analyze coverage", "Check coverage from aqe/coverage/results", "qe-coverage-analyzer")
+    \\\`\\\`\\\`
+    
+    ## 💡 Best Practices
+    
+    1. **Use Task Tool**: Claude Code's Task tool is the primary way to spawn agents
+    2. **Batch Operations**: Always spawn multiple related agents in a single message
+    3. **Memory Keys**: Use the \\\`aqe/*\\\` namespace for agent coordination
+    4. **AQE Hooks**: Agents automatically use native AQE hooks for coordination (100-500x faster)
+    5. **Parallel Execution**: Leverage concurrent agent execution for speed
+    
+    ## 🆘 Troubleshooting
+    
+    ### Check MCP Connection
+    \\\`\\\`\\\`bash
+    claude mcp list
+    \\\`\\\`\\\`
+    
+    ### View Agent Definitions
+    \\\`\\\`\\\`bash
+    ls -la .claude/agents/
+    \\\`\\\`\\\`
+    
+    ### Check Fleet Status
+    \\\`\\\`\\\`bash
+    aqe status --verbose
+    \\\`\\\`\\\`
+    
+    ### View Logs
+    \\\`\\\`\\\`bash
+    tail -f .agentic-qe/logs/fleet.log
+    \\\`\\\`\\\`
+    
+    ---
+    
+    **Generated by**: Agentic QE Fleet v${PACKAGE_VERSION}
+    **Initialization Date**: ${new Date().toISOString()}
+    **Fleet Topology**: ${config.topology}
+    `; */ // End of old template comment
         // Write CLAUDE.md based on append strategy (v1.3.7 fix)
         let finalContent;
         if (exists && existingContent) {