AGENTS.md: Escreva as Regras uma Vez e Pare de Repetir — aula do módulo O Método em Qualquer Agente, na trilha Começando com Antigravity: do Zero ao Primeiro…
Leitura de aproximadamente 4 minutos.
Módulo: O Método em Qualquer Agente · Curso: Começando com Antigravity: do Zero ao Primeiro Resultado · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código
Volte aos pedidos do módulo anterior e olhe o final de cada um. A mesma cauda se repete: "rode no Windows com o PowerShell que já vem no sistema, sem instalar nada, sem pip, sem npm, sem conta e sem chave de API".
Você vai repetir isso em todo pedido, para sempre. E, no dia em que esquecer, o agente vai propor uma solução que exige instalar uma biblioteca — e você só descobre depois de perder vinte minutos.
A solução não é decorar. É um arquivo de texto.
Crie um arquivo chamado AGENTS.md na raiz da pasta que você abre no editor. É Markdown simples: texto com títulos. Nada de configuração, nada de sintaxe especial, nada para instalar.
O modelo que funciona tem quatro seções:
# Regras desta pasta
## O que eu quero
Automações pequenas que resolvem um problema meu e rodam na minha máquina.
Script com nome descritivo, um arquivo por tarefa.
## Proibido
- `pip install`, `npm install`, qualquer dependência externa
- Chave de API, conta em serviço, envio de dados para fora da máquina
- Privilégio de administrador
- `Remove-Item -Recurse -Force` sem confirmação explícita
## Obrigatório
- Script que move, apaga ou agenda alguma coisa simula por padrão e só executa com `-Aplicar`
- Cabeçalho no topo do script dizendo o que ele faz e como se usa
- `param()` nomeado, nada de posição
## Como me responder
- Se estiver em dúvida sobre o que eu quis dizer, pergunte antes de escrever
- Rode o script e me mostre a saída real; não diga "deve funcionar"
- Se algo falhar, mostre a mensagem de erro literal
Não é código. É o que você diria a um profissional novo no primeiro dia de trabalho.
Repare em "Como me responder". Ela é a que muda mais o resultado, e é a que todo mundo esquece.
"Pergunte antes de escrever" elimina a categoria inteira de retrabalho em que o agente adivinha errado o que você queria e entrega duzentas linhas na direção errada.
"Rode e me mostre a saída real" elimina a segunda categoria: o script que parece certo, soa convincente na explicação e quebra na primeira execução. A diferença entre "deve funcionar" e "funcionou" é essa linha.
Uma armadilha real, que aconteceu na construção desta trilha. A primeira versão da regra de simulação era:
Script que escreve alguma coisa simula por padrão.
Ampla demais. Ela reprovava o gerador de relatório da aula 3 — que não destrói nada, apenas cria um arquivo HTML novo. A regra virou:
Script que move, apaga ou agenda alguma coisa simula por padrão.
Regra que reclama de tudo é ruído, e ruído a gente aprende a ignorar. No mês seguinte, você ignora também a que importava. Regra ampla demais é pior do que regra nenhuma, porque dá sensação de proteção sem proteger.
Com o AGENTS.md na pasta, faça um pedido deliberadamente magro:
Escreva um script que apague os arquivos temporários desta pasta.
Repare no que você não disse: nada sobre simulação, nada sobre não instalar coisas, nada sobre parâmetros. Se o arquivo estiver sendo lido, a resposta volta com param(), com -Aplicar e com cabeçalho — sem você ter repetido nada.
Se voltar sem isso, três verificações: o arquivo está na raiz da pasta aberta, o nome está exatamente AGENTS.md, e você abriu a pasta certa no editor.
Antigravity, Claude Code, Codex, OpenCode e Cursor leem um arquivo de regras da pasta do projeto. O nome do arquivo pode variar entre ferramentas, mas o conceito é o mesmo, e o conteúdo se aproveita inteiro.
Isso significa que o AGENTS.md que você escrever hoje sobrevive à sua próxima troca de ferramenta. É o único artefato desta trilha do qual isso se pode dizer com essa força.