Files
Dragan Spiridonov c2f973e792 feat: add CLI code intelligence commands (complexity, --incremental, --git-since) and fix stale references
- Add `aqe code complexity` action with cyclomatic/cognitive/Halstead metrics, hotspot detection, batched concurrency
- Add `--incremental` and `--git-since <ref>` flags for `aqe code index`
- Fix command injection vulnerability: replace execSync with execFileSync (CWE-78)
- Fix missing return after cleanupAndExit in complexity action
- Add --depth NaN validation
- Import shared SOURCE_EXTENSIONS instead of duplicating inline
- Fix stale `aqe kg` commands in SKILL.md Quick Start/CLI Examples across .claude/, assets/, .kiro/
- Fix phantom agent names (qe-knowledge-graph, qe-semantic-searcher) in skills, evals, and catalog
- Fix `ruflo doctor --fix` references in CLAUDE.md, skill gotchas, and docs → `aqe health`/`aqe init`
- Fix `aqe code-intelligence index` → `aqe code index .` in fleet integration guide
- Add code intelligence CLI section to README.md
- Fix tool-scoping test: add hypergraph_query to all 5 scoped roles
- Fix queen-dependency test: correct expectation for agents without inline mcp__ refs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-30 09:57:49 +00:00

3.3 KiB

Getting Started with Agentic QE v3

This guide walks you through setting up and using Agentic QE v3's DDD-based quality engineering system.

Prerequisites

  • Node.js 18+
  • TypeScript 5.0+
  • Claude Code CLI
  • (Optional) PostgreSQL for RuVector code intelligence

Installation

# Install Agentic QE
npm install -g agentic-qe

# Verify installation
aqe --version
# v3.0.0

# Initialize in your project
aqe init

Quick Start

1. Generate Tests

# Generate unit tests for a file
aqe test generate --file src/services/UserService.ts --framework jest

# Generate with coverage target
aqe test generate --scope src/api/ --coverage 90

2. Analyze Coverage

# O(log n) coverage gap detection
aqe coverage analyze --source src/ --tests tests/

# Risk-weighted analysis
aqe coverage gaps --risk-weighted --threshold 80

3. Run Quality Gate

# Evaluate deployment readiness
aqe quality assess --gates all

# Check specific gates
aqe quality check --coverage 80 --no-critical-vulns

4. Execute Tests

# Parallel execution with retry
aqe test run --parallel --workers 4 --retry 3

# Run affected tests only
aqe test run --affected --since HEAD~1

Using Agents

Spawn Individual Agents

// Via Claude Code Task tool
Task("Generate tests", `
  Analyze src/services/PaymentService.ts and generate comprehensive tests.
  Include happy paths, edge cases, and error handling.
`, "qe-test-generator")

Multi-Agent Workflows

// Parallel agent execution
Task("Coverage analysis", "Analyze coverage gaps", "qe-coverage-specialist")
Task("Quality check", "Evaluate quality gates", "qe-quality-gate")
Task("Security scan", "Run security audit", "qe-security-scanner")

Domain Commands

Each of the 12 domains has dedicated CLI commands:

Domain Command Prefix Example
Test Generation aqe test aqe test generate
Test Execution aqe test run aqe test run --parallel
Coverage aqe coverage aqe coverage analyze
Quality aqe quality aqe quality assess
Defects aqe defect aqe defect predict
Code Intelligence aqe code aqe code index src/
Requirements aqe requirements aqe requirements trace
Security aqe security aqe security scan
Contracts aqe contract aqe contract verify
Visual aqe visual aqe visual test
Chaos aqe chaos aqe chaos run
Learning aqe learn aqe learn status

Configuration

Create .agentic-qe/config.yaml:

v3:
  version: "3.0.0"

  # Enable all 12 domains
  domains:
    - test-generation
    - test-execution
    - coverage-analysis
    - quality-assessment
    - defect-intelligence
    - code-intelligence
    - requirements-validation
    - security-compliance
    - contract-testing
    - visual-accessibility
    - chaos-resilience
    - learning-optimization

  # Agent limits
  maxConcurrentAgents: 15

  # Memory backend
  memoryBackend: hybrid  # SQLite + AgentDB
  hnswEnabled: true

  # Learning
  neuralLearning: true

Next Steps