--- title: "Gerador de AGENTS.md para cinco agentes de código · DotsAgent" description: "Preencha um formulário para gerar um AGENTS.md, a mesma regra por caminho para Cursor, Copilot, Claude Code, Cline e Devin, e arquivos de integração para Gemini CLI e Aider." url: https://dotsagent.io/pt/instructions --- Instruir · ferramenta # 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 →](https://dotsagent.io/pt/instructions/files) `AGENTS.md` ``` # 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 Uma regra em cinco formatos; salve cada arquivo no caminho indicado acima. `.cursor/rules/scoped.mdc` ``` --- 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. ``` `.github/instructions/scoped.instructions.md` ``` --- 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. ``` `.claude/rules/scoped.md` ``` --- 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. ``` `.clinerules/scoped.md` ``` --- 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. ``` `.devin/rules/scoped.md` ``` --- 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. GitHub Blog, análise de mais de 2.500 arquivos AGENTS.md ### 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. GitHub Blog, análise de mais de 2.500 arquivos AGENTS.md ### 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. Documentação de memória do Claude Code ### 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. Documentação de memória do Claude Code; documentação de Rules do Cursor ### 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. ETH Zurich SRI Lab, arXiv 2602.11988 ### 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. Documentação de Rules do Cursor; GitHub Blog ## 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. 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