Migrate Agentic QE projects from v2 to v3 with zero data loss
View on GitHubJanuary 22, 2026
Select agents to install to:
npx add-skill https://github.com/proffesor-for-testing/agentic-qe/blob/69c8b259de9d554e0473c776101f70a29c65efb5/v3/assets/skills/aqe-v2-v3-migration/skill.md -a claude-code --skill aqe-v2-v3-migrationInstallation paths:
.claude/skills/aqe-v2-v3-migration/# AQE v2 to v3 Migration Skill <default_to_action> When migrating from v2 to v3: 1. ANALYZE current v2 installation 2. BACKUP all data before any changes 3. MIGRATE configuration, memory, and patterns 4. VALIDATE migration success 5. PROVIDE rollback instructions **Never delete v2 data without explicit user confirmation.** </default_to_action> ## Quick Reference ### Migration Command ```bash # Install v3 alongside v2 npm install @agentic-qe/v3 # Run migration npx aqe migrate # Or use this skill /aqe-v2-v3-migration ``` ### What Gets Migrated | Component | v2 Location | v3 Location | Auto-Migrate | |-----------|-------------|-------------|--------------| | Memory DB | `.agentic-qe/memory.db` | `.aqe/agentdb/` | Yes | | Config | `.agentic-qe/config.json` | `.aqe/config.json` | Yes | | Patterns | `.agentic-qe/patterns/` | `.aqe/reasoning-bank/` | Yes | | Cache | `.agentic-qe/cache/` | `.aqe/cache/` | Optional | | Logs | `.agentic-qe/logs/` | `.aqe/logs/` | No (fresh start) | --- ## Migration Checklist ### Pre-Migration - [ ] Verify v2 installation exists (`.agentic-qe/` directory) - [ ] Check v2 version: `aqe --version` (should be 2.x.x) - [ ] Backup current data: `npm run backup` (in v2 project) - [ ] Note any custom configurations - [ ] Document current test counts and coverage ### During Migration - [ ] Install v3: `npm install @agentic-qe/v3` - [ ] Run migration: `npx aqe migrate` - [ ] Review migration report - [ ] Verify data transferred correctly ### Post-Migration - [ ] Run v3 tests: `npx aqe test` - [ ] Check coverage: `npx aqe coverage` - [ ] Verify patterns loaded: `npx aqe patterns list` - [ ] Test MCP integration with Claude Code --- ## Architecture Changes (v2 → v3) ### From Monolithic to DDD ``` v2 Structure: v3 Structure: ├── src/mcp/tools/ ├── src/domains/ │ ├── test-*.ts (40+ tools) │ ├── test-generation/ │ └── ... │ ├── test-execution/ ├── src/core/agents/ │ ├