Debugar com IA: como descrever um bug para a IA resolver de verdade

Por que a maioria dos prompts sobre bugs falha

O framework de 4 pilares para descrever bugs

1. Stack técnico

2. Stack trace ou logs

3. Comportamento esperado vs. real

4. Passos para reproduzir

Exemplo prático: prompt ruim vs. prompt bom

Prompt ruim

Olá, meu array não está filtrando certo. Como faço para corrigir?

Prompt bom

Estou usando JavaScript puro (Node.js 18). Tenho um array de objetos de usuários e estou tentando filtrar apenas os ativos com .filter(). O problema é que o método está retornando 3 usuários quando deveria retornar 2. Aqui está o código:

const users = [
  { id: 1, name: 'Ana', active: true },
  { id: 2, name: 'Bruno', active: false },
  { id: 3, name: 'Carlos', active: true }
];

const activeUsers = users.filter(user => user.active);
console.log(activeUsers);
// Resultado atual: [{ id: 1, ... }, { id: 2, ... }, { id: 3, ... }]
// Resultado esperado: [{ id: 1, ... }, { id: 3, ... }]

Comparação de outputs reais

Você pode usar .filter() para filtrar arrays. Aqui está um exemplo básico: array.filter(item => item.active).

Olhando para seu código, o .filter() está correto sintaticamente. O problema é que todos os três usuários estão retornando. Verificando sua lógica, o valor de active pode estar sendo interpretado como a string 'false' em vez de booleano. Teste console.log(typeof users[1].active) para confirmar. Se for string, use users.filter(user => user.active === true) ou garanta que active seja sempre booleano na origem dos dados.

Dicas para respostas ainda melhores

• Inclua mensagens de erro exatas: copie e cole o stack trace completo, não resuma ou parafraseie.

• Especifique versões de dependências: a IA responde de forma diferente para React 18 e React 19, por exemplo.

• Mostre tentativas anteriores: "tentei usar .find() em vez de .filter(), mas também não funcionou" ajuda a IA a descartar soluções óbvias.

• Adicione contexto de negócio quando relevante: "preciso filtrar usuários ativos para exibir em um dashboard em tempo real" pode mudar a abordagem recomendada.

Recursos para aprofundar

• Documentação oficial do MDN sobre Array.filter(): referência completa de métodos de array em JavaScript.

• Guia da Mozilla sobre comunicação de bugs: boas práticas para escrever bug reports claros e úteis.

• Guia de prompt engineering da OpenAI: documentação oficial sobre como estruturar prompts de forma eficiente.

Quer dominar Engenharia de Prompt?