OpenCode: OpenCode AGENTS.md Configuration

Última atualização: 2026-08-31

--- title: Regras do OpenCode (AGENTS.md) description: Aprenda a escrever arquivos AGENTS.md definindo restrições de comportamento da IA no seu projeto order: 12 lang: pt-br

AGENTS.md é o arquivo de regras em nível de projeto do OpenCode que define restrições de comportamento da IA para o projeto atual.

1. O Que Você Vai Aprender

Propósito e posicionamento do AGENTS.md
Métodos de criação do arquivo
Técnicas de escrita de regras
Melhores práticas

2. O Que é o AGENTS.md

AGENTS.md é um arquivo Markdown no diretório raiz do projeto. A IA lê e segue suas regras automaticamente ao trabalhar.

Aspecto	Detalhes
Localização	Diretório raiz do projeto
Formato	Markdown
Escopo	Apenas o projeto atual
Carregamento automático	A IA lê automaticamente ao iniciar

3. Criando AGENTS.md

Comando TUI: /init (gera automaticamente com base na estrutura do projeto)

Ou crie manualmente um arquivo AGENTS.md na raiz do projeto.

4. Escrita de Regras

Estrutura Básica

MARKDOWN

# Regras do Projeto

## Padrões de Codificação
- Use TypeScript strict mode
- Siga a configuração ESLint
- Comprimento máximo de função: 50 linhas

## Requisitos de Teste
- Todas as novas funções devem ter testes unitários
- Cobertura de testes não inferior a 80%

## Padrões de Commit
- Use formato Conventional Commits
- Cada commit faz apenas uma coisa

Categorias de Regras

Categoria	Exemplos
Padrões de codificação	Estilo de código, regras de nomenclatura, requisitos de tipo
Restrições de arquitetura	Estrutura de diretórios, limites de módulos
Requisitos de teste	Cobertura, tipos de teste, nomenclatura
Padrões de commit	Formato, nomenclatura de branches, regras de PR
Regras de segurança	Proibir chaves hardcoded, validação de entrada
Lógica de negócios	Regras de domínio, processamento de dados

5. Melhores Práticas

Regras devem ser específicas: "Máx. 50 linhas por função" não "escreva bom código"
Regras devem ser executáveis: "Proibir API keys hardcoded" não "cuidado com segurança"
Priorize regras: Distinga obrigatórias de recomendadas e opcionais
Compartilhe com a equipe: Commite o AGENTS.md no Git, mantenha coletivamente

6. AGENTS.md vs opencode.json

Aspecto	AGENTS.md	opencode.json
Formato	Markdown	JSON
Audiência	IA + humanos	Programa OpenCode
Conteúdo	Regras de comportamento, padrões de codificação	Parâmetros de configuração, permissões de ferramentas
Efeito	Consultivo	Obrigatório

Eles se complementam: AGENTS.md diz à IA "o que fazer", opencode.json controla "o que pode fazer".

❓ FAQ

P: A IA sempre seguirá as regras do AGENTS.md?

R: Não garantido. AGENTS.md é consultivo — a IA tenta seguir mas não é forçado. Para regras obrigatórias, use a configuração de permissões do opencode.json.

P: AGENTS.md em subdiretórios funciona?

R: Não. Apenas o AGENTS.md do diretório raiz é lido pela IA.

P: Alice tem 100 linhas, Bob tem 5. Quem tem melhores resultados?

R: Nem sempre mais é melhor. 5 regras precisas podem ser mais eficazes que 100 vagas. Qualidade sobre quantidade.

📖 Resumo

AGENTS.md é o arquivo de regras do projeto para a IA
Crie com /init ou manualmente
Regras devem ser específicas, executáveis, priorizadas
Complementa opencode.json: regras + permissões
Commite no Git para colaboração da equipe

📝 Exercícios

Básico: Crie um AGENTS.md com pelo menos 5 padrões de codificação.
Intermediário: Defina regras completas de fluxo de desenvolvimento (código→teste→commit) e faça o OpenCode segui-las.
Avançado: Compare a saída do OpenCode com e sem AGENTS.md, quantificando o impacto das regras.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós