migration-refactor-specialist

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", "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".

Quality

56%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/23-migration-refactor-specialist/SKILL.md

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.

Repository: felvieira/claude-skills-fv
Commit: 9e5d744

Last updated: 12 days ago
Created: 12 days ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.