OpenCode

A Archgate se integra com o OpenCode por meio de um pacote de agentes. O OpenCode usa um modelo nativo de agente primário/subagentes em vez do modelo de skills do Claude Code, então a Archgate adapta seus papéis de governança em um agente primário mais subagentes — todos com o prefixo archgate-. O agente primário lê os ADRs que se aplicam a uma mudança antes de programar, valida depois e orquestra os subagentes para revisão e captura.

O OpenCode trata skills como agentes

No OpenCode, cada papel de governança da Archgate é entregue como um agente, não como uma skill. O pacote instala arquivos chamados archgate-developer.md, archgate-reviewer.md e assim por diante. O prefixo archgate- evita colisões com quaisquer agentes do OpenCode criados pelo usuário no mesmo diretório. Os subagentes são invocados com a sintaxe de @-mention do OpenCode.

Referência oficial da CLI

Esta página cobre a configuração do OpenCode. Para a sintaxe exata de archgate init, archgate login e archgate plugin install, consulte a referência da CLI em cli.archgate.dev.

Requisitos

• CLI Archgate — instale pelo guia de instalação da CLI.
• OpenCode instalado e no seu PATH. A Archgate confirma que o OpenCode está presente antes de gravar arquivos no diretório de configuração dele — caso contrário os agentes ficariam onde nada os lê. Instale o OpenCode a partir de opencode.ai primeiro.
• Um login no GitHub — o pacote está em beta fechado; os downloads exigem um token autenticado de archgate login.

Instalação no escopo de usuário

Diferentemente das integrações do Claude Code ou do Cursor, os agentes do OpenCode não são gravados na árvore do seu projeto. Eles são instalados no escopo de usuário, então ficam na sua máquina e ficam disponíveis em todos os projetos que você abrir com o OpenCode.

O OpenCode segue a convenção XDG Base Directory em todas as plataformas (via o pacote xdg-basedir), então o local de instalação resolve para $XDG_CONFIG_HOME/opencode/agents/ quando definido, e recai para ~/.config/opencode/agents/ caso contrário. Note que no Windows isso fica sob .config, não %APPDATA%:

Plataforma	Local de instalação
Linux / macOS	~/.config/opencode/agents/
Windows	C:\Users\<username>\.config\opencode\agents\

.archgate/adrs/ e .archgate/lint/ ainda são criados dentro do seu projeto como de costume — apenas os arquivos de agente do OpenCode ficam fora da árvore do projeto.

Instalação

1. Faça login para obter um token de plugin:

   archgate login

2. Inicialize seu projeto com o alvo de editor OpenCode:

   archgate init --editor opencode

   Quando você está autenticado e a CLI opencode está no seu PATH, isso baixa um tarball autenticado do serviço de plugins e extrai os arquivos de agente archgate-*.md para o diretório de escopo de usuário do OpenCode. O diretório .archgate/ é criado no seu projeto ao mesmo tempo.

3. Selecione archgate-developer como seu agente primário no OpenCode (pressione Tab) ao iniciar uma tarefa de programação.

Para reinstalar ou atualizar em um projeto já inicializado, execute archgate plugin install --editor opencode. O serviço retorna o pacote mais recente em cada download autenticado. As flags completas estão no guia da CLI.

O que o pacote oferece

Agente primário

archgate-developer

O agente de desenvolvimento geral, selecionável com Tab. Ele lê os ADRs antes de programar, valida depois e orquestra os subagentes automaticamente. Na maior parte do tempo você só precisa selecionar este e deixá-lo trabalhar.

Subagentes

Invoque-os com @-mention quando precisar de um papel específico sob demanda:

@archgate-reviewer

Valida mudanças de código contra todos os ADRs do projeto usando sub-agentes focados em domínio. Violações de ADRs são bloqueios definitivos.

@archgate-adr-author

Cria e edita ADRs seguindo as convenções do seu projeto.

@archgate-lessons-learned

Revisa a cobertura de regras e propõe novos ADRs quando padrões emergem.

archgate-cli-reference

Um subagente interno oculto que carrega o guia completo de comandos da CLI Archgate sob demanda.

O pacote também inclui um agente archgate-planner para trabalho voltado a planejamento. Esses são os mesmos papéis disponíveis no plugin do Claude Code, adaptados ao modelo nativo de agente primário/subagentes do OpenCode. Consulte Skills e Agentes para a referência dos papéis.

O fluxo de trabalho na prática

Selecione archgate-developer no início de uma sessão. Para cada mudança ele segue um ciclo estruturado:

1. Ler os ADRs aplicáveis — executa archgate review-context para ver quais ADRs se aplicam aos arquivos sendo alterados. Ele não escreve código até tê-los lido.
2. Escrever código seguindo as restrições — implementa a mudança seguindo os “O que fazer” e “O que não fazer” aplicáveis.
3. Executar verificações de conformidade — executa archgate check e corrige qualquer violação antes de prosseguir.
4. Revisar — menciona @archgate-reviewer para validar a conformidade estrutural além do que as regras automatizadas detectam.
5. Capturar aprendizados — menciona @archgate-lessons-learned para identificar padrões que valem ser capturados como ADRs novos ou atualizados.

Quando uma tarefa exigiria violar um ADR, archgate-developer recusa, cita o ADR e a restrição relevante e sugere uma alternativa em conformidade. Esse comportamento é consistente independentemente de como o pedido é formulado — os ADRs são restrições obrigatórias, não sugestões.

Consequências do escopo de usuário

Como o pacote fica no seu diretório de escopo de usuário do OpenCode em vez de em .opencode/ dentro do seu projeto:

• Uma instalação por máquina. Todo projeto que você abre com o OpenCode vê os mesmos agentes archgate-*.
• Seu repositório permanece limpo. Nenhuma pasta .opencode/ é criada pelo archgate init. Os colegas de equipe executam o próprio archgate plugin install --editor opencode.
• As atualizações são globais. Reexecutar a instalação sobrescreve os arquivos existentes com o pacote mais recente.

Próximos passos

Todos os plugins de editor Compare os seis editores suportados e o que cada um oferece.

Agentes Os agentes primário e de planejamento que conduzem o fluxo de trabalho.

CLI: integração com OpenCode Configuração, flags e detalhes de resolução de caminhos oficiais.