git:20260524.d8573f8 to git:20260528.55901d2
15 added, 1 removed. Audit A to A.
---
name: migration-refactor-specialist
description: |
Skill para migracoes, modernizacao de legacy e refactors estruturais. Use quando precisar fazer upgrades grandes,
extracao incremental, strangler pattern, compatibilidade de transicao e rollout seguro.
- Trigger em: "migracao de framework", "modernizacao de legacy", "strangler pattern", "refactor estrutural", "upgrade grande", "extracao incremental", "migracao de runtime", "trocar ORM", "rollout incremental de refactor", "migrar para".
+ Trigger em: "migracao de framework", "modernizacao de legacy", "strangler pattern", "refactor estrutural", "upgrade grande", "extracao incremental", "migracao de runtime", "trocar ORM", "rollout incremental de refactor", "migrar para",
+ "spring boot 3", "spring boot 2 para 3", "jakarta migration", "javax para jakarta", "openrewrite", "upgrade spring boot",
+ "migrar jdk 21", "jdk 21 upgrade", "java 21 migration", "spring boot upgrade", "spring 3 migration".
---
# Migration Refactor Specialist
O Migration Refactor Specialist reduz risco em mudancas grandes que nao cabem no fluxo comum de feature ou bugfix.
## Governanca Global
Esta skill segue `GLOBAL.md`, `policies/execution.md`, `policies/handoffs.md`, `policies/quality-gates.md`, `policies/token-efficiency.md`, `policies/tool-safety.md`, `policies/stack-flexibility.md` e `policies/evals.md`.
## Quando Usar
- migracoes de framework, runtime, auth, storage ou arquitetura
- refactors grandes com rollout incremental
- modernizacao de sistema legado com risco elevado
## Quando Nao Usar
- para pequenos refactors locais
- para upgrades mecanicos de baixa complexidade
## Entradas Esperadas
- estado atual do sistema
- objetivo da migracao ou refactor
- riscos, dependencias e restricoes de rollout
## Saidas Esperadas
- plano incremental de migracao/refactor
- fases, compatibilidades e rollback
- handoff claro para Orchestrator, Backend, Frontend, QA e Deploy
## Checklist Base
- estado atual e alvo definidos
- estrategia de compatibilidade temporaria explicita
- rollback e criterio de corte documentados
- validacao incremental por fase
- risco operacional e tecnico priorizados
## Evidencia de Conclusao
- plano de transicao definido
- fases e riscos registrados
- criterios de rollout e rollback claros
+
+ ## Playbooks Disponíveis
+
+ Playbooks concretos por stack em `playbooks/`:
+
+ | Playbook | Quando usar |
+ |---|---|
+ | `spring-boot-2-to-3.md` | Spring Boot 2.x → 3.x + JDK 8/11/17 → 21 via OpenRewrite. Inclui 10 passos, rollback, geração de REPORT.md. |
+
+ Referências de suporte em `playbooks/references/`:
+ - `common-fixes.md` — troubleshooting por categoria (javax→jakarta, Hibernate dialects, properties renomeadas, Flyway, Virtual Threads)
+ - `custom-parent-strategy.md` — projetos com parent POM próprio: 3 estratégias (atualizar parent, BOM import, migrar JARs internos)
## Handoff
Seguir `policies/handoffs.md` e, quando util, `templates/migration-plan.md`.
## Integracao com Pipeline
- **skill 38 (Architecture Deepener):** roda **antes** desta skill em modulos candidatos a deepening — esta skill recebe o plano de deepening (modulos, interfaces propostas, deletion-test passing) e executa o refactor incremental com feature flags. Skill 38 propoe; esta skill executa.
- **skill 37 (TDD Engineer):** roda **junto** quando o refactor afeta comportamento testavel — TDD garante que comportamento nao muda durante a migracao (testes verdes antes e depois).
- **skill 11 (Reviewer):** valida o resultado final do refactor antes do merge.