Escrever um arquivo que todo assistente de IA entende

Nesta aula você escreve, a partir da folha das quatro peças, um arquivo de texto com o que só a sua casa sabe, liga esse arquivo a todos os assistentes e confere se as respostas batem. Esse arquivo, que o curso chama de caderno, é o primeiro degrau da memória de longo prazo (o que o agente guarda entre conversas, como a ficha do cliente). Qualquer assistente consegue lê-lo, e ele basta enquanto o assistente o lê inteiro.

Deixar a memória presa em cada assistente custa caro no balcão. A correção de preço feita numa conversa some na outra, e o tom muda de um atendimento para o seguinte. Com o caderno, a correção entra uma vez, no arquivo, e vale para todos.

As cinco seções cobrem o que um cliente pergunta antes de comprar. Texto simples basta, sem planilha nem programa especial, e o mesmo arquivo entra antes de cada prompt (o pedido que você escreve para o assistente).

Por que um arquivo só vale mais que o histórico colado?

Colado, o histórico envelhece dentro de cada conversa; o arquivo envelhece num lugar só, onde você enxerga e corrige.

A coluna da direita tem uso sério fora dos pequenos negócios. No Claude Code, o assistente de programação da Anthropic, um arquivo com as regras do projeto entra no começo de toda conversa, e o resto é buscado quando a pergunta pede. O Claude também aceita importar memória de outros assistentes, e o caderno encurta essa ponte, porque o texto já é seu. O curso "Escrever bem com IA" mostra em como trocar de ferramenta sem perder o método como manter o padrão de texto quando o assistente muda.

Como escrever o caderno só com o que o assistente não acha sozinho

O que entra no caderno é o que o assistente não encontra em outro lugar. Pesquisadores da ETH Zurich, na Suíça, testaram em 2026 agentes de programação com e sem esses arquivos, em 138 tarefas de 12 projetos reais: o arquivo não melhorou o acerto de forma significativa e subiu o custo em mais de 20%. Ajudou só a regra que o modelo não achava sozinho, e o arquivo escrito pelo próprio modelo encareceu sem ganho.

A ordem também pesa. Num teste da Distyl AI, nos Estados Unidos, com modelos de sete fornecedores e centenas de instruções num mesmo pedido, as primeiras foram mais cumpridas que as últimas, e o erro que mais cresceu foi esquecer uma regra. Antes de começar, tenha à mão a folha da aula anterior e as dez perguntas que o balcão mais recebe.

Se uma regra nova não muda nenhuma das três respostas, tire; ela custa leitura e não ajuda. Se o assistente erra a mesma pergunta depois da correção, reescreva a linha com as palavras que o cliente usa. Na pousada de exemplo, a diária de feriado de R$ 480 mudou numa semana: a Marta trocou a linha no caderno, colou a versão nova nos três assistentes e repetiu a pergunta até as três respostas baterem.

Guarde cada versão com a data, para saber quando um preço mudou. O curso "GitHub: Controle de Versão do Zero" explica em o que é controle de versão como manter todas as versões de um arquivo.

Proteja o caderno de instrução plantada. Defina uma só pessoa com direito de editar, nunca cole nele texto vindo de e-mail, site ou avaliação sem reescrever com as suas palavras, e compare a versão nova com a anterior antes de ligar. Pesquisadores da Universidade de Washington mostraram em julho de 2026, com o Claude Code e o Codex, que uma instrução plantada no arquivo de memória segue valendo nas conversas seguintes.

Quando o caderno deixa de bastar e o que fazer

O caderno dá conta enquanto o assistente lê o arquivo inteiro. No Claude Code, segundo a Anthropic, só as primeiras 200 linhas ou 25 KB do índice de memória entram em cada conversa, e a recomendação é manter os arquivos de instruções abaixo de 200 linhas. Num levantamento de agosto de 2026 em 1.867 projetos, esses arquivos mais que triplicaram quando ninguém lembrava por que cada regra tinha entrado.

Guia de marketing: o caderno de marca. Em marketing, o caderno desta aula vira o caderno de marca: voz, ofertas em vigor com data, público, o que a lei e a empresa proíbem prometer e os links oficiais. Ele entra no campo de instruções do projeto, que os dois assistentes têm. No ChatGPT, as instruções do projeto valem só dentro dele e passam por cima das instruções gerais da conta. No Claude, o campo se chama Set project instructions e vale para todas as conversas do projeto.

Enquanto nenhum desses sinais aparece, o arquivo é a memória certa, e trocar de degrau antes da hora só dá trabalho. O curso "Reinforcement Learning para Vibecoding: do prompt ao loop verificável" mostra em quando escrever mais instrução deixa de render os sinais de que o texto chegou ao teto.

O caderno está pronto quando nenhuma linha repete o que está em outro lugar, cada regra tem motivo, só uma pessoa edita e a pergunta do preço do próximo feriado sai certa em todos os assistentes. Compare com o número que você anotou na aula anterior, antes do caderno. O curso "Prompt Engineering para Executivos" ensina em como avaliar um prompt de sistema que precisa sobreviver à troca de modelo a testar o texto antes de confiar nele.

Com o caderno ligado, siga para "Como ligar o assistente à agenda de reservas sem perder o controle" e dê ao assistente a agenda.