flow-nexus-swarm

Install & Initialize

```bash

# Install globally

npm install -g agentic-qe

# Initialize your project

cd your-project

aqe init --wizard

# Or with auto-configuration

aqe init --auto

# Add MCP server to Claude Code (pick one)

# Option 1: Global install (recommended after npm install -g)

claude mcp add aqe -- aqe-mcp

# Option 2: Via npx (no global install needed)

claude mcp add aqe -- npx agentic-qe mcp

# Verify connection

claude mcp list

```

Use from Claude Code CLI

Ask Claude to use QE agents directly from your terminal:

```bash

# Generate comprehensive tests with learning

claude "Use qe-test-architect to create tests for src/services/user-service.ts with 95% coverage"

# Run full quality pipeline with Queen coordination

claude "Use qe-queen-coordinator to orchestrate: test generation, coverage analysis, security scan, and quality gate"

# Detect flaky tests with root cause analysis

claude "Use qe-flaky-hunter to analyze the last 100 test runs and stabilize flaky tests"

```

What V3 provides:

• ✅ 12 DDD Bounded Contexts: Organized by business domain (test-generation, coverage-analysis, security-compliance, etc.)
• ✅ 51 QE Agents: Including Queen Coordinator for hierarchical orchestration (44 main + 7 TDD subagents)
• ✅ TinyDancer Model Routing: 3-tier intelligent routing (Haiku/Sonnet/Opus) for cost optimization
• ✅ ReasoningBank Learning: HNSW-indexed pattern storage with experience replay
• ✅ O(log n) Coverage Analysis: Sublinear algorithms for efficient gap detection
• ✅ Claude Flow Integration: Deep integration with MCP tools and swarm orchestration
• ✅ Memory Coordination: Cross-agent communication via aqe/v3/* namespaces
• ✅ Coherence Verification (v3.3.0): Mathematical proof of belief consistency using WASM engines
• ✅ V2 Backward Compatibility: All V2 agents map to V3 equivalents
• ✅ 67 QE Skills: 46 Tier 3 verified + 21 additional QE skills (QCSD swarms, n8n testing, qe-* domains)

---

```bash

# 1. Install

npm install -g agentic-qe

# 2. Initialize (auto-detects your project, enables all 12 domains)

cd your-project && aqe init --auto

# 3. Generate tests immediately

claude "Generate comprehensive tests for src/services/"

# 4. Run quality assessment

claude "Assess code quality and provide deployment recommendation"

```

What happens:

1. Auto-configuration detects your tech stack (TypeScript/JS, testing framework, CI setup)
2. All 12 DDD domains enabled automatically - no "No factory registered" errors
3. Pattern learning kicks in - your project's test patterns are learned and reused
4. AI agents generate tests, analyze coverage, and provide actionable recommendations

---

| Problem | AQE Solution |

|---------|--------------|

| Writing comprehensive tests is tedious and time-consuming | AI agents generate tests automatically with pattern reuse across projects |

| Test suites become slow and expensive at scale | Sublinear O(log n) algorithms for coverage analysis and intelligent test selection |

| Flaky tests waste developer time debugging false failures | ML-powered detection with root cause analysis and fix recommendations |

| AI testing tools are expensive | TinyDancer 3-tier model routing reduces costs by matching task complexity to appropriate model |

| No memory between test runs—every analysis starts from scratch | ReasoningBank remembers patterns, strategies, and what works for your codebase |

| Agents waste tokens reading irrelevant code | Code Intelligence provides token reduction with semantic search and knowledge graphs |

| Quality engineering requires complex coordination | Queen Coordinator orchestrates 51 agents across 12 domains with consensus and MinCut topology |

| Tools don't understand your testing frameworks | Works with Jest, Cypress, Playwright, Vitest, Mocha, Jasmine, AVA |

---

🏗️ Domain-Driven Design Architecture

V3 is built on 12 DDD Bounded Contexts, each with dedicated agents and clear responsibilities:

| Domain | Purpose | Key Agents |

|--------|---------|------------|

| test-generation | AI-powered test creation | qe-test-architect, qe-tdd-specialist |

| test-execution | Parallel execution & retry | qe-parallel-executor, qe-retry-handler |

| coverage-analysis | O(log n) gap detection | qe-coverage-specialist, qe-gap-detector |

| quality-assessment | Quality gates & decisions | qe-quality-gate, qe-risk-assessor |

| defect-intelligence | Prediction & root cause | qe-defect-predictor, qe-root-cause-analyzer |

| requirements-validation | BDD & testability | qe-requirements-validator, qe-bdd-generator |

| code-intelligence | Knowledge graph & search | qe-code-intelligence, qe-kg-builder |

| security-compliance | SAST/DAST & audit | qe-security-scanner, qe-security-auditor |

| contract-testing | API contracts & GraphQL | qe-contract-validator, qe-graphql-tester |

| visual-accessibility | Visual regression & a11y | qe-visual-tester, qe-accessibility-auditor |

| chaos-resilience | Chaos engineering & load | qe-chaos-engineer, qe-load-tester |

| learning-optimization | Cross-domain learning | qe-learning-coordinator, qe-pattern-learner |

---

✅ Skill Trust Tiers (v3.4.2)

AQE includes 67 QE skills (46 Tier 3 verified