Ir para o conteúdo
Arara Code

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 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

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

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

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

Fontes e leitura complementar

Ler em Markdown

Continue explorando

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.