Regras e AGENTS.md

As regras são instruções persistentes que definem como o Devin CLI se comporta no seu projeto. Elas são injetadas no contexto do agente no início de cada sessão, garantindo um comportamento consistente em toda a equipe. Os usos mais comuns das regras incluem padrões de código, diretrizes de arquitetura, bibliotecas preferidas, convenções de testes e restrições específicas do projeto. Para melhorar a capacidade de programação, agilizar a conclusão e reduzir custos, recomendamos fortemente usar Skills sempre que possível. As Skills só são injetadas no contexto quando relevantes. Regras e AGENTS devem ser mantidos o mais enxutos possível. O padrão que recomendamos é usar uma regra para fazer referência a skills que o modelo deve usar em cenários específicos.

AGENTS.md

A maneira mais simples de adicionar regras é usar um arquivo AGENTS.md na raiz do seu projeto:

# Regras do Projeto

- Use TypeScript para todos os novos arquivos
- Siga os padrões existentes em src/components/
- Sempre execute `npm run lint` antes de fazer commit
- Use pnpm, não npm ou yarn
- Escreva testes para todas as novas funções utilitárias

O Devin CLI lê este arquivo automaticamente.

AGENTS.md é a forma recomendada de definir regras do projeto. É fácil de ler, fica em controle de versão e funciona em várias ferramentas de IA.

Regras globais

Você também pode criar regras que se aplicam a todos os projetos adicionando um arquivo AGENTS.md ao diretório de configuração do usuário:

Linux / macOS
Windows

~/.config/devin/AGENTS.md

%APPDATA%\devin\AGENTS.md

As regras globais são carregadas no início de cada sessão, independentemente do projeto em que você estiver trabalhando. Use-as para preferências pessoais que se aplicam em qualquer lugar:

# My Global Rules

- Always write commit messages in conventional commit format
- Prefer functional patterns over imperative code
- Run tests before suggesting a task is complete

As regras globais funcionam junto com as regras do projeto — ambas são carregadas e ficam ativas ao mesmo tempo. AGENT.md também é aceito nesse local.

Se você usa Claude Code, o Devin CLI também lê ~/.claude/CLAUDE.md como regra global.

Regras pessoais com AGENTS.local.md

Se você tiver instruções pessoais que não devam ser compartilhadas com colaboradores — como seu estilo de trabalho preferido, práticas de teste ou preferências de revisão — crie um arquivo AGENTS.local.md ao lado do seu AGENTS.md:

# Minhas Regras Pessoais

- Sempre comece escrevendo testes com falha antes de implementar uma correção
- Prefira padrões funcionais em vez de código imperativo
- Execute o conjunto completo de testes antes de marcar uma tarefa como concluída

Este arquivo é carregado junto com AGENTS.md e tem o mesmo comportamento sempre ativo. Adicione-o ao seu .gitignore para que permaneça local:

AGENTS.local.md

Isso segue a mesma convenção de .devin/config.local.json — o sufixo .local. indica um override pessoal que não deve ser comitado.

Nomes de arquivo compatíveis

O Devin CLI lê regras de qualquer um destes arquivos:

Arquivo	Observações
`AGENTS.md`	Recomendado
`AGENTS.local.md`	Regras pessoais (gitignored)
`AGENT.md`	Alternativa no singular
`.windsurfrules`	Regras de workspace do Legacy Windsurf
`CLAUDE.md`	Compatível com Claude Code

Todos eles recebem o mesmo tratamento — seu conteúdo é carregado como regras sempre ativas. Esses arquivos podem existir em vários níveis do seu projeto (não apenas na raiz). Os arquivos na raiz do workspace são carregados no início da sessão. Os arquivos em subdiretórios são descobertos sob demanda quando o agente acessa arquivos nesse diretório, mantendo o contexto focado na parte relevante da base de código. Eles também podem ser colocados no diretório de configuração global para se aplicar a todos os projetos, exceto CLAUDE.md, que é lido globalmente em ~/.claude/CLAUDE.md. plugins instalados também podem incluir regras: um AGENTS.md sempre ativo na raiz do plugin, além de arquivos rules/*.md com frontmatter trigger.

Regras no diretório .devin

O Devin CLI também lê regras do diretório .devin/, com uma regra por arquivo:

Caminho	Observações
`.devin/rules/*.md`	Uma regra por arquivo. Oferece suporte ao frontmatter `trigger`
`.devin/global_rules.md`	Arquivo único sempre ativo

Esses arquivos usam o mesmo frontmatter de .windsurf/rules/*.md, portanto, os valores de trigger always_on, manual, model_decision, agent e glob também se aplicam. .devin/ é o local preferencial e tem precedência sobre .windsurf/. Se existirem .devin/global_rules.md e .windsurf/global_rules.md, o Devin CLI carregará apenas .devin/global_rules.md. Os arquivos de regras em .devin/rules/ e .windsurf/rules/ são carregados. Assim como outras regras de projeto, esses diretórios são lidos na raiz do workspace e em cada diretório entre a raiz do workspace e o diretório atual. Você também pode colocá-los no seu diretório pessoal (~/.devin/rules/*.md, ~/.devin/global_rules.md) para aplicá-los a todos os projetos.

Regras de Outras Ferramentas

Se você está migrando de outra ferramenta de programação com IA, o Devin CLI pode ler suas regras existentes:

Cursor

O Devin CLI lê de .cursor/rules/*.md e .cursor/rules/*.mdc.As regras do Cursor oferecem suporte a frontmatter para controlar a ativação:

---
description: "React component guidelines"
globs: "src/components/**/*.tsx"
alwaysApply: false
---

