Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

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: 
~/.config/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.

​
Nomes de arquivo compatíveis

O Devin CLI lê regras de qualquer um destes arquivos:
ArquivoObservações
AGENTS.mdRecomendado
AGENT.mdAlternativa no singular
CLAUDE.mdCompatí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.

​
Regras de Outras Ferramentas

Se você está migrando de outra ferramenta de programação com IA, o Devin CLI pode ler suas regras existentes:
O Devin CLI lê de .cursorrules e .cursor/rules/*.md.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
O Devin CLI lê de .windsurf/rules/*.md e .windsurf/global_rules.md.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
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": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}
AGENTS.md é sempre lido e não pode ser desativado.

​
Tipos de ativação de regras

Regras carregadas de formatos externos podem ter diferentes comportamentos de ativação:
TipoComportamento
Sempre ativaAtiva em todas as sessões, sem necessidade de ação do usuário
Ativada por globAtiva quando o agente trabalha com arquivos que correspondem a padrões específicos
Decidida pelo agenteO agente escolhe quando aplicá-la com base na descrição da regra
Invocável pelo usuárioAtiva 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.