Recapitulação e Prática

Principais aprendizados

• Uma spec é uma anotação de trabalho curta, em linguagem simples — o que você está construindo e o que não está — não é um contrato que você congela; uma página basta.
• Esclareça o problema e a pessoa antes dos recursos, e anote os não-objetivos: eles são sua defesa mais afiada contra uma IA que adiciona extras "úteis".
• Histórias de usuário com uma cláusula "para que" e um PRD minúsculo com uma linha "Done When" concreta transformam intenção em comportamento testável e construível.
• Fixe o modelo de dados cedo — nomes de campos vazam por todo lugar — e fatie a spec em tarefas do tamanho de uma vibe que você consegue verificar uma de cada vez.
• Descreva o problema, não a solução; resultados continuam baratos de mudar numa spec e caros de mudar em código. Mantenha a spec viva conforme você aprende.

Experimente

Pegue qualquer ideia que você vinha guardando e transforme-a numa spec de uma página em uma única sessão de IA. Deixe a IA te entrevistar com cinco perguntas afiadas primeiro, e então escreva — com suas próprias palavras — o problema, o usuário, três histórias de usuário (cada uma com um "para que"), uma lista explícita de não-objetivos, um modelo de dados de seis linhas, e uma linha "Done When" que você conseguiria executar fisicamente. Salve como SPEC.md. O teste de uma boa spec: você conseguiria colá-la num chat novo amanhã e a IA saberia exatamente o que construir.

Prompt do capítulo

I have a rough idea: <one-line description>.

Act as my product thinking partner. First, ask me 5 sharp questions,
one at a time, to clarify the problem, the target user, and what "done"
looks like. Don't propose features yet.

After I answer, draft a one-page spec with these sections:
- Problem  - User  - Goal
- In Scope (v1)  - Non-Goals (v1)
- User stories (each "As a __, I want __, so that __")
- Data model (a short list of fields)
- Done When (a concrete, physically-performable acceptance test)

Keep it tight — under one page. If something is ambiguous, ask before
assuming. I'll edit the draft until I agree with every line.