마이그레이션 가이드

코딩고급

React 18→19, Next.js 14→15 등 메이저 버전 업그레이드나 프레임워크 전환 시, 변경사항을 분석하고 단계별 마이그레이션 계획과 코드 수정을 안내합니다.

트리거/migrate

사용빈도분기 1회

레거시 프로젝트 담당 개발자라면? /migrate react 19로 업그레이드 시 브레이킹 체인지 자동 탐지

CTO라면? 기술 스택 전환의 영향 범위를 빠르게 파악

마이그레이션업그레이드호환성레거시

작동 흐름

/migrate [from → to] 실행

↓

Phase 1: 3개 분석 병렬

breaking-scan

브레이킹 체인지 탐색

dep-check

의존성 호환성 확인

code-impact

코드 영향 범위 분석

↓

단계별 마이그레이션 계획 수립

↓

✓ 마이그레이션 계획 + 자동 코드 수정

스킬 코드

# Migration Guide Skill
## Trigger: /migrate [framework/library] [from version] [to version]

When invoked:

1. Identify breaking changes:
 - Read official migration guide / changelog
 - Scan codebase for affected patterns
 - List deprecated APIs in use

2. Analyze impact:
 - Files affected (count + list)
 - Dependencies that need updating
 - Test coverage of affected areas

3. Generate step-by-step plan:
---
## 🔄 Migration: [lib] v[X] → v[Y]

### Impact Summary
- Files affected: [N]
- Breaking changes: [N]
- Estimated effort: [hours/days]

### Pre-migration Checklist
- [ ] Ensure all tests pass on current version
- [ ] Create migration branch
- [ ] Backup database (if applicable)

### Step-by-Step Plan
1. **Update dependencies**
 `npm install [package]@[version]`

2. **Fix breaking change: [name]**
 - Before: `[old code]`
 - After: `[new code]`
 - Files: [list]

3. [Continue for each breaking change]

### Post-migration
- [ ] Run full test suite
- [ ] Verify build passes
- [ ] Test critical user flows
---

복사해서 CLAUDE.md에 붙여넣으면 바로 사용할 수 있습니다.