SkillEngenhariaDiagnostica

Building Debug Feedback Loop

Constrói um sinal rápido, repetível e verificável antes de investigar ou corrigir um bug.

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

Em uma frase.

Criar um mecanismo confiável para observar o bug antes de qualquer tentativa de correção. O loop deve dizer, com baixo ruído, se o problema ainda existe ou se desapareceu.

Aplicação

Quando
faz sentido.

Usar
  • Ao receber uma descrição de bug sem reprodução automatizada.
  • Quando uma falha aparece apenas em CI, produção, browser específico ou ambiente local de outro usuário.
  • Antes de editar código em uma investigação que ainda depende de suposição.
  • Em regressões de performance onde é preciso medir tempo, consumo ou volume antes de otimizar.
Prompt

Instruções
para a IA.

Passo 1 - Definir o sinal de falha

Descreva o bug como uma condição observável: erro lançado, valor incorreto, tela quebrada, latência acima do limite, request falhando, estado inválido ou divergência de output.

Evite sinais vagos como "parece ruim" ou "não funciona". O loop precisa produzir `pass` ou `fail`.

### Passo 2 - Escolher a menor superfície executável

Priorize, nesta ordem:

1. Teste automatizado no menor nível que ainda reproduz o comportamento real.

2. Script HTTP, CLI ou fixture executável. 3. Teste de integração contra serviço local. 4. Teste E2E com Playwright/Cypress para bugs de interface. 5. Replay de trace, payload, HAR, evento ou log capturado. 6. Harness temporário quando o sistema não oferece entrada direta.

Passo 3 - Tornar o loop determinístico

Controle variáveis que causam ruído:

- Dados de entrada fixos.

- Tempo congelado ou tolerância explícita. - Seeds para aleatoriedade. - Banco/fixtures isolados. - Mocks apenas em fronteiras externas inevitáveis. - Rede e feature flags documentadas.

### Passo 4 - Medir velocidade e nitidez

Um loop de 2 segundos que falha pelo motivo certo vale mais do que uma suíte inteira de 10 minutos. Se o loop for lento, reduza setup, escopo ou asserts até chegar ao menor sinal que ainda representa o bug.
Constelação

Onde
ela vive.

Workflows que usam
Bundles que incluem