Profa
b9bbbef5fe
Documentation Structure:
├── README.md - Main index and overview
├── guides/
│ ├── getting-started.md - Quick start guide
│ └── quick-reference.md - CLI command reference card
├── migration/
│ └── v2-to-v3-migration.md - Complete migration guide
├── architecture/
│ ├── overview.md - Architecture diagrams and concepts
│ └── ddd-domains.md - 12 bounded context details
├── domains/
│ └── index.md - Domain index and summaries
├── agents/
│ ├── index.md - Agent hierarchy (47+ agents)
│ └── protocols.md - 6 coordination protocols
└── reference/
├── cli-commands.md - Full CLI reference
├── events.md - Domain events reference
└── configuration.md - Configuration reference
Covers: architecture, DDD domains, agents, migration, CLI, events, configuration
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
10 KiB
DDD Bounded Contexts
Agentic QE v3 organizes quality engineering into 12 bounded contexts, each with clear boundaries and responsibilities.
Domain Map
┌─────────────────────────────────────────────────────────────────┐
│ 12 BOUNDED CONTEXTS │
├─────────────────────────────────────────────────────────────────┤
│ │
│ CORE TESTING (4 domains) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ TEST │ │ TEST │ │ COVERAGE │ │
│ │ GENERATION │──│ EXECUTION │──│ ANALYSIS │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │ │
│ └─────────────────┴─────────────────┘ │
│ │ │
│ ┌──────────────┐ │
│ │ QUALITY │ │
│ │ ASSESSMENT │ │
│ └──────────────┘ │
│ │
│ INTELLIGENCE (4 domains) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ DEFECT │ │ CODE │ │ SECURITY │ │
│ │INTELLIGENCE │──│INTELLIGENCE │──│ COMPLIANCE │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │
│ ┌──────────────┐ │
│ │ REQUIREMENTS │ │
│ │ VALIDATION │ │
│ └──────────────┘ │
│ │
│ SPECIALIZED (4 domains) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ CONTRACT │ │ VISUAL │ │ CHAOS │ │
│ │ TESTING │──│ACCESSIBILITY │──│ RESILIENCE │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │
│ ┌──────────────┐ │
│ │ LEARNING │ │
│ │ OPTIMIZATION │ │
│ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Domain Summaries
1. Test Generation
Purpose: AI-powered test creation with pattern learning
Agents (5):
v3-qe-test-architect- Strategic test planningv3-qe-tdd-specialist- TDD red-green-refactorv3-qe-integration-tester- Integration test creationv3-qe-property-tester- Property-based testingv3-qe-test-data-architect- Test data generation
Key Events: TestCaseGenerated, TestSuiteCreated, PatternLearned
2. Test Execution
Purpose: Parallel test execution with intelligent retry
Agents (4):
v3-qe-parallel-executor- Distributed executionv3-qe-flaky-hunter- Flaky test detectionv3-qe-retry-handler- Intelligent retry logicv3-qe-execution-optimizer- Execution optimization
Key Events: TestRunStarted, TestRunCompleted, FlakyTestDetected
3. Coverage Analysis
Purpose: O(log n) coverage gap detection with HNSW
Agents (4):
v3-qe-coverage-specialist- Coverage metricsv3-qe-gap-detector- HNSW-based gap detectionv3-qe-risk-scorer- Risk-weighted coveragev3-qe-mutation-tester- Mutation testing
Key Events: CoverageReportCreated, CoverageGapDetected, RiskZoneIdentified
4. Quality Assessment
Purpose: Intelligent quality gate decisions
Agents (4):
v3-qe-quality-gate- Quality gate evaluationv3-qe-quality-analyzer- Metrics analysisv3-qe-deployment-advisor- Deployment readinessv3-qe-code-complexity- Code complexity analysis
Key Events: QualityGateEvaluated, DeploymentApproved, DeploymentBlocked
5. Defect Intelligence
Purpose: Defect prediction and root cause analysis
Agents (4):
v3-qe-defect-predictor- ML-based predictionv3-qe-pattern-learner- Pattern recognitionv3-qe-root-cause-analyzer- Root cause analysisv3-qe-regression-analyzer- Regression risk analysis
Key Events: DefectPredicted, RootCauseIdentified, RegressionRiskAnalyzed
6. Requirements Validation
Purpose: Requirements analysis and testability validation
Agents (4):
v3-qe-requirements-validator- Requirements validationv3-qe-bdd-scenario-writer- BDD scenario generationv3-qe-testability-scorer- Testability analysisv3-qe-acceptance-criteria- AC validation
Key Events: RequirementAnalyzed, BDDScenariosGenerated, TestabilityScored
7. Code Intelligence
Purpose: Knowledge Graph and semantic code understanding
Agents (4):
v3-qe-code-intelligence- Knowledge Graph builderv3-qe-semantic-analyzer- Semantic code analysisv3-qe-dependency-mapper- Dependency analysisv3-qe-impact-analyzer- Change impact analysis
Key Events: KnowledgeGraphUpdated, ImpactAnalysisCompleted, SemanticSearchCompleted
8. Security Compliance
Purpose: Security scanning and regulatory compliance
Agents (4):
v3-qe-security-scanner- SAST/DAST scanningv3-qe-security-auditor- Security auditv3-qe-compliance-validator- Regulatory compliancev3-qe-vulnerability-tracker- CVE tracking
Key Events: VulnerabilityDetected, ComplianceValidated, SecurityAuditCompleted
9. Contract Testing
Purpose: API contract validation and compatibility
Agents (4):
v3-qe-contract-validator- Contract testing (Pact)v3-qe-api-compatibility- API compatibility checkingv3-qe-schema-validator- Schema validationv3-qe-graphql-tester- GraphQL testing
Key Events: ContractViolationDetected, SchemaValidated, APICompatibilityChecked
10. Visual Accessibility
Purpose: Visual regression and accessibility compliance
Agents (4):
v3-qe-visual-tester- Visual regression testingv3-qe-a11y-specialist- Accessibility testing (WCAG 2.2)v3-qe-responsive-tester- Responsive design testingv3-qe-screenshot-differ- Screenshot comparison
Key Events: VisualRegressionDetected, AccessibilityIssueFound, ScreenshotBaselineUpdated
11. Chaos Resilience
Purpose: Chaos engineering and resilience testing
Agents (4):
v3-qe-chaos-engineer- Chaos engineeringv3-qe-resilience-tester- Resilience validationv3-qe-load-tester- Load/stress testingv3-qe-performance-profiler- Performance profiling
Key Events: ChaosExperimentCompleted, ResilienceValidated, PerformanceBottleneckFound
12. Learning Optimization
Purpose: Cross-domain learning and continuous improvement
Agents (5):
v3-qe-learning-coordinator- Learning orchestrationv3-qe-transfer-specialist- Knowledge transferv3-qe-metrics-optimizer- Metrics optimizationv3-qe-production-intel- Production intelligencev3-qe-knowledge-manager- Knowledge management
Key Events: PatternConsolidated, TransferCompleted, OptimizationApplied
Context Mapping
Upstream/Downstream Relationships
Test Generation ──────▶ Test Execution ──────▶ Coverage Analysis
│ │ │
▼ ▼ ▼
Code Intelligence ◀──── Defect Intelligence ◀─── Quality Assessment
│ │ │
▼ ▼ ▼
Requirements ──────────▶ Learning Optimization ◀──── All Domains
Shared Kernel
Common types and events shared across domains:
// v3/src/shared/
├── entities/ # Common entities
├── value-objects/ # Shared value objects
├── events/ # Cross-domain events
├── interfaces/ # Common interfaces
└── types/ # Shared types
Anti-Corruption Layers
Each domain maintains its own model, translating external concepts:
// Contract testing domain translating from test execution
class TestExecutionTranslator {
translateTestResult(external: TestResult): ContractTestResult {
return {
contractId: this.mapToContract(external.testId),
status: this.translateStatus(external.status),
violations: this.extractViolations(external)
};
}
}