Aula 7 · 18 min
Toda conversa nova com o agente começa do zero. Sem arquivo de instruções, você repete os mesmos avisos; com instrução vaga, nada muda. Regra que dá para conferir, roteiro guardado numa Skill e memória curta com data fazem o agente melhorar a cada tarefa.
Começar a aula
Objetivo: reescrever o AGENTS.md com cinco regras conferíveis e transformar uma falha real em regra na próxima execução.
Onde mora cada tipo de instrução. Clique em cada bloco.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
Diz como trabalhar ali: por onde começar a ler, como conferir, o que não fazer e o formato da entrega. A história e os motivos ficam de fora. Arquivo curto é lido inteiro.
Um procedimento que se repete (a lista semanal, o relatório de sexta) vira uma Skill: um SKILL.md que começa com nome e descrição. O agente aciona quando a tarefa pede, sem carregar o manual inteiro em toda tarefa.
Não é o modelo aprendendo: é um arquivo que o agente lê quando você indica. Guarde fatos estáveis e decisões com data e motivo, não a conversa inteira. Marque no topo quando foi revisado.
Sintoma, causa observada, menor correção e verificação, numa linha. Diga se a falha foi de pedido ou de infraestrutura. A correção vai para onde a próxima execução lê: o AGENTS.md ou a Skill.
Regra conferível na porta, roteiro no fichário, memória curta com data e cada escorregão virando uma proteção pequena. É assim que a tarefa de amanhã sai melhor que a de hoje, sem trocar de modelo.
Nenhum desses arquivos supera as instruções do sistema, as permissões da ferramenta e o que você pede explicitamente na conversa.
Clique em cada etapa.
Faça o teste da placa: "use óculos de proteção" dá para conferir olhando; "tenha cuidado" não dá.
Regra boa pede uma ação e deixa uma evidência na entrega. Regra que não muda nenhuma decisão sai do arquivo.
Compare o total do relatório com vendas.csv e indique a diferença.
No Codex, o AGENTS.md global fica em %USERPROFILE%\.codex e vale em tudo; o do projeto vale na pasta; o de uma subpasta prevalece ali dentro.
Comportamento estranho? Procure um AGENTS.override.md esquecido numa pasta copiada: na mesma pasta, ele passa na frente do AGENTS.md.
Resuma as instruções que você carregou e diga de qual arquivo veio cada uma.
A descrição é o que o agente lê para decidir se aciona a Skill. "Ajuda com relatórios" dispara até em ata de reunião.
Diga a situação e onde ela para. Antes de confiar, ensaie com três casos: normal, incompleto e fora do combinado.
Gerar rascunho de relatório semanal quando houver um CSV de vendas. Não usar para enviar relatórios ou tratar credenciais.
Quando o resultado sai errado, a vontade é trocar de modelo ou refazer tudo. Isso gasta horas e esconde problema simples.
Falha de pedido se corrige no texto; falha de infraestrutura, com uma checagem. Uma linha nova no AGENTS.md costuma bastar.
Confira o cabeçalho e a quantidade de registros antes de gerar.
Copie e adapte à sua pasta. Troque o que estiver entre < >.
# Instruções para o agente Propósito: <o que este projeto produz> 1. Leia README.md antes de alterar qualquer coisa. 2. Use só entradas/ e saidas/; não apague nem renomeie arquivos. 3. Não invente dado que não está nas entradas; o que faltar vira pendência no fim. 4. Nunca escreva chaves ou senhas em arquivo de texto; cite só o nome da variável do .env. 5. Termine dizendo: o que alterou, como conferiu e o que ficou pendente.
--- name: relatorio-semanal description: Gerar rascunho de relatório semanal quando o usuário fornecer um CSV de vendas. Não usar para enviar relatórios ou tratar credenciais. --- ## Entrada Um CSV em entradas/. ## Passos 1. Confira o cabeçalho e a quantidade de registros antes de gerar. 2. Some os valores; sem inventar ausências. 3. Escreva o rascunho em saidas/relatorio.md. ## Saída e conferência Cite a fonte, o total conhecido e as pendências. Pare antes de enviar ou publicar.
# Memória Revisado em: <dd/mm/aaaa> - <fato estável 1, ex.: relatórios curtos, pendências no fim> - <fato estável 2> - <fato estável 3>
| Data | Sintoma | Causa observada | Menor correção | Verificação | Tipo | |---|---|---|---|---|---| | <dd/mm> | relatório vazio | planilha sem registros | conferir a quantidade de linhas antes de gerar | planilha vazia gera aviso, não relatório | infraestrutura |
Resuma as instruções que você carregou nesta pasta e diga de qual arquivo veio cada uma. Depois, consulte ../config/memoria.md e, ao fazer a próxima tarefa, diga qual fato da memória você usou.
mkdir .agents\skills\relatorio-semanal notepad .agents\skills\relatorio-semanal\SKILL.md type .agents\skills\relatorio-semanal\SKILL.md
%USERPROFILE%\.codex\AGENTS.md: global, pequeno ("relate o que você conferiu").projetos\meu-primeiro-agente\AGENTS.md: vale no projeto.…\provas\AGENTS.md: prevalece dentro de provas no que ele trata.O seu pedido explícito na conversa vale mais que os três.
Sem a regra "sem inventar ausências": "Total da semana: 100,00" — a Caneta não tinha valor e o total fingiu que tinha.
Com a regra: "Total conhecido: 90,50. Pendência: a linha da Caneta está sem valor. Não preenchi."
No projeto e na pasta config.
Reescreva o AGENTS.md com cinco regras. Ao lado de cada uma, anote como você confere se foi cumprida. Peça uma tarefa e confira.
Pronto quando: para cada uma das cinco regras você aponta, na entrega do agente, a evidência de que foi cumprida.
Registre em config\falhas.md uma falha real das aulas anteriores (sintoma, causa, menor correção, verificação, tipo) e ponha a correção no AGENTS.md.
Pronto quando: na tarefa seguinte, o mesmo problema não se repete e você consegue dizer qual linha do AGENTS.md o evitou.
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
Qual destas regras você consegue conferir olhando a entrega do agente?competência
Pergunta 2 de 4
O global diz "responda em tópicos", o AGENTS.md do projeto não fala de formato e você pede uma tabela na conversa. O que vale?
Pergunta 3 de 4
Você criou memoria.md em config, mas o agente ignorou os fatos. O que faz primeiro?
Pergunta 4 de 4
O relatório saiu vazio porque a planilha estava sem registros. Qual é a menor correção?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.