Quando a IA já sabe quem você é, quais são as regras da casa e o que deu errado da última vez, o pedido cabe numa linha. Essa base não se monta a cada conversa: fica num lugar que a IA lê sozinha antes de começar. É o que separa repetir tudo toda vez de ter alguém que já conhece o trabalho.
Objetivo: montar a base de contexto que o agente lê antes de qualquer pedido, com regras e uma lição de um erro real.
01 · De onde vem o contexto
Quatro fontes que o agente lê antes do seu pedido. Toque ou clique em cada uma.
Aula 301 · De onde vem o contextoQuatro fontes que o agente lê antes do seu pedido. Toque ou clique em cada uma.
Cada erro novo vira uma linha nas lições, e a base melhora sozinha com o uso
1/6
Regras
Um arquivo por projeto (AGENTS.md no Codex, CLAUDE.md no Claude Code, as instruções do projeto no ChatGPT ou no Claude) com quem você é, o público, o tom, as ferramentas e as fronteiras. O agente lê antes de começar.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
1/6
Regras
Um arquivo por projeto (AGENTS.md no Codex, CLAUDE.md no Claude Code, as instruções do projeto no ChatGPT ou no Claude) com quem você é, o público, o tom, as ferramentas e as fronteiras. O agente lê antes de começar.
2/6
Lições
Toda vez que algo dá errado, uma linha nova no topo da lista: o que aconteceu e a regra que evita repetir. No meu caso (Nei, do INEMA), é assim: o mesmo erro não volta, porque a correção vira regra escrita.
3/6
Histórico
O que você já decidiu com a IA não deveria ser perguntado de novo. No chat, ligue a memória do ChatGPT ou do Claude nas configurações e mantenha o assunto dentro do mesmo projeto. No terminal, guarde os registros das sessões numa pasta que o agente consegue buscar.
4/6
Arquivos
Os documentos e planilhas de verdade: no chat, os arquivos enviados ao projeto; no terminal, a pasta ou o repositório que o agente abre. Ele usa o original em vez do seu resumo de memória.
5/6
Agente
Com as quatro fontes no lugar, o pedido fica curto e o agente entende de onde ele veio e por quê. Você não monta o contexto do zero a cada vez.
6/6
A base inteira
Regras, lições, histórico e arquivos chegam ao agente antes do pedido. Cada erro vira lição, e a próxima tarefa já começa melhor.
Contexto bom tem casa própria: mora num arquivo ou pasta, não no texto do pedido.
02 · Montar a base em quatro passos
Comece pequeno. Toque ou clique em cada passo.
1. Escolher a casa
No chat: crie um projeto (ChatGPT ou Claude) ou um Gem (Gemini), escreva as regras nas instruções dele e envie os arquivos de referência.
No terminal, com Claude Code ou Codex (agentes que trabalham numa pasta do seu computador), as regras vão num arquivo da pasta chamado AGENTS.md ou CLAUDE.md. É só o nome do arquivo de regras.
ExemploProjeto "Comunicação da escola" com instruções próprias.
2. Regras
Comece com cinco regras: quem é você, para quem é o trabalho, o tom, a ferramenta e uma fronteira.
Regra boa é verificável: dá para olhar o resultado e dizer se foi seguida.
Regra verificávelTodo comunicado diz a data em que a mudança começa.
3. Lições
Quando a IA errar, não corrija só aquela resposta: escreva a lição no topo da lista, com a data.
Uma linha: o que aconteceu e a regra que evita.
LiçãoComunicado saiu sem a data de início: toda mudança cita o dia em que começa. (24/10)
4. Testar
Abra uma conversa nova, faça um pedido curto e veja se a regra e a lição foram seguidas sem você lembrar.
Se não foram, a regra está escondida ou vaga: suba para o topo e escreva de um jeito que dá para conferir.
Pedido curtoEscreva o comunicado da festa junina.
03 · Modelos para copiar
Troque o texto entre < > pelo seu.
Regras do projeto (instruções no chat, ou AGENTS.md no terminal)
# Quem sou
<seu nome, o que você faz, para quem trabalha>
# Para quem é o trabalho
<o público, em uma frase>
# Regras
- Escreva em português, frases curtas.
- <regra verificável 2>
- <regra verificável 3>
- Antes de terminar, diga o que mudou e como eu confiro.
- Fronteira: <o que nunca pode acontecer>
# Onde está o resto
- Referências: os arquivos enviados ao projeto (no terminal, a pasta referencias/)
# Lições (a mais nova no topo)
- <data> · <o que deu errado> → <a regra que evita>
Pedido quando a IA errar
Você errou isto: <o que aconteceu>.
Antes de corrigir, escreva a lição em UMA linha, neste formato:
<data> · <o que deu errado> → <a regra que evita>.
Depois refaça o trabalho seguindo a regra nova e me mostre as duas coisas.
Primeira linha de toda tarefa
Leia as regras e as lições do projeto antes de começar. Se algo que eu pedir contrariar uma regra, me avise antes de fazer.
Simulação: exemplo ilustrativo
No chat: a IA escreve a linha; você copia e cola no topo da seção Lições das instruções do projeto.
No terminal: peça que ele grave a linha no AGENTS.md (ou CLAUDE.md) e confira o arquivo.
O arquivo de regras existe e tem pelo menos cinco regras suas.
Há pelo menos uma lição tirada de um erro real, com data.
Numa conversa nova, um pedido de uma linha saiu seguindo a regra e a lição.
Regra vaga ("seja profissional"): ninguém consegue conferir. Escreva o que dá para ver no resultado.
Corrigir só a resposta: o erro volta amanhã. A correção tem de virar lição escrita.
Senha ou chave no arquivo de regras: tudo o que está em texto pode vazar. Chave fica fora.
04 · Prática: a sua base de contexto
Escolha um assunto em que você usa IA toda semana.
E1 · A casa e as regras
20 min
Crie o projeto (no chat) ou a pasta com AGENTS.md (no terminal) e escreva as cinco regras do modelo.
Pronto quando: o arquivo ou as instruções do projeto têm cinco regras, e cada uma dá para conferir olhando o resultado.
E2 · A primeira lição
15 min
Peça uma tarefa, ache um erro (sempre tem), use o pedido "quando a IA errar" e cole a lição nas instruções do projeto (no terminal, ele grava no AGENTS.md).
Pronto quando: a seção Lições tem uma linha com data, o erro e a regra que evita.
E3 · O teste da sessão nova
10 min
Abra uma conversa nova e faça um pedido de uma linha do mesmo tipo.
Pronto quando: o resultado seguiu a regra e a lição sem você repetir nenhuma das duas no pedido.
05 · Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
A IA esqueceu a data no comunicado. O que fazer para o erro não voltar?competência
Correto
Corrigir só a resposta resolve hoje. A lição escrita entra no contexto de toda tarefa seguinte, e o mesmo erro não volta.
Não é essa
Corrigir só a resposta resolve hoje. A lição escrita entra no contexto de toda tarefa seguinte, e o mesmo erro não volta.Rever: Montar a base em quatro passos
Pergunta 2 de 3
Qual destas é uma regra verificável?
Correto
Dá para olhar o comunicado e dizer se a data está lá. "Profissional" e "qualidade" ninguém consegue conferir.
Num arquivo ou nas instruções do projeto, o contexto chega antes de todo pedido. Repetido no pedido, ele some na próxima conversa.
Não é essa
Num arquivo ou nas instruções do projeto, o contexto chega antes de todo pedido. Repetido no pedido, ele some na próxima conversa.Rever: De onde vem o contexto
Teste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.
Escolha uma alternativa. A explicação aparece depois da sua tentativa.
06 · A aula em três frases
Quatro fontesRegras do projeto, lições, histórico e arquivos chegam ao agente antes do pedido.
Erro vira liçãoToda correção vira uma linha escrita, e o mesmo erro não volta.
Teste na sessão novaA base funciona quando um pedido de uma linha já sai certo.