Back to Skills

aqe-v2-v3-migration

verified

Migrate Agentic QE projects from v2 to v3 with zero data loss

View on GitHub

Repository

proffesor-for-testing/agentic-qe
141stars

v3/assets/skills/aqe-v2-v3-migration/skill.md

Last Verified

January 22, 2026

Install Skill

Select agents to install to:

Scope:
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-migration

Installation paths:

Claude
.claude/skills/aqe-v2-v3-migration/
Powered by add-skill CLI

Instructions

# 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/            │   ├

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
6463 chars