WorkflowProgramaçãorefatoracao

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).

7 etapas sequenciais
Ações
Baixar pacote
AudiênciaDev, Tech Lead
NívelSenior
Estágioexecution
DuraçãoMutável
Aplicação

Quando
faz sentido.

Usar
  • 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.
Não usar
  • Em sprints ordinários de features rasas (neste caso, a review normal unicamente basta).
Setup

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.
Sequência

Caminho
crítico.

As etapas devem ser executadas em ordem. Cada uma carrega uma skill específica.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
Componentes

Skills
incluídas.

Constelação

Onde
ele vive.

Execução

Como usar
com IA.

  1. 01Baixe o pacote (botão abaixo): o .zip traz este workflow e todas as skills que ele usa, em arquivos .md. Só copiar o prompt não basta — os arquivos são as instruções reais.
  2. 02Entregue os arquivos à IA: no Claude Code, descompacte o .zip na pasta do projeto (ou em .claude/skills/); no Claude (claude.ai), anexe os arquivos .md à conversa.
  3. 03Cole o prompt abaixo para iniciar — a IA segue a ordem das etapas usando os arquivos fornecidos.
prompt.txt
> Execute o workflow 'Execução Guiada de Refatoração' a partir dos arquivos que forneci (o WORKFLOW.md e as skills .md do pacote). Siga a ordem crítica das etapas; em cada uma, carregue a skill correspondente e siga as instruções dela. Pergunte se faltar contexto.
Baixar pacote