Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

Arquivo de instruções do agente (AGENTS.md)

Um arquivo de instruções do agente é um arquivo Markdown em um repositório de código, como AGENTS.md ou CLAUDE.md, que um agente de programação lê no início de uma sessão para aprender os comandos, as convenções e as regras do projeto.

Também chamado: AGENTS.md, CLAUDE.md, .cursorrules, rules file

Por Divya Sharma · Verificado em 15 de nov. de 2026 · Como analisamos

Um agente de programação começa cada sessão sem saber nada sobre o seu projeto. Sem ajuda, ele adivinha como rodar os testes, qual estilo seguir e quais pastas deixar em paz. Um arquivo de instruções responde a essas perguntas uma vez, em um lugar que o agente sempre lê.

Os formatos comuns

O AGENTS.md é um formato aberto feito para funcionar entre ferramentas, e é lido pelo OpenAI Codex e por muitos outros. O Claude Code lê o CLAUDE.md e também pode usar o AGENTS.md. O Cursor tem seus próprios arquivos de regras, incluindo o antigo .cursorrules. O conteúdo é parecido em todos: comandos de build e de teste, estilo de código, notas de arquitetura e coisas que não devem ser feitas.

Como funciona

O agente carrega o arquivo no seu contexto no início de uma sessão, então ele funciona como um prompt de sistema no nível do projeto. Os arquivos podem ser aninhados: um monorepo pode manter um na raiz e outro em cada pacote, e a orientação do AGENTS.md é que o arquivo mais próximo do código editado prevalece, enquanto instruções digitadas no chat se sobrepõem a todos. Um arquivo pessoal na sua pasta home pode guardar regras que valem para todos os projetos.

Limites

O arquivo é contexto, não imposição. O agente geralmente o segue, mas pode ignorá-lo ou esquecê-lo, especialmente depois de uma compactação de contexto. Regras que precisam valer sempre, como nunca mexer em uma configuração de produção, devem ficar em hooks de agente ou nas configurações de permissão. Mantenha o arquivo curto e específico; arquivos longos custam tokens a cada sessão e diluem as regras que importam. Procedimentos reutilizáveis cabem melhor em agent skills.

Termos relacionados

Agente de programação
Um agente de programação (coding agent) é um agente de IA que trabalha diretamente no software: lê uma base de código, edita arquivos, roda comandos e testes, e repete até que uma mudança funcione, em vez de apenas sugerir código para uma pessoa colar.
Context engineering
Context engineering (engenharia de contexto) é a prática de escolher e manter tudo o que entra na janela de contexto de um modelo de linguagem durante uma tarefa: instruções, documentos recuperados, definições de ferramentas, resultados de ferramentas e histórico da conversa.
Agent skills
Agent skills (habilidades de agente) são pastas de instruções, scripts e arquivos de referência, cada uma descrita por um arquivo SKILL.md, que um agente de IA pode descobrir e carregar apenas quando uma tarefa precisa delas.
Hooks de agente
Hooks de agente (ganchos) são comandos ou scripts definidos pelo usuário que um agente de programação executa automaticamente em pontos fixos do seu trabalho, como antes de uma chamada de ferramenta ou depois da edição de um arquivo, para verificar, bloquear ou ampliar o que ele faz.
System prompt
Um system prompt (prompt de sistema) é o bloco de instruções que uma aplicação envia a um modelo de linguagem antes das mensagens do usuário. Ele define o papel, as regras, o tom e o formato de saída do modelo para a conversa inteira.
Slash command
Um slash command (comando de barra) é uma instrução digitada com uma barra no início, como /compact ou /review, que diz a uma ferramenta de IA para executar uma ação embutida ou um prompt salvo em vez de tratar o texto como uma mensagem comum.

Fontes