Gerador de AGENTS.md
Preencha um formulário para gerar um AGENTS.md com seus comandos, convenções e limites inegociáveis. Você também recebe uma regra por caminho para Cursor, GitHub Copilot, Claude Code, Cline e Devin Desktop, além de arquivos de integração para ferramentas que não detectam AGENTS.md por padrão.
Onde cada ferramenta procura arquivos de instruções →
# Aplicativo web da Acme
Um aplicativo web voltado para clientes, com uma área administrativa e uma pequena API REST.
## Use esta stack
Next.js, React, TypeScript, pnpm
## Use estes comandos
- Instale: `pnpm install`
- Execute localmente: `pnpm dev`
- Teste: `pnpm test`
- Execute o lint e verifique os tipos: `pnpm lint && pnpm tsc --noEmit`
- Gere o build: `pnpm build`
## Siga o estilo de código
- Siga a formatação exigida pelo linter e deixe intactos os arquivos que não precisam de alterações.
- Prefira funções pequenas, com entradas e saídas claras; mantenha os efeitos colaterais nas bordas.
- Peça autorização antes de adicionar uma dependência.
- Comente o motivo por trás de trechos de código que não sejam óbvios, não o que cada linha faz.
## Testes
- Adicione ou atualize um teste para cada comportamento que alterar.
- Execute o comando de teste e corrija as falhas antes de dizer que terminou.
- Não exclua nem ignore um teste com falha para deixar a suíte verde.
## Commits e pull requests
- Escreva títulos de commit no imperativo, com menos de 72 caracteres.
- Limite cada pull request a uma única alteração e informe na descrição como você a testou.
- Execute o linter e os testes antes de cada commit.
## Nunca
- Nunca faça commit de segredos, chaves de API ou arquivos .env.
- Nunca edite manualmente arquivos gerados em src/generated/; gere-os novamente.
- Nunca execute comandos destrutivos de banco de dados em produção.
- Nunca force um push para main nem reescreva o histórico compartilhado.
A mesma regra para cinco ferramentas
---
description: Convenções para arquivos que correspondem a este glob
globs: app/**/*.tsx
alwaysApply: false
---
Siga os padrões já usados nos arquivos próximos desta pasta. Toda função exportada precisa de uma docstring e de um teste no arquivo de teste correspondente.
---
applyTo: "app/**/*.tsx"
---
Siga os padrões já usados nos arquivos próximos desta pasta. Toda função exportada precisa de uma docstring e de um teste no arquivo de teste correspondente.
---
paths:
- "app/**/*.tsx"
---
Siga os padrões já usados nos arquivos próximos desta pasta. Toda função exportada precisa de uma docstring e de um teste no arquivo de teste correspondente.
---
paths:
- "app/**/*.tsx"
---
Siga os padrões já usados nos arquivos próximos desta pasta. Toda função exportada precisa de uma docstring e de um teste no arquivo de teste correspondente.
---
trigger: glob
globs: app/**/*.tsx
---
Siga os padrões já usados nos arquivos próximos desta pasta. Toda função exportada precisa de uma docstring e de um teste no arquivo de teste correspondente.
O que faz um arquivo de instruções funcionar
Coloque os comandos exatos no início
Liste logo no início do arquivo os comandos reais de instalação, teste e lint, com suas flags. Especifique a stack e as versões e mostre um exemplo curto de código quando uma explicação em prosa ficar vaga.
Escreva regras explícitas sobre o que nunca fazer
Diga claramente o que o agente não deve fazer, como mexer em secrets, código de terceiros incorporado ou produção. Nunca faça commit de secrets foi a restrição útil mais comum nos arquivos analisados pelo GitHub.
Torne cada instrução verificável
Execute npm test antes de fazer commit é algo que pode ser verificado; teste suas alterações, não. Elimine contradições, pois, quando duas linhas entram em conflito, o modelo pode seguir qualquer uma delas.
Seja breve e divida por caminho
A Anthropic recomenda menos de 200 linhas por arquivo, e o Cursor, menos de 500 por regra. Mova as orientações de uma área para uma regra limitada a um caminho, para que ela seja carregada apenas quando esses arquivos estiverem em uso. Imports deixam o arquivo mais organizado, mas não reduzem o custo de contexto.
Não repita o que o agente já sabe
Em um estudo com quatro agentes de programação, os arquivos de contexto não aumentaram de forma consistente o sucesso nas tarefas e elevaram o custo de inferência em mais de 20%. Arquivos escritos por LLMs tiveram um efeito ligeiramente negativo, e visões gerais do repositório não ajudaram. Por isso, limite o arquivo a requisitos não óbvios, como ferramentas específicas.
Adicione regras quando os erros se repetirem
Comece com pouco e adicione uma linha quando perceber que o agente comete o mesmo erro mais de uma vez. Aponte para um arquivo existente como referência, em vez de colar um guia de estilo inteiro.
Perguntas sobre AGENTS.md
O Claude Code lê AGENTS.md?
Sim, a partir da v2.1.277. Por padrão, ele lê AGENTS.md ou .claude/AGENTS.md somente quando não há CLAUDE.md, .claude/CLAUDE.md ou CLAUDE.local.md no diretório de trabalho ou em algum diretório acima dele. A configuração claude-md-and-agents-md carrega ambos, e um CLAUDE.md que contenha @AGENTS.md funciona em qualquer versão.
AGENTS.md precisa de frontmatter ou de títulos específicos?
Não. AGENTS.md é um arquivo Markdown simples, sem campos obrigatórios e com os títulos que você quiser. O site agents.md sugere seções como visão geral do projeto, comandos de build e teste, estilo de código, testes, notas de segurança e diretrizes para pull requests.
Como uso AGENTS.md em um monorepo?
Coloque um AGENTS.md na raiz e outro dentro de cada pacote que precise de regras próprias. Os agentes leem o arquivo mais próximo do código que está sendo editado, e esse arquivo prevalece em caso de conflito. O repositório principal da OpenAI tinha 88 arquivos quando o agents.md documentou isso.
Como faço o Gemini CLI ler AGENTS.md?
Por padrão, o Gemini CLI ainda usa GEMINI.md. Adicione AGENTS.md a context.fileName em .gemini/settings.json, por exemplo ["AGENTS.md", "GEMINI.md"]. Execute /memory show para verificar o que foi carregado.
Quais agentes de programação oferecem suporte a AGENTS.md?
Verificamos a documentação do OpenAI Codex, Claude Code, Cursor, GitHub Copilot, Devin Desktop, Cline e OpenClaw, que leem o arquivo nativamente. Gemini CLI e Aider precisam de uma linha de configuração. O site agents.md lista 23 ferramentas compatíveis no total, incluindo Zed, Warp, goose, opencode, Jules e JetBrains Junie.
Quem mantém o formato AGENTS.md?
A OpenAI contribuiu o AGENTS.md para a Agentic AI Foundation, um fundo direcionado da Linux Foundation anunciado em 2025-12-09 junto com MCP e goose. Segundo o site agents.md, mais de 60k projetos de código aberto usam o formato.