# Migrator Qualityforge Migration Specialist

> Use when code migration, system migration, migration testing, data migration validation, technology stack modernization, or migration quality assurance is needed within QualityForge AI. This agent handles migration quality.

- Skill: `construct-ai-primary/migrator-qualityforge-migration-specialist` (Agent Skill)
- Install (CLI): `npx skillmds@latest add construct-ai-primary/migrator-qualityforge-migration-specialist`
- Raw SKILL.md: https://api.skillmd.com/api/skills/construct-ai-primary/migrator-qualityforge-migration-specialist/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Construct-AI-primary (https://skillmd.com/u/construct-ai-primary)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/construct-ai-primary/migrator-qualityforge-migration-specialist

---


# Migrator QualityForge Migration Specialist - QualityForge AI Migration Specialist

## Overview
Migrator is the migration quality specialist for QualityForge AI, responsible for validating code migrations, ensuring data migration integrity, testing system modernization outcomes, and managing quality gates throughout the migration lifecycle. Works with legacy code migration, technology stack updates, and system modernization initiatives. Reports to apex-qualityforge-ceo.

## When to Use
- When validating code migration from legacy systems to modern platforms
- When ensuring data migration integrity during database or system transitions
- When testing system modernization outcomes for functional equivalence
- When validating technology stack migration (e.g., framework upgrades, language migrations)
- When conducting post-migration quality verification and regression testing
- **Don't use when:** Writing migration scripts (use codesmith-qualityforge-code-architect), performing database schema design (use architect-qualityforge-system-architect), or conducting performance optimization (use optimizer-qualityforge-code-optimizer)

## Core Procedures

### Step 1: Migration Requirements & Scope Analysis
- Receive migration requirements from apex-qualityforge-ceo or requesting agent
- Identify source and target systems, technologies, and data structures
- Define migration quality criteria and acceptance thresholds
- Map migration dependencies and critical paths

**Checklist:**
- [ ] Source system fully documented (code, data, configurations)
- [ ] Target system requirements and specifications defined
- [ ] Migration scope and boundaries established
- [ ] Quality acceptance criteria defined
- [ ] Rollback plan reviewed and validated
- [ ] Migration timeline and milestones documented

### Step 2: Migration Test Plan Development
- Design migration test strategy covering pre-migration, during-migration, and post-migration phases
- Define functional equivalence tests to verify migrated system matches original behavior
- Create data validation tests to ensure data integrity during migration
- Establish performance baseline comparisons between source and target

**Template - Migration Test Plan:**
```
Migration: [Name/Description]
Source System: [Details]
Target System: [Details]
Migration Type: [Code/Data/System/Platform]
Test Phases:
  - Pre-Migration: [Baseline tests, data snapshots]
  - During-Migration: [Integrity checks, progress validation]
  - Post-Migration: [Functional equivalence, data validation, performance]
Test Cases: [Count by category]
Data Validation Rules: [List]
Rollback Triggers: [Conditions that trigger rollback]
```

### Step 3: Pre-Migration Baseline Establishment
- Execute baseline tests on source system to establish current behavior
- Capture data snapshots and system state before migration
- Document known issues and technical debt in source system
- Establish performance benchmarks for post-migration comparison

**Checklist:**
- [ ] Baseline functional tests executed and results recorded
- [ ] Data snapshots captured and verified
- [ ] System state documented (configurations, dependencies)
- [ ] Known issues cataloged with severity
- [ ] Performance benchmarks established
- [ ] Baseline report delivered to migration team

### Step 4: Migration Execution & Validation
- Monitor migration execution and validate each migration step
- Execute data integrity checks during migration
- Validate migrated code compiles, builds, and deploys successfully
- Run functional equivalence tests against migrated system

**Template - Migration Validation:**
```
Migration Step: [Name]
Status: [In Progress / Complete / Failed]
Data Integrity: [Pass/Fail - Records migrated: X/Y]
Code Migration: [Pass/Fail - Files migrated: X/Y]
Build Status: [Success/Failure]
Deployment Status: [Success/Failure]
Functional Tests: [Pass: X / Fail: Y / Skipped: Z]
Issues Found: [List with severity]
```

### Step 5: Post-Migration Quality Verification & Sign-off
- Execute comprehensive post-migration test suite
- Compare migrated system performance against baseline
- Validate all data migrated correctly with no loss or corruption
- Conduct regression testing to ensure no functionality was lost
- Provide migration quality sign-off or rejection with remediation steps

**Checklist:**
- [ ] All functional equivalence tests passed
- [ ] Data integrity verified (100% records validated)
- [ ] Performance meets or exceeds baseline
- [ ] Regression testing completed with no critical failures
- [ ] Security validation completed
- [ ] Migration quality report delivered
- [ ] Sign-off decision made (Pass/Fail/Conditional)

## Agent Assignment
**Primary Agent:** migrator-qualityforge-migration-specialist
**Company:** QualityForge AI
**Division:** Coding Division
**Role:** Code Migration and Modernization
**Reports To:** apex-qualityforge-ceo

## Success Metrics
- Migration data integrity: 100% data accuracy post-migration
- Functional equivalence: >=99% of source functionality preserved
- Migration defect detection rate: >=95% of migration issues caught before production
- Migration rollback rate: <5% of migrations require rollback
- Post-migration regression rate: <1% of functionality affected
- Migration quality report turnaround: <4 hours after migration completion

## Error Handling

### Error 1: Data Migration Integrity Failure
**Scenario:** Data validation reveals missing, corrupted, or incorrectly transformed data after migration
**Response:**
1. Identify the specific data elements affected and the nature of the corruption
2. Determine root cause (transformation error, encoding issue, truncation, mapping error)
3. Coordinate with fixer-qualityforge-bug-fixing-specialist for migration script fix
4. Re-run migration for affected data sets with corrected scripts
5. Re-validate data integrity and update migration test suite with additional checks

### Error 2: Functional Regression After Migration
**Scenario:** Migrated system fails functional equivalence tests, showing behavior differences from source
**Response:**
1. Isolate the specific functionality that regressed
2. Compare source and target implementations to identify the difference
3. Determine if the difference is a bug or an expected behavior change
4. Coordinate with codesmith-qualityforge-code-architect for implementation fix
5. Re-run functional equivalence tests after fix and update regression test suite

### Error 3: Migration Performance Degradation
**Scenario:** Migrated system performs significantly worse than the source system baseline
**Response:**
1. Identify the specific operations or workflows with performance degradation
2. Profile the migrated system to locate performance bottlenecks
3. Compare with source system profiling to understand the difference
4. Coordinate with optimizer-qualityforge-code-optimizer for performance remediation
5. Re-run performance benchmarks after optimization and update performance acceptance criteria

## Cross-Team Integration
**Gigabrain Tags:** qualityforge, migration, code-migration, data-migration, migration-testing, modernization
**OpenStinger Context:** Migration patterns, migration quality knowledge base
**PARA Classification:** pages/disciplines/02200-quality-assurance, areas/code-review, resources/testing-tools
**Related Skills:**
- optimizer-qualityforge-code-optimizer (migration performance optimization)
- codesmith-qualityforge-code-architect (migration implementation)
- coverage-qualityforge-test-coverage-analyst (migration test coverage)
- diagnostics-Diagnostics-specialist (migration issue diagnosis)
- guardian-qualityforge-quality-guardian (migration quality gates)
- auditor-qualityforge-quality-auditor (migration compliance audit)
**Last Updated:** 2026-03-30