---
title: "AGENTS.md: caminhos e formato · DotsAgent"
description: "Onde AGENTS.md fica, seu formato e frontmatter, como cópias globais e aninhadas são combinadas e quais ferramentas o leem. Verificado em 2026-10-01."
url: https://dotsagent.io/pt/instructions/files/agents-md
---

AGENTS.md

# AGENTS.md: onde fica e como as ferramentas o leem

AGENTS.md é um arquivo Markdown simples com instruções para o projeto, lido pela maioria dos agentes de programação sem configuração adicional. A OpenAI o apresentou à Agentic AI Foundation, da Linux Foundation, e mais de 60k projetos de código aberto o utilizam.

## Onde fica

- AGENTS.md na raiz do repositório, para todo o projeto.
- Arquivos AGENTS.md em subdiretórios ou pacotes; os agentes usam o mais próximo na árvore de diretórios.
- OpenAI Codex: um arquivo global ~/.codex/AGENTS.override.md ou, se estiver vazio ou não existir, ~/.codex/AGENTS.md.
- Cline: um arquivo global ~/.agents/AGENTS.md.
- Claude Code também aceita .claude/AGENTS.md.

## Formato

Markdown simples, sem frontmatter nem campos obrigatórios; qualquer título de seção é válido. O formato não define um limite de tamanho, mas o OpenAI Codex para de ler ao atingir project_doc_max_bytes, que é 32 KiB por padrão.

`AGENTS.md`

```
# Acme web app

Customer-facing web app with an admin area and a REST API.

## Commands

- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`

## Code style

- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.

## Never

- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
```

## Precedência e combinação

O AGENTS.md mais próximo do arquivo editado prevalece, e uma instrução explícita no chat substitui qualquer arquivo. O OpenAI Codex concatena um arquivo por diretório, da raiz do projeto até o diretório de trabalho; assim, os arquivos mais próximos ficam no final e têm prioridade. O Claude Code ignora AGENTS.md por padrão sempre que há um CLAUDE.md.

## Ferramentas que o leem

| Ferramenta | Suporte |
| --- | --- |
| [OpenAI Codex](https://developers.openai.com/codex/guides/agents-md) | Nativo. Lê um arquivo global e, em seguida, no máximo um arquivo por diretório, da raiz até o diretório de trabalho, com limite de 32 KiB por padrão. |
| [Claude Code](https://code.claude.com/docs/en/memory) | Nativo a partir da v2.1.277, mas somente quando não existe CLAUDE.md nem CLAUDE.local.md, a menos que esteja definido como claude-md-and-agents-md. |
| [Cursor](https://cursor.com/docs/context/rules) | Nativo, na raiz e em subdiretórios; os arquivos aninhados são combinados com os dos diretórios superiores, e o mais específico prevalece. |
| [GitHub Copilot (cloud agent, code review, VS Code)](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions) | Nativo em qualquer lugar do repositório; o arquivo mais próximo prevalece. |
| [Devin Desktop (formerly Windsurf)](https://docs.windsurf.com/windsurf/cascade/memories) | Nativo. O arquivo da raiz está sempre ativo; um arquivo em um subdiretório se aplica ao próprio diretório. |
| [Cline](https://docs.cline.bot/features/cline-rules) | Nativo, além de ~/.agents/AGENTS.md global; ative ou desative no painel Rules. |
| [Gemini CLI](https://geminicli.com/docs/cli/gemini-md/) | Opcional: adicione AGENTS.md a context.fileName em .gemini/settings.json. |
| [Aider](https://agents.md/) | Opcional: adicione read: AGENTS.md a .aider.conf.yml. |
| [OpenClaw](https://docs.openclaw.ai/concepts/agent) | Nativo, como arquivo obrigatório com instruções de operação no workspace do agente. |
| [Listed on agents.md (not individually re-verified)](https://github.com/agentsmd/agents.md/blob/main/components/CompatibilitySection.tsx) | Uma das 23 ferramentas listadas em agents.md, incluindo Amp, Jules, Zed, Warp, goose, opencode e JetBrains Junie; não verificamos cada uma individualmente. |

## Dicas

- Renomeando um arquivo AGENT.md antigo? agents.md sugere mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md para manter os dois nomes funcionando.
- Liste os comandos de teste e lint: os agentes tentam executar as verificações encontradas e corrigir as falhas antes de terminar.
- Em um monorepo, crie um AGENTS.md curto por pacote em vez de aumentar um único arquivo longo na raiz.
- No OpenAI Codex, um AGENTS.override.md tem prioridade sobre o AGENTS.md no mesmo diretório.

Gere um AGENTS.md e arquivos de regras correspondentes para cinco ferramentas a partir de um único formulário. [Abrir o gerador de AGENTS.md →](https://dotsagent.io/pt/instructions)

## Outros arquivos de instruções

[CLAUDE.md](https://dotsagent.io/pt/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/pt/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/pt/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/pt/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/pt/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/pt/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/pt/instructions/files/openclaw-workspace)

## Fontes

1. [agents.md](https://agents.md/)/
2. [github.com](https://github.com/agentsmd/agents.md)/agentsmd/agents.md
3. [linuxfoundation.org](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation)/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foun
4. [openai.com](https://openai.com/index/agentic-ai-foundation/)/index/agentic-ai-foundation/
5. [developers.openai.com](https://developers.openai.com/codex/guides/agents-md)/codex/guides/agents-md

Referência independente para quem cria agentes de IA. Não temos vínculo com nenhum dos fornecedores mencionados aqui.

© 2026 DotsAgent · Fatos verificados em 1 de outubro de 2026