Programação & Web
Qualquer IA
A IA te Entrevista Antes de Codar: Gere uma SPEC.md Sem Ambiguidade
A IA te entrevista em lotes de perguntas, força você a escolher interpretações e grava uma spec com critérios de aceite testáveis — para outra sessão executar.
0cópias
0joinhas
0favoritos
O prompt
Atue como um Engenheiro de Requisitos Sênior. Eu quero construir: {{descricao_da_ideia}}.
Antes de escrever QUALQUER código, me entreviste:
1. Faça perguntas em lotes de 3 a 5, começando pelas de maior impacto na arquitetura (stack, integrações, volume de dados, quem usa).
2. Pule o que for óbvio e nunca repita algo que eu já respondi.
3. Para cada resposta minha vaga, proponha 2-3 interpretações e me force a escolher uma.
4. Cubra: comportamento esperado, casos de borda, estados de erro e vazios, permissões, e o que está explicitamente FORA de escopo.
Quando tudo estiver coberto, escreva o arquivo SPEC.md com:
- Objetivo e métrica de sucesso
- Solução proposta e arquivos/interfaces envolvidos
- Critérios de aceite testáveis no formato Dado/Quando/Então
- Casos de borda e erros tratados
- Fora de escopo (explícito)
- Um passo final de verificação ponta a ponta
Não implemente nada nesta sessão — a spec será executada depois por outra sessão/IA com contexto limpo.
Como usar
- Substitua {{descricao_da_ideia}} pela feature em 1-2 frases (ex.: 'checkout com Pix no meu SaaS de agendamento').
- Responda às entrevistas por lote; sempre que a IA apontar interpretações vagas, escolha uma — é aí que a spec fica à prova de ambiguidade.
- Revise o SPEC.md gerado: os critérios Dado/Quando/Então devem ser verificáveis por alguém que não participou da conversa.
- Abra uma sessão NOVA (contexto limpo) e cole a spec como tarefa — é assim que agentes como Claude Code/Cursor executam sem 'esquecer' decisões do meio do caminho.
- Padrão documentado pela Anthropic: separar planejamento de implementação evita resolver o problema errado.
Exemplo de saída
SPEC.md para 'checkout com Pix': objetivo ('reduzir abandono no pagamento'), 6 critérios Dado/Quando/Então (ex.: 'Dado um pedido expirado, Quando o webhook do Pix chegar, Então o sistema reembolsa e notifica'), 4 casos de borda (QR expirado, pagamento duplicado), fora de escopo ('cartão de crédito fica para v2') e verificação ponta a ponta listando os 5 arquivos tocados.