🌱 O prompt mínimo viável
O menor que funciona. Antes de escrever qualquer regra, você escreve o núcleo irredutível — só identidade e um contrato —
e define um teste concreto que prova que ele funciona. Este é o prompt-v0: o ponto de partida do seu laboratório.
Conteúdo detalhado
Por que começar mínimo
O impulso de todo iniciante é o mesmo: abrir um arquivo em branco e despejar todas as regras de uma vez — formato, tom, segurança, casos especiais, tudo antes de ter rodado uma única vez. Esse impulso é o inimigo número um de um prompt robusto. A Trilha inteira gira em torno de resistir a ele.
🧭 O princípio
Os melhores system prompts de 2026 não são os mais longos — são os mais consolidados e justificados. Eles chegaram a um estado enxuto depois de crescer e podar, não antes. Você não consegue podar o que ainda não existe. Por isso começamos pelo menor núcleo possível e deixamos o prompt revelar do que realmente precisa — guiado por testes que falham, não por suposições.
- •Cada regra que você escreve "por garantia" é uma regra que ninguém testou.
- •Um prompt curto é fácil de ler, fácil de depurar e fácil de explicar.
- •O comportamento que você não conseguir provar com um teste, você não controla.
Robusto porque é simples, não apesar disso
Um prompt enxuto tem menos superfície para conflitos internos, menos regras que se contradizem e menos linhas competindo pela atenção do modelo. A simplicidade não é um meio-termo — é a fonte da robustez.
Identidade + 1 contrato — o núcleo irredutível
O núcleo mínimo tem exatamente duas partes: quem o agente é (identidade) e o que ele se compromete a fazer (um contrato). Tudo o mais — formato, recusas, edge cases — é opcional no v0. Se você remover qualquer uma dessas duas partes, o agente deixa de fazer sentido. Isso é "irredutível".
🪪 Identidade
Uma frase: quem é e, quando útil, em que contexto opera. É a âncora que impede o modelo de derivar de persona.
You are a triage assistant for a support inbox.
📄 1 contrato
Uma promessa de comportamento observável: o que ele entrega, em que formato, com qual garantia. Um contrato, não cinco.
For each message, output exactly one label: urgent, normal, or spam.
O que faz de algo um "contrato"
Um contrato é uma afirmação que pode ser verificada: "saída tem exatamente um rótulo dentre três". Compare com uma regra vaga ("seja útil e responsável") — essa não dá para testar, então não é um contrato, é decoração. A regra prática: se você não consegue escrever um teste que falha quando o contrato é quebrado, o contrato ainda não está bem definido.
O perigo da antecipação
Antecipar é escrever uma regra para um problema que ainda não aconteceu. Parece prudência, mas é dívida: cada regra antecipada é uma regra sem teste, sem contexto real, e muitas vezes errada — porque você adivinhou o problema em vez de observá-lo.
✓ Reagir a um problema real
- •Rodou, falhou, viu a falha → escreve a regra
- •Cada regra nasce com um teste que a justifica
- •O prompt cresce na direção dos problemas que existem
- •Você sempre sabe por que cada linha está lá
✗ Antecipar um problema imaginário
- •"Melhor já avisar pra nunca usar emoji" — antes de ver um
- •Regras sem teste acumulam e se contradizem
- •O prompt incha em torno de medos, não de fatos
- •Ninguém lembra por que metade das linhas existe
⚠️ O sintoma do prompt antecipado
Você abre um prompt e encontra regras para casos que o produto nunca viu, proibições de coisas que o modelo nunca tentou fazer, e instruções que ninguém consegue explicar. Esse é o prompt inchado — e ele será o vilão da Trilha. O antídoto começa aqui: nasça mínimo.
Definir "funciona" — um teste concreto antes de escrever mais
"Funciona" não é um sentimento. Antes de adicionar a próxima linha ao prompt, você precisa de um critério concreto que diga, sem ambiguidade, se o v0 cumpre o contrato. Esse critério é o seu primeiro teste — e ele vem antes de qualquer regra extra.
Do contrato ao teste, em 3 passos
Pegue o contrato e torne-o observável
Contrato: "saída é exatamente um rótulo dentre três". Observável: dada uma entrada, a saída precisa ser urgent, normal ou spam — nada mais.
Escolha 1 caso concreto com resposta esperada
Entrada: "Servidor caiu, clientes sem acesso agora!" → esperado: urgent. Um caso real e inequívoco basta para o v0.
Defina passa/falha sem subjetividade
Passa se a saída for exatamente urgent. Qualquer explicação extra, rótulo fora da lista ou texto adicional = falha. Critério binário, não "ficou bom".
O teste é a definição de pronto
Enquanto o teste passa, o v0 está pronto — você não toca nele. Você só volta a editar o prompt quando um novo teste falha. É assim que o crescimento fica honesto (Módulo 4.2).
Exemplo guiado: o MVP de um agente simples
Vamos montar um prompt-v0 de ponta a ponta para o nosso agente de triagem de inbox.
Repare como ele tem só identidade + 1 contrato — nenhuma regra de formato extra, nenhuma recusa antecipada. É o menor que funciona.
You are a triage assistant for a support inbox.
Contract:
For each incoming message, output exactly one label on a single line —
one of: urgent | normal | spam. Output nothing else.Por que isto é um bom v0
- •Identidade clara: uma frase ancora a persona e o domínio.
- •Um contrato verificável: "exatamente um rótulo, nada mais" — testável de imediato.
- •Zero antecipação: nada sobre tom, emoji, idioma ou casos raros — eles entram só se um teste pedir.
INPUT: "Servidor caiu, clientes sem acesso agora!"
EXPECTED: urgent
PASS IF: output == "urgent" (exato, sem texto adicional)Rode antes de melhorar
Cole o prompt-v0 num playground, rode o test-01. Passou? Pare. Resista a "dar uma melhoradinha". Falhou? Agora você tem um problema real para corrigir — e é exatamente disso que trata o Módulo 4.2.
Entregável: prompt-v0 + 1 teste
O resultado deste módulo é o ponto de partida do seu laboratório: dois arquivos pequenos, versionados em git, que serão a primeira entrada do seu "repo de evolução". Tudo que vier nas próximas aulas será um diff sobre isto.
📦 O que entregar
git commit -m "prompt-v0: triagem de inbox + test-01"✓ Entregável bom
- •Cabe na tela — você lê o prompt inteiro de uma vez
- •O teste passa quando você roda
- •Você consegue explicar cada linha em uma frase
✗ Sinais de que você antecipou
- •Já tem regras de tom/idioma/emoji no v0
- •Mais de um contrato disputando atenção
- •Nenhum teste — só "achei que estava bom"
📌 Resumo do Módulo
prompt-v0 + 1 teste, commitados: o ponto de partida do laboratório.Próximo: Módulo 4.2
Evolução por diff e rodadas de consolidação — crescer por necessidade real (não por antecipação) e consolidar antes de inchar.