diagnosing-bugs
Diagnosing Bugs
Uma disciplina para bugs difíceis. Pule fases só quando explicitamente justificado.
Ao explorar a codebase, leia CONTEXT.md (se existir) para ter um modelo mental claro dos módulos relevantes, e verifique ADRs na área que você está tocando.
Redija
Esta skill faz você mostrar comandos, outputs e artefatos capturados. Redija todo secret primeiro — escreva <REDACTED> no lugar. Construa loops contra env vars, para a credencial ficar no ambiente em vez de no que você mostra. Artefatos capturados carregam auth headers: cite apenas as linhas que carregam o sinal.
Se o output redigido não bastar para diagnosticar o bug, diga isso e pergunte ao usuário.
Fase 1 — Construa um feedback loop
Esta é a skill. Todo o resto é mecânico. Se você tiver um sinal apertado de pass/fail para o bug — um que fica vermelho neste bug específico — você vai encontrar a causa; bisection, teste de hipóteses e instrumentação só consomem ele. Se não tiver, nenhuma quantidade de olhar código vai salvar você.
Dedique esforço desproporcional aqui. Seja agressivo. Seja criativo. Recuse desistir.