Rules

Defina instruções personalizadas para o opencode.

Você pode fornecer instruções personalizadas ao opencode criando um arquivo AGENTS.md. Isso é similar às rules do Cursor. Ele contém instruções que serão incluídas no contexto do LLM para personalizar seu comportamento para seu projeto específico.

Inicializar

Para criar um novo arquivo AGENTS.md, você pode executar o comando /init no opencode.

Dica: Você deve fazer commit do arquivo AGENTS.md do seu projeto no Git.

Isso irá escanear seu projeto e todo seu conteúdo para entender do que se trata o projeto e gerar um arquivo AGENTS.md com isso. Isso ajuda o opencode a navegar melhor pelo projeto.

Se você já tem um arquivo AGENTS.md existente, ele tentará adicionar a ele.

Exemplo

Você também pode simplesmente criar este arquivo manualmente. Aqui está um exemplo de algumas coisas que você pode colocar em um arquivo AGENTS.md.

Estamos adicionando instruções específicas do projeto aqui e isso será compartilhado com sua equipe.

Tipos

O opencode também suporta ler o arquivo AGENTS.md de múltiplas localizações. E isso serve para diferentes propósitos.

Projeto

Coloque um AGENTS.md na raiz do seu projeto para regras específicas do projeto. Estas só se aplicam quando você está trabalhando neste diretório ou seus subdiretórios.

Global

Você também pode ter regras globais em um arquivo ~/.config/opencode/AGENTS.md. Isso é aplicado a todas as sessões do opencode.

Como isso não é commitado no Git ou compartilhado com sua equipe, recomendamos usar isso para especificar quaisquer regras pessoais que o LLM deve seguir.

Compatibilidade com Claude Code

Para usuários migrando do Claude Code, o OpenCode suporta as convenções de arquivos do Claude Code como alternativas:

• Regras de projeto: CLAUDE.md no seu diretório de projeto (usado se não existir AGENTS.md)
• Regras globais: ~/.claude/CLAUDE.md (usado se não existir ~/.config/opencode/AGENTS.md)
• Skills: ~/.claude/skills/ — veja Agent Skills para detalhes

Para desabilitar a compatibilidade com Claude Code, defina uma destas variáveis de ambiente:

Precedência

Quando o opencode inicia, ele procura arquivos de regras nesta ordem:

• Arquivos locais percorrendo para cima a partir do diretório atual (AGENTS.md, CLAUDE.md)
• Arquivo global em ~/.config/opencode/AGENTS.md
• Arquivo do Claude Code em ~/.claude/CLAUDE.md (a menos que desabilitado)

O primeiro arquivo correspondente vence em cada categoria. Por exemplo, se você tem tanto AGENTS.md quanto CLAUDE.md, apenas AGENTS.md é usado. Da mesma forma, ~/.config/opencode/AGENTS.md tem precedência sobre ~/.claude/CLAUDE.md.

Instruções personalizadas

Você pode especificar arquivos de instruções personalizadas no seu opencode.json ou no global ~/.config/opencode/opencode.json. Isso permite que você e sua equipe reutilizem regras existentes em vez de ter que duplicá-las no AGENTS.md.

Exemplo:

Você também pode usar URLs remotas para carregar instruções da web.

Instruções remotas são buscadas com um timeout de 5 segundos.

Todos os arquivos de instruções são combinados com seus arquivos AGENTS.md.

Referenciar arquivos externos

Enquanto o opencode não analisa automaticamente referências de arquivos no AGENTS.md, você pode alcançar funcionalidade similar de duas maneiras:

Usando opencode.json

A abordagem recomendada é usar o campo instructions no opencode.json:

Instruções manuais no AGENTS.md

Você pode ensinar o opencode a ler arquivos externos fornecendo instruções explícitas no seu AGENTS.md. Aqui está um exemplo prático:

Esta abordagem permite que você:

• Crie arquivos de regras modulares e reutilizáveis
• Compartilhe regras entre projetos via symlinks ou submódulos git
• Mantenha o AGENTS.md conciso enquanto referencia diretrizes detalhadas
• Garanta que o opencode carrega arquivos apenas quando necessário para a tarefa específica

Dica: Para monorepos ou projetos com padrões compartilhados, usar opencode.json com padrões glob (como packages/*/AGENTS.md) é mais manutenível do que instruções manuais.