Execução Guiada de Refatoração
Rodar com maestria ciclos contínuos de desenvolvimento fatiado que executam PRs atômicos de refatoração assegurando correções de dívida validadas pelas métricas rigorosas de revisão sob extremo monitoramento produtivo sem quebrar ambiente central (Trunk ou Staging).
Quando
faz sentido.
- Constantemente durante o desenvolvimento dos PRs estabelecidos na Árvore de Gap do Planejamento Anterior.
- Em refatorações extensas onde uma equipe cria códigos em série buscando convergir módulos do negócio na nova Arquitetura alvo e não abrem mão de uma triagem impiedosa.
- Em sprints ordinários de features rasas (neste caso, a review normal unicamente basta).
Pré
requisitos.
- 01[ ] Diagnóstico Crítico (A) e Roadmap de Planejamento Atômico de PRs (B) bem estabelecidos na mesa.
- 02[ ] O primeiro PR do bloco da reestruturação desenvolvido como alvo a ser consolidado.
Caminho
crítico.
As etapas devem ser executadas em ordem. Cada uma carrega uma skill específica.
- 01
Entendimento do Escopo do PR de Refatoração
Delimitar exatamente o que o PR refatora, quais contratos toca e quais guardrails do roadmap precisam ser preservados antes da revisão profunda.
Skillunderstanding-pr-scope·Saída- Escopo do PR documentado por módulo, contrato, fluxo de negócio e guardrail aplicável. - Lista de arquivos ou áreas que exigem revisão mais severa nas etapas seguintes. - 02
Revisão de Lógica e Corretude
Verificar se o bloco refatorado preserva comportamento, invariantes e contratos funcionais sem introduzir regressões sutis.
Skillreviewing-logic-and-correctness·Saída- Lista de problemas de lógica/corretude com localização, impacto e severidade. - Confirmação explícita quando nenhum problema de corretude for encontrado. - 03
Revisão de Segurança
Detectar se a refatoração alterou fronteiras de entrada, autorização, exposição de dados, logs sensíveis ou dependências de forma insegura.
Skillreviewing-security·Saída- Achados de segurança classificados por severidade. - Lista de riscos aceitos explicitamente quando não forem bloqueantes. - 04
Revisão de Performance
Verificar se a refatoração preserva ou melhora características de performance nos caminhos críticos afetados.
Skillreviewing-performance·Saída- Lista de regressões ou riscos de performance com impacto provável. - Recomendações de medição, benchmark ou instrumentação quando a evidência for insuficiente. - 05
Revisão de Cobertura de Testes
Garantir que os guardrails do PR cobrem os comportamentos preservados, os edge cases da refatoração e os riscos encontrados nas etapas anteriores.
Skillreviewing-test-coverage·Saída- Lista de gaps de cobertura e testes frágeis. - Sugestões de testes de regressão necessários antes de merge. - 06
Encerramento Rígido com Structured Feedback
Consolidar os achados técnicos em decisão clara de bloqueio, correção ou aprovação condicionada.
Skillwriting-structured-feedback·Saída- Documento de feedback estruturado do PR. - Decisão explícita: bloquear, aprovar com correções pequenas ou liberar para rollout. - 07
Rollout, Canary Switches & Encerramentos
Orquestrar o Deploy do PR validado no sistema observacional com proteção e tracking contra a versão mestre paralela anterior.
Skillrefactor-rollout-and-monitoring·Saída- Módulo aposentado e módulo fresco limpo assumindo integralmente a resposta em produção pós canary/toggle.
Onde
ele vive.
Como usar
com IA.
- 01Copie o prompt abaixo (ou use o botão no topo).
- 02Abra o Claude ou Claude Code no diretório do projeto.
- 03Cole o prompt e siga a ordem das etapas. O agente conduz cada skill em sequência.
> Execute o workflow 'Execução Guiada de Refatoração' seguindo a ordem crítica das etapas. Para cada etapa, carregue a skill correspondente e siga suas instruções. Pergunte se faltar contexto.