Use functional components with hooks. Never use class components.

Comportamento de ativação:

alwaysApply: true — Sempre ativa
globs especificado — Ativa ao trabalhar com arquivos correspondentes
Apenas description — O agente decide quando aplicar
Nenhum dos itens acima — O usuário deve acionar manualmente

Windsurf

O Devin CLI lê de .windsurf/rules/*.md e .windsurf/global_rules.md. Os equivalentes nativos do Devin em .devin/ têm precedência.Suporte a subdiretórios: os diretórios .windsurf/rules/ podem existir em vários níveis do seu projeto, não apenas na raiz. As regras na raiz do workspace são carregadas no início da sessão. As regras em subdiretórios são descobertas sob demanda — quando o agente acessa arquivos nesse diretório, qualquer .windsurf/rules/ encontrado ali (e nos diretórios pai até a raiz do workspace) é carregado automaticamente. Isso evita poluir o contexto do agente com regras de partes não relacionadas do projeto.As regras do Windsurf oferecem suporte a frontmatter:

---
description: "API design rules"
trigger: always_on
---

All API endpoints must return JSON with a consistent envelope format.

Valores de trigger: always_on, manual, model_decision, agent, glob

Claude Code

O Devin CLI lê do diretório .claude/.

O Devin CLI não oferece suporte a arquivos .codeiumignore. Se você usa o preenchimento automático do Codeium e configurou padrões de exclusão, esses padrões não se aplicarão ao Devin CLI.

Controle de importações

Você pode ativar ou desativar a leitura de formatos específicos de ferramentas no seu arquivo de configuração (~/.config/devin/config.json — ou %APPDATA%\devin\config.json no Windows — ou .devin/config.json):

{
  "read_config_from": {
    "agents_standard": true,
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}

As regras padrão do projeto em AGENTS.md, AGENTS.local.md, AGENT.md e .windsurfrules são lidas por padrão. Defina "agents_standard": false para desativar a importação dessas regras.

Tipos de ativação de regras

Regras carregadas de formatos externos podem ter diferentes comportamentos de ativação:

Tipo	Comportamento
Sempre ativa	Ativa em todas as sessões, sem necessidade de ação do usuário
Ativada por glob	Ativa quando o agente trabalha com arquivos que correspondem a padrões específicos
Decidida pelo agente	O agente escolhe quando aplicá-la com base na descrição da regra
Invocável pelo usuário	Ativa somente quando explicitamente acionada pelo usuário

As regras de AGENTS.md são sempre “sempre ativas”.

Boas práticas

Mantenha as regras concisas

Regras longas e verbosas dispersam a atenção do agente. Foque no que é mais importante.

Seja específico

“Use pnpm” é melhor do que “use o gerenciador de pacotes correto”. Instruções concretas são mais fáceis de seguir.

Inclua exemplos

Mostre o padrão que você quer, não apenas descreva-o.

Mantenha-as sob controle de versão

Mantenha as regras no seu repo para que toda a equipe se beneficie das mesmas diretrizes.

Para a maioria dos tipos comuns de regras, considere usar skills. Elas dão a você mais controle sobre quando e como são aplicadas.

Primeiros passos

Integrações do Editor

Extensibilidade

Enterprise

Referência

Changelog

AGENTS.md

Regras globais

Regras pessoais com AGENTS.local.md

Nomes de arquivo compatíveis

Regras no diretório .devin

Regras de Outras Ferramentas

Controle de importações

Tipos de ativação de regras

Boas práticas

Mantenha as regras concisas

Seja específico

Inclua exemplos

Mantenha-as sob controle de versão

​AGENTS.md

​Regras globais

​Regras pessoais com AGENTS.local.md

​Nomes de arquivo compatíveis

​Regras no diretório .devin

​Regras de Outras Ferramentas

​Controle de importações

​Tipos de ativação de regras

​Boas práticas

Mantenha as regras concisas

Seja específico

Inclua exemplos

Mantenha-as sob controle de versão

AGENTS.md

Regras globais

Regras pessoais com AGENTS.local.md

Nomes de arquivo compatíveis

Regras no diretório .devin

Regras de Outras Ferramentas

Controle de importações

Tipos de ativação de regras

Boas práticas