# Falhas na geração por IA

### 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).

{% hint style="info" %}
Se existir um `requestId`, `traceId` ou link de execução, inclua também.
{% endhint %}