mirror of
https://github.com/proffesor-for-testing/agentic-qe.git
synced 2026-09-19 08:45:47 +08:00
Profa
2253d05618
Remove the nested v3/ subdirectory by moving all active source code, tests, configs, and assets directly to the project root. Archive v2/ (dead code, 847MB) to v2-archive.tar.gz. Key changes: - Move v3/src/ → src/, v3/tests/ → tests/, v3/packages/ → packages/ - Move v3/tsconfig.json, v3/vitest.config.ts to root - Merge v3/package.json into root package.json (ESM, scripts, deps, exports) - Merge v3/scripts/ into scripts/, v3/implementation/ into docs/implementation/ - Update all CI workflows to remove "cd v3 &&" and v3/ path prefixes - Fix all init installer path resolution (3-level-up → 2-level-up) - Fix hooks to use "node ./dist/cli/bundle.js" instead of bare "aqe" - Update settings.json ADR/DDD directories to docs/implementation/ - Fix helper scripts (statusline, adr-compliance, ddd-tracker, guidance-hooks) - Update 58 agent definitions: aqe/v3/ → aqe/ memory namespaces - Update 15 guidance shards: v3/src/ → src/ path references - Fix sync interfaces: remove v3/ and v2/ path references - Fix test path calculations (process.cwd() + '..' no longer needed) - Fix flaky perf test threshold (500ms → 1000ms for CI environments) - Fix complexity-analyzer test to match ADR-051 keyword-based eligibility Build passes, 17,901 tests pass, CLI and MCP bundles verified. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
91 lines
2.6 KiB
Markdown
91 lines
2.6 KiB
Markdown
# Agentic QE v3 Implementation Documentation
|
|
|
|
This directory contains all implementation documentation, planning, and research for Agentic QE v3.
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
implementation/
|
|
├── adrs/ # Architecture Decision Records
|
|
├── architecture/ # Architecture diagrams & analysis
|
|
├── planning/ # Master plans & implementation strategies
|
|
├── security/ # Security considerations
|
|
└── agents/ # Agent specifications
|
|
```
|
|
|
|
## Document Index
|
|
|
|
### ADRs (Architecture Decision Records)
|
|
| Document | Description |
|
|
|----------|-------------|
|
|
| [v3-adrs.md](./adrs/v3-adrs.md) | All 10 ADRs (001-010) master document |
|
|
|
|
### Planning
|
|
| Document | Description |
|
|
|----------|-------------|
|
|
| [AQE-V3-MASTER-PLAN.md](./planning/AQE-V3-MASTER-PLAN.md) | Complete v3 master plan with DDD architecture |
|
|
|
|
## Quick Links
|
|
|
|
- **Skills:** [/.claude/skills/v3-qe-ddd-architecture/](../../.claude/skills/v3-qe-ddd-architecture/)
|
|
- **Agents:** [/.claude/agents/v3/](../../.claude/agents/v3/)
|
|
- **Source (future):** [/v3/src/](../src/) - v3 source code (to be implemented)
|
|
|
|
## Key Concepts
|
|
|
|
### Domain-Driven Design for QE
|
|
|
|
Agentic QE v3 uses DDD with 6 bounded contexts:
|
|
|
|
1. **Test Generation** - AI-powered test creation
|
|
2. **Test Execution** - Parallel execution and retry
|
|
3. **Coverage Analysis** - O(log n) gap detection
|
|
4. **Quality Assessment** - Quality gates and metrics
|
|
5. **Defect Intelligence** - Prediction and analysis
|
|
6. **Learning Optimization** - Pattern learning and transfer
|
|
|
|
### Agent Hierarchy
|
|
|
|
21 specialized v3 agents organized hierarchically:
|
|
- Queen Coordinator (orchestration)
|
|
- Test Generation Group (4 agents)
|
|
- Quality Gates Group (3 agents)
|
|
- Intelligence Group (3 agents)
|
|
- Execution Group (3 agents)
|
|
- Coverage Group (3 agents)
|
|
- Learning Group (4 agents)
|
|
|
|
### Key ADRs
|
|
|
|
| ADR | Decision |
|
|
|-----|----------|
|
|
| ADR-001 | Adopt DDD for QE bounded contexts |
|
|
| ADR-002 | Event-driven domain communication |
|
|
| ADR-003 | Sublinear O(log n) coverage analysis |
|
|
| ADR-004 | Plugin architecture for extensions |
|
|
| ADR-005 | AI-first test generation |
|
|
|
|
## Getting Started
|
|
|
|
```bash
|
|
# Use v3 DDD skill
|
|
Task("Analyze QE architecture",
|
|
"Design DDD bounded contexts for quality engineering",
|
|
"system-architect")
|
|
|
|
# Use v3 Queen Coordinator
|
|
Task("Orchestrate QE workflow",
|
|
"Coordinate full quality engineering workflow",
|
|
"v3-qe-queen-coordinator")
|
|
|
|
# Use v3 Test Architect
|
|
Task("Generate tests",
|
|
"Create AI-powered test suite for UserService",
|
|
"v3-qe-test-architect")
|
|
```
|
|
|
|
---
|
|
|
|
**Last Updated:** 2026-01-07
|
|
**Version:** 1.0.0
|