Este é o capítulo 2 de Operação IA, série em cinco partes sobre como transformar ferramentas de IA em ambiente de trabalho para profissionais de Digital. No capítulo 1, você saiu do chat e delegou sua primeira tarefa real a um agente. Se ainda não leu, comece por lá: os capítulos se acumulam.
No final do capítulo passado, seu agente entregou uma auditoria de títulos que teria tomado uma tarde do seu dia. Bonito. Agora fecha a sessão, abre uma nova amanhã e pede a próxima tarefa. O agente não lembra de nada. Não sabe qual é o seu site, quem é seu público, qual tom você usa, quais regras você segue. Tudo o que ele soube ontem, soube porque a sua instrução daquele dia era boa. Amanhã você vai explicar tudo de novo, e no dia seguinte também, e a qualidade do trabalho vai oscilar junto com a qualidade do seu prompt de cada manhã.
Existe um nome para esse problema, e existe uma solução de um arquivo só.
Prompt é ordem de serviço. Contexto é o briefing permanente.
A comunidade passou 2023 e 2024 obcecada por prompt engineering, a arte de escrever a instrução perfeita. Em 2026, quem trabalha com agentes fala de outra coisa: context engineering. A distinção importa demais para ficar no jargão.
O prompt é a ordem de serviço da tarefa. “Audite estes títulos”, “escreva este briefing”, “cruze estas planilhas”. Ele muda a cada tarefa e morre com ela.
O contexto é o briefing permanente. Quem você é, o que a sua operação faz, para quem, com quais regras, com quais critérios de qualidade, com quais proibições. Ele vale para todas as tarefas e sobrevive a todas as sessões.
Pensa em como você recebe um analista novo no time. Você não explica a empresa inteira de novo a cada tarefa que delega. Você explica uma vez, bem explicado, de preferência por escrito, e a partir dali as ordens de serviço podem ser curtas, porque o repertório já está instalado. O arquivo de contexto faz exatamente esse papel para o agente. E o efeito colateral é delicioso: seus prompts encurtam. Quanto melhor o contexto, mais um “roda a auditoria de títulos do mês” basta.
O arquivo
No Claude Code, esse briefing permanente vive num arquivo chamado CLAUDE.md, um texto simples em Markdown que você deixa na raiz da sua pasta de trabalho. Toda vez que você abre uma sessão naquela pasta, o agente lê o arquivo antes de qualquer coisa. Sem plugin, sem configuração, sem código. Um arquivo de texto.
O mercado inteiro convergiu para essa ideia, e aqui entra um fato que interessa à tese desta série. Em 2025 a OpenAI lançou um padrão aberto chamado AGENTS.md, mesmo conceito, e o doou para a Linux Foundation, onde hoje ele é governado por uma fundação que tem Anthropic, Google, Microsoft e OpenAI entre os membros. Dezenas de milhares de projetos já usam. O Codex lê AGENTS.md nativamente. O Antigravity passou a ler nativamente em março de 2026. O Claude Code, por teimosia da Anthropic, ainda lê apenas o seu CLAUDE.md, mas a própria documentação oficial ensina o contorno, que mostro no fim do capítulo.
Traduzo o que isso significa para você: o briefing que você vai escrever hoje funciona nas três ferramentas com ajuste mínimo. Seu contexto é portátil. Se amanhã você trocar de fornecedor, o arquivo vai junto. O conhecimento codificado é seu, e essa é a diferença entre alugar uma ferramenta e construir um ativo.
O dado que ninguém esperava: escreva você mesmo
Antes do tutorial, um resultado de pesquisa que merece parágrafo próprio, porque contradiz o instinto de todo mundo.
Um estudo de 2026 analisou o efeito de arquivos de instrução em 138 repositórios reais. Arquivos escritos pelos próprios profissionais melhoraram a taxa de sucesso dos agentes e reduziram a quantidade de erros gerados em algo entre 35% e 55%. Já os arquivos de contexto gerados por IA pioraram a taxa de sucesso e ainda aumentaram o custo de inferência em mais de 20%.
Leia de novo, porque a tentação existe e eu sei que você pensou nela: pedir para a própria IA escrever o arquivo de contexto dela. Os dados dizem que isso produz um documento genérico, inchado e contraproducente. Faz sentido quando você para para pensar: o valor do arquivo está exatamente no que só você sabe. Suas regras, suas exceções, seus critérios, suas cicatrizes. IA não tem acesso a nada disso. O arquivo de contexto é a parte do trabalho que não se delega, e é justamente por isso que ele vira ativo proprietário. Na Spreable, a empresa que estou construindo, essa é uma decisão de arquitetura: os agentes operam dentro de um playbook definido por gente, com autonomia dentro dele e nunca fora. O arquivo de contexto é a menor unidade desse playbook.
Duas regras práticas saem da mesma pesquisa. Primeira, curto vence longo: mire em menos de 150 linhas, porque o agente carrega o arquivo inteiro a cada interação e verbosidade custa contexto e dinheiro. Segunda, específico vence aspiracional. “Escreva com qualidade” muda nada. “Meta title com até 65 caracteres, proibido o formato palavra-chave dois-pontos descrição” muda comportamento. Se a frase não altera uma decisão concreta do agente, ela sobra.
Tutorial: o briefing da sua operação em seis seções
Reserve uma hora, e faça à mão. Vou usar como exemplo uma operação comum, o time de conteúdo e SEO de um e-commerce, mas a estrutura serve para mídia, produto, CRM, o que for. Crie um arquivo chamado CLAUDE.md na pasta de trabalho do capítulo 1 e construa estas seis seções.
1. O negócio em cinco linhas. O que a empresa vende, para quem, qual a proposta de valor, quais os concorrentes diretos. Sem institucional, sem missão-visão-valores. O que um analista precisaria saber no primeiro dia.
2. A audiência. Quem lê, quem compra, o que essa pessoa já sabe e o que precisa que expliquem. Uma persona bem descrita em um parágrafo vale mais que três slides de persona com nome e foto de banco de imagem.
3. Tom e voz. Como a marca fala e, principalmente, como não fala. Proibições explícitas funcionam melhor que descrições de estilo: “nunca usar superlativo sem dado que sustente”, “proibido ponto de exclamação em título”.
4. Regras técnicas do seu canal. Aqui mora o ouro do profissional de Digital. Limites de caracteres, estrutura de heading, padrões de URL, regras de linkagem interna, formato de imagem, nomenclatura de UTM, taxonomia de categorias. Tudo que você hoje corrige na mão depois que a IA entrega.
5. Critérios de qualidade e revisão. O que faz você aprovar ou devolver um trabalho. Se você tem checklist mental, é aqui que ele sai da sua cabeça e vira sistema.
6. Como trabalhar comigo. Instruções de comportamento: “antes de executar qualquer tarefa, apresente o plano e aguarde aprovação” e “quando a instrução estiver ambígua, pergunte em vez de assumir”. Essa segunda linha tem lastro: pesquisa apresentada em 2026 mostrou que agentes quase nunca perguntam por conta própria diante de instruções incompletas, e que quando são explicitamente orientados a perguntar o desempenho em tarefas mal especificadas melhora em até 74%. Uma linha no arquivo, ganho permanente.
Um exemplo condensado, para calibrar o nível de especificidade:
# Contexto: Loja Verde (e-commerce de jardinagem)
## Negócio
E-commerce de plantas, vasos e insumos para jardinagem urbana.
Ticket médio R$ 180. Público em capitais, apartamentos, iniciantes.
Concorrentes diretos: [X] e [Y]. Diferencial: curadoria e conteúdo educativo.
## Audiência
Pessoa entre 25 e 45 anos, mora em apartamento, matou pelo menos uma
planta e tem medo de matar a próxima. Não conhece termos técnicos de
botânica. Explicar substrato, nunca explicar o que é regar.
## Tom e voz
Direto, caloroso, sem infantilizar. Proibido: "verdinha", "amiguinha",
exclamação em título, promessa de "nunca mais matar uma planta".
## Regras técnicas
Meta title até 65 caracteres, sem formato "palavra-chave: descrição".
H1 diferente do meta title. Um link interno a cada 300 palavras,
âncora descritiva, nunca "clique aqui". Imagens em WebP, alt text
descrevendo a cena, não a keyword.
## Qualidade
Toda afirmação sobre cuidado de planta precisa de fonte ou marcação
[VERIFICAR]. Preço e prazo nunca aparecem em conteúdo evergreen.
## Como trabalhar comigo
Apresente o plano antes de executar. Se a instrução estiver ambígua,
pergunte. Entregas em Markdown, uma por arquivo, na pasta /saidas.
Repare que quase toda linha proíbe, limita ou especifica algo. É assim que se parece um contexto que trabalha.
O teste antes e depois. Terminou o arquivo? Rode a prova. Abra uma sessão nova e repita a tarefa do capítulo 1, a auditoria de títulos, mas agora com uma instrução propositalmente curta: “rode uma auditoria de títulos no export desta pasta e me entregue as reescritas prioritárias”. Compare com o resultado da semana passada. As sugestões de title agora respeitam seu limite de caracteres, seu tom, suas proibições, e o agente te apresentou o plano antes de executar sem que você pedisse. A instrução encolheu e o resultado melhorou. Esse delta é o seu arquivo trabalhando, e é ele que você vai levar para todos os capítulos seguintes.
E no Codex e no Antigravity?
O conceito é idêntico, muda o nome do arquivo. No Codex, escreva o mesmo conteúdo num AGENTS.md: ele é lido automaticamente e aceita hierarquia, um arquivo geral na raiz e arquivos específicos em subpastas, útil quando a mesma operação tem frentes diferentes. No Antigravity, o AGENTS.md também é lido nativamente desde março de 2026; se você vinha do antigo Gemini CLI com um GEMINI.md, saiba que os dois são lidos e o GEMINI.md ganha em caso de conflito, então evite manter os dois.
Para quem quer um arquivo só servindo às três ferramentas, o caminho que a própria Anthropic documenta: mantenha o AGENTS.md como fonte única e crie um atalho para o Claude Code com um comando de uma linha no terminal, ln -s AGENTS.md CLAUDE.md. Parece detalhe técnico, mas releia a jogada: seu playbook num padrão aberto, governado por fundação neutra, funcionando em qualquer fornecedor. Dependência zero de decisão alheia. Essa série inteira existe por causa dessa ideia.
O que você construiu e o que falta
Você agora tem um agente que conhece a sua operação e um briefing permanente que é seu, portátil e acumulativo: cada regra nova que você descobrir no dia a dia tem endereço para morar. Mas repare no limite do que fizemos. O arquivo de contexto diz ao agente quem você é. Ele ainda não ensina o agente a executar seus processos, passo a passo, do seu jeito. A auditoria de títulos, o briefing de pauta, o relatório de mídia: hoje cada um deles ainda depende de você descrever o processo no prompt.
No capítulo 3, isso acaba. Você vai empacotar seus processos em skills, ferramentas reutilizáveis que se invocam com um comando, e a sua operação começa a ganhar prateleira. Semana que vem, aqui.