WorkflowEngenhariarefatoracao

Planejamento de Refatoração e Arquitetura Alvo

Sair de um diagnóstico completo e chegar a um plano estruturado de modernização e refatoração, construído com base numa arquitetura alvo clara, caminho incremental viável fatiado e critérios protetivos definidos.

5 etapas sequenciais
Ações
Baixar pacote
AudiênciaDev, Líder
NívelSenior
Estágioplanning
Duração30-90min
Aplicação

Quando
faz sentido.

Usar
  • Após finalizar o Workflow "Diagnóstico de Dívida Técnica Crítica" ou possuir diagnóstico equivalente profundo e embasado.
  • Antes da equipe técnica de "mão na massa" abrir PRs monólitos ou começar a alterar centenas de arquivos sem rastreio holístico e de segurança de impacto de branch principal.
Não usar
  • Em manutenções rasas sem ramificações intensas e desdobramentos lógicos interligados (modificar o linter de um file ou padronizar tipagens sem troca estrutural real).
Setup

Pré
requisitos.

  • 01[ ] Resultados do Diagnóstico com Hotspots e Riscos claros levantados em mãos.
  • 02[ ] Escolha em alto-nível (ou a definir logo nas primeiras etapas com alinhamento corporativo) sobre a estética e preceitos modernos da arquitetura (Ports and Adapters? Vertical Slice?).
Sequência

Caminho
crítico.

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

  1. 01

    Desenho de Arquitetura Alvo

    Obter a resposta conceitual da infraestrutura ideal das classes/diretórios que sanará o débito visto no Módulo avaliado.

    Skilldesign-refactor-target-architecture·Saída- Documento de Design Architecture Target com regras de convivência macro.
  2. 02

    Gap Analysis

    Cruzar O que Existe x O que Deve Existir estabelecendo formalmente as "diferenças" entre as pontes de dependências.

    Skilldependency-mapping-and-decomposition·Saída- Gap list de migração.
  3. 03

    Fatiamento das Fases ("Slicing")

    Transformar as gaps em unidades atômicas sequenciais (As Tarefas Lógicas ou PRs Mestre).

    Skillrefactor-slicing-and-pr-planning·Saída- Árvore do Roteiro Faseado rascunhada.
  4. 04

    Assentamento das Validações e Guardrails

    Estipular rigorosamente de que forma testaremos ou mediremos cada um dos "nós" e PRs atômicos mapeados no Passo 3 sem que o ambiente perca a resiliência original para Invariantes do negócio.

    Skillrisk-register-and-guardrails·Saída- Roteiro acrescido de aceites de aceitação pesada e Guardrails vinculados em fatias.
  5. 05

    Formalização da Esteira do Planejamento

    Aglutinar as tarefas finalizadas num Roadmap Master ou Backlog para o esquadrão/Dev assumir nos tickets ou Sprints.

    Skillrefactor-slicing-and-pr-planning·Saída- Roadmap Blueprint Executável e Definitivo.
Componentes

Skills
incluídas.

Constelação

Onde
ele vive.

Execução

Como usar
com IA.

  1. 01Copie o prompt abaixo (ou use o botão no topo).
  2. 02Abra o Claude ou Claude Code no diretório do projeto.
  3. 03Cole o prompt e siga a ordem das etapas. O agente conduz cada skill em sequência.
prompt.txt
> Execute o workflow 'Planejamento de Refatoração e Arquitetura Alvo' seguindo a ordem crítica das etapas. Para cada etapa, carregue a skill correspondente e siga suas instruções. Pergunte se faltar contexto.
Baixar pacote