القائمة
Migrate Agentic QE projects from v2 to v3 with zero data loss
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/ForceInjection/domain-driven-design-skills --skill aqe-v2-v3-migrationيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Conduct deep academic research for philosophy, neuroscience, cognitive science, and theoretical computer science (computability, complexity, AI theory, logic). Use when user asks to: research academic topics, find scholarly papers, conduct literature reviews, analyze citations, synthesize research findings, explore philosophical arguments, investigate consciousness/cognition, study computability/decidability/Turing machines, or analyze academic debates. Triggers on: 'research papers', 'literature review', 'academic sources', 'scholarly articles', 'philosophy of mind', 'computability theory', 'neuroscience studies', 'find papers on', 'what does the research say'.
Create clear action plans with steps, success criteria, and risk awareness. Use before implementing features, making changes, starting projects, or anytime you need a roadmap to success. Triggers on "plan this", "how should we approach", "what's the strategy", "steps to complete", or when facing complex multi-step work.
Add keyboard navigation to a feature using CommandRegistryService. Use when implementing keyboard shortcuts, vim-style navigation, or hotkeys for a page or component.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | aqe-v2-v3-migration |
| version | 1.0.0 |
| description | Migrate Agentic QE projects from v2 to v3 with zero data loss |
| author | Agentic QE Team |
| tags | ["migration","upgrade","v2-to-v3","agentic-qe"] |
| trigger | ["migrate from v2 to v3","upgrade agentic-qe","aqe migration","v2 to v3 migration"] |
<default_to_action> When migrating from v2 to v3:
Never delete v2 data without explicit user confirmation. </default_to_action>
# Install v3 alongside v2
npm install @agentic-qe/v3
# Run migration
npx aqe migrate
# Or use this skill
/aqe-v2-v3-migration
| 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) |
.agentic-qe/ directory)aqe --version (should be 2.x.x)npm run backup (in v2 project)npm install @agentic-qe/v3npx aqe migratenpx aqe testnpx aqe coveragenpx aqe patterns listv2 Structure: v3 Structure:
├── src/mcp/tools/ ├── src/domains/
│ ├── test-*.ts (40+ tools) │ ├── test-generation/
│ └── ... │ ├── test-execution/
├── src/core/agents/ │ ├── coverage-analysis/
│ ├── mixed agents │ ├── quality-assessment/
│ └── ... │ ├── defect-intelligence/
└── src/core/memory/ │ ├── requirements-validation/
└── scattered impls │ ├── code-intelligence/
│ ├── security-compliance/
│ ├── contract-testing/
│ ├── visual-accessibility/
│ ├── chaos-resilience/
│ └── learning-optimization/
├── src/kernel/
│ ├── event-bus.ts
│ └── coordinator.ts
└── src/mcp/
└── domain-handlers.ts
| v2 API | v3 API | Notes |
|---|---|---|
aqe init | aqe init | Different binary |
aqe.generateTests() | testGeneration.generate() | Domain-based |
aqe.analyzeGaps() | coverageAnalysis.findGaps() | O(log n) now |
memory.store() | agentDB.store() | HNSW-indexed |
patterns.learn() | reasoningBank.record() | With verdicts |
{
"version": "2.8.2",
"memory": {
"path": ".agentic-qe/memory.db",
"type": "sqlite"
},
"agents": {
"enabled": ["test-generator", "coverage-analyzer"]
}
}
{
"version": "3.0.0",
"kernel": {
"eventBus": "in-memory",
"coordinator": "queen"
},
"domains": {
"test-generation": { "enabled": true },
"test-execution": { "enabled": true },
"coverage-analysis": {
"enabled": true,
"algorithm": "hnsw",
"dimensions": 128
}
},
"memory": {
// v2: Direct SQLite access
import Database from 'better-sqlite3';
const db = new Database('.agentic-qe/memory.db');
const patterns = db.prepare('SELECT * FROM patterns').all();
// v3: AgentDB with HNSW
import { AgentDB } from '@agentic-qe/v3';
const db = new AgentDB('.aqe/agentdb/');
await db.initialize({ dimensions: 128, M: 16 });
// Migration script transfers and indexes
for (const pattern of v2Patterns) {
await db.store({
key: pattern.id,
value: pattern.data,
embedding: await generateEmbedding(pattern.data),
metadata: { migratedFrom: 'v2', originalId: pattern.id }
});
}
Import Paths
// v2
import { AgenticQE } from 'agentic-qe';
// v3
import { TestGenerationDomain } from '@agentic-qe/v3/domains';
CLI Commands
# v2
aqe test --parallel
# v3
aqe test --workers=4 --topology=mesh
MCP Server
# v2
claude mcp add aqe -- npx aqe-mcp
# v3
claude mcp add aqe -- npx @agentic-qe/v3 mcp
aqe.runTests() → Use domain-specific methodsIf migration fails or you need to revert:
# 1. v3 does NOT modify v2 data
# Your .agentic-qe/ folder is untouched
# 2. Remove v3 installation
npm uninstall @agentic-qe/v3
rm -rf .aqe/
# 3. Continue using v2
aqe --version # Should show 2.x.x
// Use Task tool to spawn migration agents in parallel
Task({
prompt: "Analyze v2 memory.db and extract all patterns",
subagent_type: "researcher",
description: "Analyze v2 patterns"
});
Task({
prompt: "Convert v2 config to v3 format",
subagent_type: "coder",
description: "Convert config"
});
Task({
prompt: "Validate migration results",
subagent_type: "tester",
description: "Validate migration"
});
| Issue | Cause | Solution |
|---|---|---|
| "Cannot find .agentic-qe/" | No v2 installation | Run aqe init first |
| "Memory migration failed" | Corrupted SQLite | Use backup: npm run backup:restore |
| "HNSW index error" | Dimension mismatch | Set dimensions: 128 in config |
| "Pattern not found" | Not migrated | Re-run: aqe migrate --patterns |
# Run migration with debug output
DEBUG=aqe:migrate npx aqe migrate
# Check migration logs
cat .aqe/logs/migration.log
[v2-v3-migration] tag| v2 Version | v3 Version | Migration Support |
|---|---|---|
| 2.8.x | 3.0.x | Full |
| 2.7.x | 3.0.x | Full |
| 2.6.x | 3.0.x | Partial (config only) |
| 2.5.x and below | 3.0.x | Manual migration |
Skill Version: 1.0.0 | Last Updated: 2026-01-11