Os arquivosDocumentation Index
Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
Use this file to discover all available pages before exploring further.
AGENTS.md oferecem uma forma simples de fornecer ao Cascade instruções contextualizadas que são aplicadas automaticamente com base em onde o arquivo está localizado no seu projeto. Isso é particularmente útil para definir diretrizes de codificação específicas por diretório, decisões de arquitetura ou convenções do projeto.
Como funciona
AGENTS.md (ou agents.md), o Devin Desktop o detecta automaticamente e o envia para o mesmo mecanismo de Rules usado por .windsurf/rules/ — mas com o modo de ativação inferido com base na localização do arquivo, em vez de frontmatter:
- Diretório raiz: Tratado como uma regra always-on — todo o conteúdo é incluído no prompt do sistema do Cascade em cada mensagem.
- Subdiretórios: Tratados como uma regra glob com um padrão gerado automaticamente de
<directory>/**— o conteúdo é aplicado somente quando o Cascade lê ou edita arquivos dentro desse diretório.
AGENTS.md ideal para fornecer orientações específicas sem sobrecarregar um único arquivo de configuração global.
Criando um arquivo AGENTS.md
AGENTS.md ou agents.md no diretório desejado. O arquivo usa Markdown simples, sem exigir nenhum frontmatter especial.
Estrutura de exemplo
Conteúdo de exemplo
AGENTS.md para um diretório de componentes em React:
Descoberta e escopo
AGENTS.md em todo o seu workspace:
- Varredura do workspace: Todos os arquivos
AGENTS.mdno seu workspace e em seus subdiretórios são detectados - Suporte a repositórios Git: Em repositórios Git, o Devin Desktop também procura nos diretórios pai até a raiz do repositório
- Sem diferenciar maiúsculas de minúsculas: Tanto
AGENTS.mdquantoagents.mdsão reconhecidos
Escopo automático
AGENTS.md é o escopo automático com base na localização do arquivo:
| Localização do arquivo | Escopo |
|---|---|
| Raiz do workspace | Aplica-se a todos os arquivos (sempre ativo) |
/frontend/ | Aplica-se ao trabalhar com arquivos em /frontend/** |
/frontend/components/ | Aplica-se ao trabalhar com arquivos em /frontend/components/** |
AGENTS.md em níveis diferentes, cada um fornecendo orientações cada vez mais específicas para os respectivos diretórios.
Melhores práticas
AGENTS.md:
- Mantenha as instruções focadas: Cada
AGENTS.mddeve conter instruções relevantes para a finalidade do diretório - Use formatação clara: Marcadores, cabeçalhos e blocos de código tornam as instruções mais fáceis para o Cascade seguir
- Seja específico: Exemplos concretos e convenções explícitas funcionam melhor do que orientações vagas
- Evite redundância: Não repita instruções globais em arquivos de subdiretórios; eles herdam essas instruções dos diretórios pai
Diretrizes de conteúdo
Comparação com Rules
AGENTS.md quanto Rules forneçam instruções para o Cascade, eles têm finalidades diferentes:
| Recurso | AGENTS.md | Rules |
|---|---|---|
| Localização | Nos diretórios do projeto | .windsurf/rules/ ou global |
| Escopo | Automático com base na localização do arquivo | Manual (glob, sempre ativo, decisão do modelo, manual) |
| Formato | Markdown simples | Markdown com frontmatter |
| Ideal para | Convenções específicas de diretório | Regras transversais, lógica de ativação complexa |
AGENTS.md quando quiser instruções simples baseadas na localização. Use Rules quando precisar de mais controle sobre quando e como as instruções são aplicadas.