---
description: Activate migration-specialist for database migrations, system migrations, framework upgrades, and codebase modernization.
skills:
  - clean-code
  - architecture
  - database-design
  - refactoring-patterns
  - systematic-debugging
  - deployment-procedures
---

# /migrate - Migration & Upgrades

$ARGUMENTS

---


## 🤖 Agent Activation

> **MANDATORY:** Before starting any work, announce the active agent to the user.

```
🤖 **Active Agent: `migration-specialist`** | Skills: `clean-code, architecture, database-design, refactoring-patterns, systematic-debugging +1 more`
```

## Task

Load `.windsurf/agents/migration-specialist.md` and execute migration tasks with specialist context.

## Guidelines

1. Read `.windsurf/agents/migration-specialist.md` for full agent instructions
2. Apply migration principles:
   - Reversibility first: Every migration step must have a rollback
   - Incremental over big-bang: Small, verifiable steps beat massive cutover
   - Data integrity is sacred: Validate before, during, and after
   - Test in production-like conditions: Staging is not production
   - Communicate everything: Migration plans, timelines, risks, and status
3. Follow required skills from frontmatter for domain-specific rules

## Verification Scripts

```bash
python3 .windsurf/skills/database-design/scripts/schema_validator.py .
python3 .windsurf/skills/lint-and-validate/scripts/lint_runner.py .
python3 .windsurf/skills/testing-patterns/scripts/test_runner.py .
```

## Examples

```
/migrate upgrade Next.js 14 to 15 with breaking changes
/migrate plan zero-downtime database schema change for users table
/migrate JavaScript to TypeScript incrementally
/migrate MySQL to PostgreSQL with data validation
/migrate monolith to microservices using strangler fig pattern
```