> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AGENTS.md

> Crie arquivos AGENTS.md para fornecer instruções com escopo por diretório ao Cascade. As instruções são aplicadas automaticamente com base na localização do arquivo no seu projeto.

Os arquivos `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.

<div id="how-it-works">
  ## Como funciona
</div>

Quando você cria um arquivo `AGENTS.md` (ou `agents.md`), o Devin Desktop o detecta automaticamente e o envia para o mesmo mecanismo de [Rules](/pt-BR/desktop/cascade/memories#rules) usado por `.devin/rules/` (e pelo `.windsurf/rules/` legado) — 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.

Esse escopo baseado na localização torna o `AGENTS.md` ideal para fornecer orientações específicas sem sobrecarregar um único arquivo de configuração global.

<div id="creating-an-agentsmd-file">
  ## Criando um arquivo AGENTS.md
</div>

Basta criar um arquivo chamado `AGENTS.md` ou `agents.md` no diretório desejado. O arquivo usa Markdown simples, sem exigir nenhum frontmatter especial.

<div id="example-structure">
  ### Estrutura de exemplo
</div>

```
my-project/
├── AGENTS.md                    # Instruções globais para todo o projeto
├── frontend/
│   ├── AGENTS.md                # Instruções específicas para o código frontend
│   └── src/
│       └── components/
│           └── AGENTS.md        # Instruções específicas para os componentes
├── backend/
│   └── AGENTS.md                # Instruções específicas para o código backend
└── docs/
    └── AGENTS.md                # Instruções para a documentação
```

<div id="example-content">
  ### Conteúdo de exemplo
</div>

Aqui está um exemplo de arquivo `AGENTS.md` para um diretório de componentes em React:

```markdown theme={null}
# Component Guidelines

When working with components in this directory:

- Use functional components with hooks
- Follow the naming convention: ComponentName.tsx for components, useHookName.ts for hooks
- Each component should have a corresponding test file: ComponentName.test.tsx
- Use CSS modules for styling: ComponentName.module.css
- Export components as named exports, not default exports

## File Structure

Each component folder should contain:
- The main component file
- A test file
- A styles file (if needed)
- An index.ts for re-exports
```

<div id="discovery-and-scoping">
  ## Descoberta e escopo
</div>

O Devin Desktop detecta automaticamente arquivos `AGENTS.md` em todo o seu workspace:

* **Varredura do workspace**: Todos os arquivos `AGENTS.md` no 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.md` quanto `agents.md` são reconhecidos

<div id="automatic-scoping">
  ### Escopo automático
</div>

O principal benefício do `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/**` |

Isso significa que você pode ter vários arquivos `AGENTS.md` em níveis diferentes, cada um fornecendo orientações cada vez mais específicas para os respectivos diretórios.

<div id="best-practices">
  ## Melhores práticas
</div>

Para aproveitar ao máximo os arquivos `AGENTS.md`:

* **Mantenha as instruções focadas**: Cada `AGENTS.md` deve 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

<div id="content-guidelines">
  ### Diretrizes de conteúdo
</div>

```markdown theme={null}
# Bom Exemplo
- Use TypeScript strict mode
- All API responses must include error handling
- Follow REST naming conventions for endpoints

# Exemplo Menos Eficaz
- Write good code
- Be careful with errors
- Use best practices
```

<div id="comparison-with-rules">
  ## Comparação com Rules
</div>

Embora tanto `AGENTS.md` quanto [Rules](/pt-BR/desktop/cascade/memories#rules) forneçam instruções para o Cascade, eles têm finalidades diferentes:

| Recurso     | AGENTS.md                                     | Rules                                                    |
| ----------- | --------------------------------------------- | -------------------------------------------------------- |
| Localização | Nos diretórios do projeto                     | `.devin/rules/` (ou legado `.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         |

Use `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.