AGENTS.md
Um arquivo no projeto que o sistema carrega sozinho no começo de toda sessão. O briefing permanente do lugar.
Onde você esbarra nisso
Quando você percebe que digita as mesmas três instruções no começo de toda conversa. Elas deviam estar num arquivo.
Conecta com
O que é
Um arquivo de texto que fica junto do projeto e que o harness lê automaticamente ao iniciar, jogando o conteúdo dentro da janela de contexto.
É diferente da System prompt num ponto que importa: a instrução de sistema é do produto, escrita por quem fez a ferramenta. Este arquivo é do teu projeto, escrito por você, e viaja junto com ele.
O que muda pro teu negócio
É o jeito mais simples e mais subestimado de fazer um agente trabalhar do teu jeito, e a analogia com gente é direta: é o manual que o funcionário novo lê no primeiro dia.
O que entra ali: como as coisas se chamam na tua casa, o que nunca deve ser feito, onde ficam as coisas, qual o padrão que você exige. O que não entra: tudo que for interessante mas não for usado, porque isso vira ruído por cima do que importa.
E ele resolve o problema de "explicar de novo toda vez", que é onde a maioria das pessoas desiste de usar essas ferramentas a sério.
Fontes
Documentação do Claude Code sobre arquivos de instrução carregados no início da sessão.
AI Coding Dictionary, verbete "AGENTS.md", Matt Pocock. A expressão "briefing permanente do projeto para o agente" é dele, e é o que faz um leigo entender pra que serve o arquivo.