Source: https://arara.code.app.br/artigos/agents-md-regras-para-agentes-de-ia
Language: pt-BR
Published: 2026-11-16T08:00:00-03:00

Guias e comparativos

# AGENTS.md: como guiar agentes de IA no repositório

AGENTS.md é um padrão aberto em Markdown colocado na raiz do repositório para fornecer instruções previsíveis a agentes de código. Ele funciona como um README voltado a IAs, unificando comandos de build, testes, estilo e restrições em um único arquivo compatível com múltiplas ferramentas.

Arara Code

Publicado e com fontes conferidas em 16 de novembro de 2026.

Publicado pelo projeto Arara Code com base na documentação oficial citada.

## Por que o padrão AGENTS.md surgiu

Antes do AGENTS.md, cada ferramenta exigia seu próprio arquivo de regras — como .cursorrules, CLAUDE.md ou instruções específicas por extensão — gerando duplicação e divergência em equipes que usam mais de um assistente.

Com o padrão aberto mantido em agents.md, um único arquivo descreve como o projeto funciona e passa a ser lido por diferentes agentes como OpenAI Codex, Claude Code, Gemini, GitHub Copilot e Cursor.

[AGENTS.md: especificação oficial do padrão aberto](https://agents.md/)

## O que colocar dentro do AGENTS.md

Como não exige schema rígido, o arquivo usa seções simples em Markdown: comandos de instalação e desenvolvimento, scripts obrigatórios de typecheck e testes, convenções de arquitetura e regras explícitas do que o agente nunca deve alterar.

Em monorepos grandes, você também pode criar arquivos AGENTS.md aninhados em subpastas para dar contexto específico por pacote sem poluir toda a sessão.

[GitHub: repositório oficial agentsmd/agents.md](https://github.com/agentsmd/agents.md)

Relacionado

[MCP (Model Context Protocol): o que é e como usarEntenda o que é MCP (Model Context Protocol), como funcionam servidores, ferramentas e transportes, os cuidados de segurança e como usar no Arara Code.](https://arara.code.app.br/artigos/o-que-e-mcp)

## Menos alucinações e economia de tokens

Ao informar logo no início quais comandos validam o build e onde vivem os módulos principais, o agente evita loops exploratórios caros tentando adivinhar scripts do package.json.

Isso reduz erros de comando, mantém o estilo consistente entre pull requests e melhora a previsibilidade de entregas automatizadas.

[AGENTS.md: especificação oficial do padrão aberto](https://agents.md/)

## AGENTS.md funcionando no Arara Code

O Arara Code respeita o AGENTS.md do seu workspace e aplica suas regras de projeto de forma consistente, independentemente de você estar usando Claude Code, Codex, Kiro ou Antigravity.

Assim, toda a equipe mantém o mesmo padrão de qualidade mesmo quando cada pessoa escolhe seu agente favorito dentro da IDE.

[Arara Code: repositório público da IDE](https://github.com/arara-ide/arara-code)

## Fontes e leitura complementar

- [AGENTS.md: especificação oficial do padrão aberto](https://agents.md/)
- [GitHub: repositório oficial agentsmd/agents.md](https://github.com/agentsmd/agents.md)
- [Arara Code: repositório público da IDE](https://github.com/arara-ide/arara-code)

[Ler em Markdown](https://arara.code.app.br/artigos/agents-md-regras-para-agentes-de-ia.md)

## Continue explorando

### [Engenharia de contexto em IA: como estruturar código](https://arara.code.app.br/artigos/engenharia-de-contexto-em-ia)

Aprenda o que é engenharia de contexto no desenvolvimento com IA, por que janelas gigantes falham e como organizar arquivos para respostas precisas.

[Ler o guia](https://arara.code.app.br/artigos/engenharia-de-contexto-em-ia)

### [Desenvolvimento orientado a especificações (SDD)](https://arara.code.app.br/artigos/desenvolvimento-orientado-a-especificacoes)

Entenda como o desenvolvimento orientado a especificações substitui prompts improvisados por contratos claros antes de gerar código com IA.

[Ler o guia](https://arara.code.app.br/artigos/desenvolvimento-orientado-a-especificacoes)

## Dê espaço à sua próxima ideia.

Conheça o Arara Code no seu próprio projeto. Comece pelo instalador e revise as mudanças que seu assistente fizer.

Baixar Arara Code
