O que é Arquivo de instrução de agente?

O que é um arquivo de instrução de agente

Um arquivo de instrução de agente fica na raiz do repositório e orienta a ferramenta de código sobre como trabalhar no projeto. O AGENTS.md é o formato aberto, e o CLAUDE.md e o GEMINI.md são os nomes lidos por ferramentas específicas.

O conteúdo vale para toda sessão do agente no repositório e complementa o README. Ele informa o que o projeto é, como validar uma mudança e quais arquivos exigem cuidado.

O que cabe no arquivo

O arquivo reúne os comandos de instalação, teste e build, as convenções de nome e de pasta e os caminhos que exigem cuidado. Também lista as etapas de validação antes de concluir a tarefa.

Também cabe a indicação de onde buscar a documentação de cada área, com o link para o arquivo real. O agente usa essa referência para carregar a parte que importa na tarefa em andamento.

O que não cabe

O arquivo não recebe credencial nem informação sensível. Histórico de conversa e anotação temporária ficam fora, e uma instrução que ninguém consegue verificar também não pertence ao repositório.

O README apresenta o projeto para novos integrantes. O arquivo de instrução define como o agente deve operar, e os dois podem repetir comandos sem duplicar a explicação completa.

Exemplo

Como conferir

Execute os comandos publicados no arquivo e confira se eles funcionam na versão atual do repositório. Compare os caminhos citados com a árvore real e retire a instrução que não pode ser verificada.

O contexto do agente cresce com o repositório, e a memória da sessão não substitui a instrução escrita. A documentação de cada área continua sendo a fonte para o detalhe.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Na Formação Vibe Coding, o arquivo de instrução orienta o agente sobre o comando de teste e os caminhos que ele pode alterar.

Conhecer a formação →