Contratos de prompt (Construa com IA Livro 2) kindle

Você digitou um prompt perfeitamente razoável. A IA te deu um código que parecia certo. Você colou, executou, e algo quebrou — não com um erro dramático, mas com a silenciosa imperfeição de uma função que trata apenas o caminho feliz e nada mais. Sem validação de entrada. Sem estados de erro. Autenticação que funciona na demonstração e vaza em produção.

Então você refez o prompt. E refez de novo. E três iterações depois você está depurando código que não escreveu, corrigindo problemas que poderia ter evitado.

O problema não é a IA. O problema é que você está dando a ela um rascunho no guardanapo e esperando plantas arquitetônicas.

Este é um manual de campo de um desenvolvedor solo que envia software de produção com IA todos os dias. Quer dizer produtos reais com usuários reais e faturamento real — não demonstrações de fim de semana que são desligadas na segunda-feira quando o plano gratuito expira.

O framework no centro se chama contrato de prompt — uma especificação estruturada que você escreve antes que uma única linha de código exista. Ele diz à IA exatamente o que construir, como construir, o que não fazer e como você vai verificar o resultado. Dez minutos de escrita. Aproximadamente metade do tempo total por tarefa. Código de primeira tentativa que realmente sobrevive à produção.

Um prompt é "construa uma página de login para mim". Um contrato de prompt é um documento de uma página que especifica o provedor de autenticação, o comportamento de redirecionamento, os estados de erro, o gerenciamento de sessão e as três coisas que nunca devem acontecer. Um produz código de demonstração. O outro produz código de produção.

Aqui dentro você vai encontrar o framework completo de contratos de prompt com templates prontos para copiar e colar, uma análise completa da pilha de tecnologias e um tour profundo do Claude Code que vai muito além do autocomplete, e o loop de verificação: como a IA testa seu próprio código no navegador antes de você receber a entrega. Também tem uma construção completa de SaaS do zero ao primeiro cliente pagante em um fim de semana (já fiz isso, não é mágica, é só método), um capítulo sobre substituir uma assinatura de IA de $200/mês por uma configuração auto-hospedada de $15/mês, cinco padrões de automação que sobrevivem à produção no n8n e Make, e uma visão honesta sobre ferramentas no-code 🙃.

Aliás, sobre esse último ponto — Make.com é bom se sua definição de "produção" é uma alternativa ao Zapier para uso pessoal. No momento em que você precisa de tratamento de erros real, lógica de repetição, ou qualquer coisa que tenha que continuar funcionando às 3 da manhã sem sua supervisão, você vai ter problemas. Enfim. O livro cobre isso.

E depois o jogo real de enviar software solo: esgotamento, expansão de escopo, dinheiro, solidão. Esse capítulo não é técnico. Pode ser o mais útil.

Cada capítulo inclui um código QR linkando para um repositório complementar no GitHub com código executável, fluxos de trabalho importáveis e templates que você pode usar hoje. O repositório é metade do produto — talvez mais da metade, honestamente 💀.

Isso não é um curso de programação e não é documentação. É o que eu gostaria que existisse quando comecei a enviar software solo com IA: opinativo, específico, construído a partir de cicatrizes de produção. Com opiniões que podem fazer você jogar este livro do outro lado da sala — o que significa que provavelmente valem a pena.

Sua IA está esperando por instruções melhores. Dê a ela um contrato.