WorkflowEngenhariarefatoracao

Diagnóstico de Dívida Técnica Crítica

Transformar um cenário ambíguo de "sabemos que a base de código está ruim" em um mapa concreto de problemas, riscos e hotspots, resultando em um diagnóstico técnico consolidado e priorizado em que ficar claro o que é intocável no curto prazo.

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

Quando
faz sentido.

Usar
  • Quando houver consenso de que o projeto tem muita dívida técnica, mas não há um plano ou ponto de partida evidente.
  • Para obter justificativas substanciais antes de pedir recursos ou interrupção de ciclo aos stakeholders ou C-Levels para sanar dívidas.
  • Ao assumir a governança do repositório de um legado crítico deixado por ex-parceiros.
Não usar
  • Para mudanças focadas em 1 a 2 componentes internos com clareza de restrição já declarada — use skills individuais isoladas (ex: dependências).
  • Refatorações utilitárias cosméticas simples e de linting de baixo esforço.
Setup

Pré
requisitos.

  • 01[ ] Definição do sistema, módulo central ou repositório a investigar.
  • 02[ ] Conhecimento geral do negócio e como acessá-lo.
  • 03[ ] Acesso local de leitura garantido na base de código em uma branch atualizada.
Sequência

Caminho
crítico.

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

  1. 01

    Coleta de Contexto de Produto e Negócio

    Obter a justificativa exata, SLA e o peso operacional da dívida perante dores de stakeholders.

    Skillcoleta-de-contexto-de-negocio-e-modulo·Saída- Ficha de contexto de negócio.
  2. 02

    Inventário e Mapeamento de Dependências

    Elaborar o mapa de quem depende de que na base, expondo ligações circulares ou acoplamentos profundos.

    Skilldependency-mapping-and-decomposition·Saída- Mapa consolidado de acoplamento do Módulo.
  3. 03

    Auditoria e Busca de Hotspots (Complexidade)

    Extrair o grau em métricas finas ou estáticas contundentes (ciclomática, God Classes, tamanho excessivo) e revelar onde o acoplamento do passo 2 encontra alta complexidade (Hotspot).

    Skillcyclomatic-complexity-audit·Saída- Top-ranking documentado de Hotspots e Métricas isoladas.
  4. 04

    Registro de Invariantes e Riscos

    Criar um diário de riscos do negócio e demarcar barreiras de "o que NÃO QUEBRAR" para compor a segurança da transição.

    Skillrisk-register-and-guardrails·Saída- Documento Registro de Riscos.
  5. 05

    Síntese Crítica e Consolidado Priorizado

    Transformar todo volume bruto num output priorizado e executável macro.

    Skilldiagnostico-sintese-e-priorizacao·Saída- Sumário Executivo de Diagnóstico completo ranqueado.
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 'Diagnóstico de Dívida Técnica Crítica' seguindo a ordem crítica das etapas. Para cada etapa, carregue a skill correspondente e siga suas instruções. Pergunte se faltar contexto.