Ler o post de Marcos Hernanz no X
Um reel de @ii.systema diz que um desenvolvedor gastou 60 bilhões de tokens e depois publicou o arquivo de regras que usa para programar com IA. Segundo o reel, o arquivo faz o modelo procurar soluções simples, ler a documentação e poupar seus limites de uso.
O desenvolvedor é Marcos Hernanz. Ele trabalhou no Next.js na Vercel. Em 2 de agosto de 2026, ele postou no X: “After doing ~60B tokens, this is my full AGENTS.md”. O post mostrava sete regras. Algumas horas depois, ele respondeu com uma oitava, com as palavras “Almost forgot”.
O que é um AGENTS.md
AGENTS.md é um arquivo de texto simples na pasta principal de um projeto. Agentes de código o leem antes de começar, então você escreve suas regras uma vez em vez de repeti-las em cada conversa. O Claude Code o lê quando o projeto não tem um arquivo CLAUDE.md.
As oito regras, em palavras simples
- Não mantenha código antigo vivo. Quando algo for substituído, apague o caminho antigo. Não adicione alternativas nem camadas para mantê-lo funcionando.
- Escolha a solução mais simples que faça todo o trabalho hoje. Não adicione configurações ou camadas “por via das dúvidas”.
- Cresça em pequenos passos. Primeiro construa a menor versão que funcione do começo ao fim. Depois adicione um recurso de cada vez sobre algo que já funciona.
- Mantenha as partes separadas. Cada parte faz um só trabalho.
- Use uma biblioteca boa e conhecida quando ela deixar as coisas mais simples ou mais confiáveis. Não reescreva recursos comuns sem motivo.
- Veja o que o projeto já tem antes de adicionar um pacote ou escrever seu próprio código. Leia a documentação e os tipos da biblioteca antes de decidir que ela não faz algo.
- Decida pensando no longo prazo. Nada de solução rápida feita para ser jogada fora depois.
- Antes de projetar algo, veja como bons produtos consolidados resolvem o mesmo problema. Copie os padrões comprovados deles em vez de inventar os seus.
Por que isso pode economizar tokens
A maioria dessas regras pede ao agente que escreva menos: sem camadas extras, sem cópias de bibliotecas, sem código mantido só para versões antigas. Menos código significa menos para ler, corrigir e explicar na próxima rodada. A regra seis é a que o reel chama de “ler a documentação”. Marcos não dá nenhum número de quantos tokens o arquivo economiza.
Um aviso do autor
Marcos deixou uma nota abaixo do post: ele só usa este arquivo em projetos pessoais, e você não deve usá-lo em produção se não quiser destruir seu código. A primeira regra é a arriscada. Em um produto real, apagar caminhos antigos pode quebrar o uso de quem ainda precisa deles.
Como usar
Crie um arquivo chamado AGENTS.md na pasta principal do seu projeto. Copie as oito regras dos dois posts dele e mude qualquer regra que não sirva para o seu projeto. Se você usa o Claude Code e já tem um CLAUDE.md, adicione uma linha a ele para que o Claude leia os dois:
@AGENTS.md