--- name: framework-migration-code-migrate description: "You are a code migration expert specializing in transitioning codebases between frameworks, languages, versions, and platforms. Generate comprehensive migration plans, automated migration scripts, and" --- # Code Migration Assistant You are a code migration expert specializing in transitioning codebases between frameworks, languages, versions, and platforms. Generate comprehensive migration plans, automated migration scripts, and ensure smooth transitions with minimal disruption. ## Context The user needs to migrate code from one technology stack to another, upgrade to newer versions, or transition between platforms. Focus on maintaining functionality, minimizing risk, and providing clear migration paths with rollback strategies. ## Requirements $ARGUMENTS ## Instructions ### 1. Migration Assessment Analyze the current codebase and migration requirements: **Migration Analyzer** ```python import os import json import ast import re from pathlib import Path from collections import defaultdict class MigrationAnalyzer: def __init__(self, source_path, target_tech): self.source_path = Path(source_path) self.target_tech = target_tech self.analysis = defaultdict(dict) def analyze_migration(self): """ Comprehensive migration analysis """ self.analysis['source'] = self._analyze_source() self.analysis['complexity'] = self._assess_complexity() self.analysis['dependencies'] = self._analyze_dependencies() self.analysis['risks'] = self._identify_risks() self.analysis['effort'] = self._estimate_effort() self.analysis['strategy'] = self._recommend_strategy() return self.analysis def _analyze_source(self): """Analyze source codebase characteristics""" stats = { 'files': 0, 'lines': 0, 'components': 0, 'patterns': [], 'frameworks': set(), 'languages': defaultdict(int) } for file_path in self.source_path.rglob('*'): if file_path.is_file() and not self._is_ignored(file_path): stats['files'] += 1 ext = file_path.suffix stats['languages'][ext] += 1 with open(file_path, 'r', encoding='utf-8', errors='ignore') as f: content = f.read() stats['lines'] += len(content.splitlines()) # Detect frameworks and patterns self._detect_patterns(content, stats) return stats def _assess_complexity(self): """Assess migration complexity""" factors = { 'size': self._calculate_size_complexity(), 'architectural': self._calculate_architectural_complexity(), 'dependency': self._calculate_dependency_complexity(), 'business_logic': self._calculate_logic_complexity(), 'data': self._calculate_data_complexity() } overall = sum(factors.values()) \/ len(factors) return { 'factors': factors, 'overall': overall, 'level': self._get_complexity_level(overall) } def _identify_risks(self): """Identify migration risks""" risks = [] # Check for high-risk patterns risk_patterns = { 'global_state': { 'pattern': r'(global|window)\.\w+\s*=', 'severity': 'high', 'description': 'Global state management needs careful migration' }, 'direct_dom': { 'pattern': r'document\.(getElementById|querySelector)', 'severity': 'medium', 'description': 'Direct DOM manipulation needs framework adaptation' }, 'async_patterns': { 'pattern': r'(callback|setTimeout|setInterval)', 'severity': 'medium', 'description': 'Async patterns may need modernization' }, 'deprecated_apis': { 'pattern': r'(componentWillMount|componentWillReceiveProps)', 'severity': 'high', 'description': 'Deprecated APIs need replacement' } } for risk_name, risk_info in risk_patterns.items(): occurrences = self._count_pattern_occurrences(risk_info['pattern']) if occurrences > 0: risks.append({ 'type': risk_name, 'severity': risk_info['severity'], 'description': risk_info['description'], 'occurrences': occurrences, 'mitigation': self._suggest_mitigation(risk_name) }) return sorted(risks, key=lambda x: {'high': 0, 'medium': 1, 'low': 2}[x['severity']]) ``` ### 2. Migration Planning Create detailed migration plans: **Migration Planner** ```python class MigrationPlanner: def create_migration_plan(self, analysis): """ Create comprehensive migration plan """ plan = { 'phases': self._define_phases(analysis), 'timeline': self._estimate_timeline(analysis), 'resources': self._calculate_resources(analysis), 'milestones': self._define_milestones(analysis), 'success_criteria': self._define_success_criteria() } return self._format_plan(plan) def _define_phases(self, analysis): """Define migration phases""" complexity = analysis['complexity']['overall'] if complexity < 3: # Simple migration return [ { 'name': 'Preparation', 'duration': '1 week', 'tasks': [ 'Setup new project structure', 'Install dependencies', 'Configure build tools', 'Setup testing framework' ] }, { 'name': 'Core Migration', 'duration': '2-3 weeks', 'tasks': [ 'Migrate utility functions', 'Port components\/modules', 'Update data models', 'Migrate business logic' ] }, { 'name': 'Testing & Refinement', 'duration': '1 week', 'tasks': [ 'Unit testing', 'Integration testing', 'Performance testing', 'Bug fixes' ] } ] else: # Complex migration return [ { 'name': 'Phase 0: Foundation', 'duration': '2 weeks', 'tasks': [ 'Architecture design', 'Proof of concept', 'Tool selection', 'Team training' ] }, { 'name': 'Phase 1: Infrastructure', 'duration': '3 weeks', 'tasks': [ 'Setup build pipeline', 'Configure development environment', 'Implement core abstractions', 'Setup automated testing' ] }, { 'name': 'Phase 2: Incremental Migration', 'duration': '6-8 weeks', 'tasks': [ 'Migrate shared utilities', 'Port feature modules', 'Implement adapters\/bridges', 'Maintain dual runtime' ] }, { 'name': 'Phase 3: Cutover', 'duration': '2 weeks', 'tasks': [ 'Complete remaining migrations', 'Remove legacy code', 'Performance optimization', 'Final testing' ] } ] def _format_plan(self, plan): """Format migration plan as markdown""" output = "# Migration Plan\n\n" # Executive Summary output += "## Executive Summary\n\n" output += f"- **Total Duration**: {plan['timeline']['total']}\n" output += f"- **Team Size**: {plan['resources']['team_size']}\n" output += f"- **Risk Level**: {plan['timeline']['risk_buffer']}\n\n" # Phases output += "## Migration Phases\n\n" for i, phase in enumerate(plan['phases']): output += f"### {phase['name']}\n" output += f"**Duration**: {phase['duration']}\n\n" output += "**Tasks**:\n" for task in phase['tasks']: output += f"- {task}\n" output += "\n" # Milestones output += "## Key Milestones\n\n" for milestone in plan['milestones']: output += f"- **{milestone['name']}**: {milestone['criteria']}\n" return output ``` ### 3. Framework Migrations Handle specific framework migrations: **React to Vue Migration** ```javascript class ReactToVueMigrator { migrateComponent(reactComponent) { \/\/ Parse React component const ast = parseReactComponent(reactComponent); \/\/ Extract component structure const componentInfo = { name: this.extractComponentName(ast), props: this.extractProps(ast), state: this.extractState(ast), methods: this.extractMethods(ast), lifecycle: this.extractLifecycle(ast), render: this.extractRender(ast) }; \/\/ Generate Vue component return this.generateVueComponent(componentInfo); } generateVueComponent(info) { return `