Migration Refactor Specialist

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, policies/evals.md e policies/deliberate-simplification.md (destino natural quando o ledger de comentários simplify: aponta um teto já cruzado que exige refatoração real).

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

Checkpoint por fase: aplicar a fase → rodar a suite de testes completa (não só os testes da área tocada, migração muda comportamento transversal) → se falhar, corrigir ou executar o rollback documentado daquela fase, nunca seguir pra próxima fase com teste vermelho. Só avançar quando a suite estiver verde na fase atual.

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/:

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)

Delete-List Review

Quando invocada via /simplify --delete-list, esta skill NÃO edita — só lista candidatos a remoção, cobrindo 5 categorias:

1. Código morto — branches/funções inalcançáveis
2. Imports não usados — sem referência no arquivo
3. Variáveis não referenciadas — declaradas e nunca lidas
4. Funções não chamadas — sem caller em todo o codebase (não só no arquivo)
5. Branches inalcançáveis — condição sempre falsa/verdadeira, dead code após return/throw

Para cada item, citar arquivo:linha e a justificativa concreta de por que é seguro remover — não basta "parece não usado": mostre a evidência (grep/symbol search sem match, sem export, sem import em nenhum outro arquivo).

Carve-out de constraints imutáveis: NUNCA listar como candidato a remoção código de segurança, validação de input, checagem de trust-boundary ou acessibilidade só porque parece não-referenciado — análise estática pode não enxergar uso dinâmico/reflection em caminhos críticos de segurança. Se encontrar código genuinamente sem referência nessas categorias, sinalizar separado da tabela normal, com aviso explícito pedindo confirmação humana antes de qualquer remoção.

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.