SkillEngenhariaDiagnostica

Instrumenting Debug Probes

Adiciona probes temporários e direcionados para distinguir hipóteses de causa raiz.

Em:Systematic Bug Investigation
Ações
PerfilDev
ProfundidadeAlta
Idiomapt-BR
Objetivo

Em uma frase.

Coletar evidência precisa para confirmar ou derrubar hipóteses de causa raiz, sem transformar o codebase em ruído de logs ou alterar comportamento de produção inadvertidamente.

Aplicação

Quando
faz sentido.

Usar
  • Quando a reprodução existe, mas a causa ainda está entre múltiplas camadas.
  • Quando o erro aparece longe da origem do dado inválido.
  • Quando a falha atravessa API, serviço, banco, fila, cache ou UI.
  • Em regressões de performance que exigem medição objetiva.
Prompt

Instruções
para a IA.

Passo 1 - Mapear a fronteira que separa as hipóteses

Identifique o menor ponto onde a hipótese faz uma previsão diferente das alternativas: entrada de função, payload antes de persistir, query gerada, resposta de API, estado de cache, tempo de execução ou output renderizado.

### Passo 2 - Escolher o tipo de probe

Use a opção menos invasiva:

- Debugger ou inspeção interativa quando disponível.

- Log temporário com prefixo único. - Medição de tempo ou perfil para performance. - Query plan ou métrica de banco para gargalos. - Snapshot de payload antes/depois em fronteiras. - Assert temporário em harness local.

Passo 3 - Marcar para remoção

Todo log temporário deve ter prefixo único, por exemplo `[DEBUG-gzero-20260505]`. Registre o prefixo para busca posterior.

### Passo 4 - Rodar e interpretar

Execute o loop uma vez por probe. Registre:

- Valor observado.

- Previsão esperada. - Hipótese confirmada, enfraquecida ou descartada. - Próximo experimento se necessário.
Constelação

Onde
ela vive.

Workflows que usam
Bundles que incluem