Mapa da trilha
🧬 Anatomia de um System Prompt
As 6 seções universais
🧱 Padrões Estruturais
O esqueleto em 5 padrões
🗣️ Padrões Comportamentais
Como o modelo age e fala
⚠️ Antipadrões
O que NÃO fazer
📖 Glossário Essencial
Português claro — destrave os termos
Conteúdo detalhado
🧬 Anatomia de um System Prompt
As 6 seções universais que estruturam qualquer system prompt eficaz — da identidade ao contexto dinâmico — dissecadas em prompts reais.
A camada de instrução persistente que define o comportamento do modelo antes de qualquer mensagem do usuário — composta pelo harness com partes estáveis e dinâmicas.
Distinguir system prompt de mensagem do usuário, RAG, contexto de ferramenta e system-reminder é o pré-requisito para ler qualquer prompt sem confundir as camadas.
Prompt estável · mensagens turno a turno · harness · contexto injetado dinâmico.
A âncora do prompt: persona + produto, modelo base e knowledge cutoff, declarados na primeira linha.
Sem âncora o modelo deriva — vira outra persona, inventa capacidades ou fala de eventos além do seu corte como se soubesse.
Persona · modelo base · knowledge cutoff · escopo de missão ("your job is…").
Lista estruturada de ferramentas com escopo e condições de uso — não um parágrafo vago.
Declaração fraca gera over-promising (oferece o que não pode) e under-using (ignora o que existe). A spec estruturada resolve os dois.
Escopo de tool · condição de uso · assinatura de função · anti-over-promise.
A seção que declara recusas e princípios, posicionada cedo para sinalizar precedência: segurança antes de utilidade.
Proibição seca é contornável; regra com porquê e descrição de padrão (não de mecânica) generaliza para situações novas.
Recusa principiada · hierarquia segurança > utilidade · padrão vs. mecânica · posição precoce.
Orçamento de concisão, listas vs. prosa, uso de markdown e tom conversacional vs. técnico — a seção tone_and_style.
Impede dois antipadrões opostos: resposta longa demais e resposta fragmentada em bullets sem prosa coerente.
Orçamento de concisão · prosa vs. lista · markdown contextual · tom calibrado ao produto.
A camada que o harness injeta a cada turno via <system-reminder>: data, usuário, avisos — separada do prompt estável.
Confundir o que é estável com o que é injetado leva a conclusões erradas ao ler um prompt vazado e ao diff entre versões.
Harness · system-reminder · data atual injetada · separação estável/dinâmico.
🧱 Padrões Estruturais
Os 5 padrões que dão FORMA ao prompt — o esqueleto que aparece antes de qualquer regra de comportamento, independente de domínio.
A distinção entre padrões que dão forma (esqueleto) e os que dão comportamento (voz), com os 5 estruturais deste módulo.
A estrutura é o que você consegue diff-ar entre versões e fornecedores — torna prompts legíveis e versionáveis.
Esqueleto · independente de domínio · 5 padrões · diffável.
"You are X" + modelo + data de corte: o primeiro padrão e o único visto em 100% dos prompts.
Identidade é âncora, não biografia — reconhecer o padrão evita o antipadrão de persona enterrada ou inchada.
Persona · knowledge cutoff · escopo de missão · 100% universal.
Lista estruturada onde cada capacidade traz "o que faz", "quando usar" e "limites" — até como assinatura de função.
Visto em xAI, Google, Microsoft, Notion, Cursor e Claude Code — mais elaborado em agentes que em chatbots puros.
Escopo · condição ("if the user…") · assinatura (params + defaults) · anti-over-promise.
Cada bloco lógico envelopado numa tag XML nomeada (<policy>, <tone_and_formatting>), flat e modular.
É o que torna um prompt de milhares de linhas mantível e o diff entre versões legível — em código, headers Markdown cumprem o papel.
Bloco nomeado · flat (≤ 2 níveis) · diffável · Markdown também.
O bloco <system-reminder> injetado pelo harness, separado do comportamento estável do prompt.
Reconhecer a camada dinâmica evita atribuir ao "prompt do modelo" o que na verdade é contexto de runtime.
system-reminder · injeção pelo harness · camada separada · contexto de runtime.
A precedência declarada que resolve conflitos: core policy > system > user > default.
Sem hierarquia explícita, instruções conflitantes deixam o comportamento indefinido — o prompt precisa dizer quem vence.
Precedência declarada · core policy · resolução de conflito · combinação com <policy>.
🗣️ Padrões Comportamentais
Os padrões que dão VOZ ao modelo — como ele age, decide e fala: regras com porquê, contrastes ALWAYS/NEVER, contratos de ferramenta e princípios consolidados.
A virada do esqueleto (forma) para os padrões que governam como o agente age, decide e se expressa.
É onde mora a personalidade e a confiabilidade do agente — a diferença entre um prompt que "obedece" e um que "entende".
Voz · comportamento × estrutura · governança de decisão · expressão.
Toda regra acompanhada da razão por trás dela, em vez de uma ordem seca.
A justificativa permite ao modelo generalizar para casos não previstos, em vez de obedecer mecanicamente e falhar na borda.
Razão explícita · generalização · robustez na borda · intenção sobre letra.
Par de instruções que fixa o comportamento desejado e o proibido lado a lado, em maiúsculas para dar peso.
O contraste remove a ambiguidade do meio-termo — o modelo sabe exatamente o polo a seguir e o a evitar.
ALWAYS/NEVER · ênfase em maiúsculas · par desejado/proibido · remoção de ambiguidade.
Demonstração concreta do comportamento esperado (entrada → saída) acoplada à regra abstrata.
Um exemplo bem escolhido fixa o comportamento melhor que três parágrafos de descrição — o modelo aprende por imitação.
Demonstração · entrada → saída · aprendizado por imitação · regra + exemplo.
Instrução explícita sobre o comprimento ideal da resposta e quando expandir ou cortar.
Sem orçamento, o modelo "enche linguiça"; com ele, calibra densidade ao canal (terminal, chat, API).
Comprimento-alvo · expandir/cortar · densidade por canal · anti-verbosidade.
As regras de comportamento sobre as ferramentas: quando chamar, em que ordem, como encadear e quando parar.
Declarar a ferramenta não basta — o contrato de uso é o que evita chamadas redundantes, fora de ordem ou desnecessárias.
Quando chamar · ordem · encadeamento · paralelismo vs. sequência.
A regra de preservar verbatim trechos que carregam significado exato — citações, código, valores load-bearing.
Resumir ou parafrasear o que é exato introduz erros sutis; o padrão ensina o modelo a saber o que NÃO reescrever.
Verbatim · load-bearing · citação fiel · não-parafrasear.
Um princípio geral que absorve várias regras pontuais numa única instrução de alto nível.
É a forma madura de um prompt: em vez de listar cada caso, declara o princípio que cobre todos — mais robusto e mais curto.
Princípio geral · consolidação · alto nível · robustez por abstração.
⚠️ Antipadrões
O que NÃO fazer — os erros recorrentes que sabotam um system prompt, do prompt-cebola à inflação de ênfase, com o sintoma e a correção de cada um.
A lógica de estudar o que dá errado: cada antipadrão tem um sintoma observável e uma correção conhecida.
Saber o nome do erro acelera o diagnóstico — você passa de "o prompt está estranho" para "isso é prompt-cebola".
Sintoma · correção · diagnóstico nomeado · catálogo de erros.
Prompt que cresce por acréscimo: cada incidente vira uma nova regra, e nada nunca é removido nem consolidado.
As camadas se contradizem e inflam o contexto; a cura é consolidar em princípios (ver módulo 1.3) e podar.
Crescimento por acréscimo · contradição interna · inflação de contexto · poda.
"Never X" sem explicar a intenção — o inverso da Regra com Porquê.
Sem a razão, o modelo obedece à letra mas falha em variações próximas que violam o espírito da regra.
Ordem seca · falha na borda · letra vs. espírito · adicionar o porquê.
Segurança feita listando termos/técnicas proibidos, em vez de descrever o padrão a detectar.
A lista é contornável com sinônimos e ainda ensina o que evitar; descrever o princípio generaliza e é mais seguro.
Lista de termos · contornável · padrão sobre mecânica · princípio robusto.
Dois antipadrões irmãos: forçar listas/headers/emoji em tudo, e jogar políticas, tom e ferramentas em texto corrido.
Um esvazia a prosa em esqueleto; o outro torna o prompt impossível de versionar — ambos curados pelo Compartimento XML.
Formato forçado · esqueleto sem prosa · blocos misturados · compartimentar.
Abusar de CAPS, "CRITICAL", "ALWAYS" e negrito — até a ênfase perder valor de sinal.
Se tudo é urgente, nada é: o modelo não consegue priorizar. Ênfase é recurso escasso e deve ser gasto com critério.
CAPS em excesso · perda de sinal · ênfase escassa · priorização.
📖 Glossário Essencial
Travou num termo? Aqui está toda a linguagem do curso em português claro, com uma analogia do dia a dia para cada palavra. Não precisa decorar — é uma cola para consultar sempre que precisar.