Falhas na geração por IA

Quando a geração não inicia, trava, ou entrega resultado inconsistente.

Quando usar

• A geração não começa após enviar o prompt.
• A geração fica “rodando” por muito tempo.
• O resultado vem incompleto ou incoerente com o prompt.

Checklist rápido (2 min)

1. Simplifique o prompt. Faça uma versão mínima.
2. Gere de novo. Evite múltiplos envios em paralelo.
3. Recarregue a página. Tente aba anônima.
4. Desative adblock/extensões de privacidade para o domínio.

Diagnóstico

1) O que você pediu está “executável”?

• O prompt tem objetivo, módulos/entidades, e telas mínimas.
• Evite ambiguidade: “um sistema completo” sem escopo explode custo e tempo.

2) O erro é de rede/UI?

• Abra o Console do navegador.
• Verifique se existe request falhando (401/403/429/5xx).

3) O erro é de capacidade/limite?

• Se houver “rate limit”, aguarde alguns minutos e tente novamente.
• Evite prompts gigantes. Quebre por etapas.

Como resolver (padrões)

• Trava no meio: reduza o escopo e gere em incrementos.
• Especificação ruim: force estrutura com seções e bullets.
• Resultado faltando partes: peça só 1 coisa por vez (“adicione X”, depois “ajuste Y”).

Quando escalar

• O mesmo prompt mínimo falha 3 vezes.
• Erro 5xx repetível.
• A geração conclui, mas o app não roda nem em Preview.

Antes de escalar, junte estas evidências. Isso reduz muito o ping-pong.

• Projeto e ambiente (Dev/Staging/Prod).
• Horário do erro (com timezone).
• Passos para reproduzir (curto e determinístico).
• Mensagem de erro completa (sem prints cortados).
• Screenshot da tela (se aplicável).
• Console do browser (erros e warnings relevantes).
• Aba Network (request que falhou + status + payload, se não houver dados sensíveis).

Se existir um requestId, traceId ou link de execução, inclua também.