O que são os plugins de editor do Archgate, o modelo de agente e skills que eles instalam e como conectam seu agente de codificação por IA aos seus ADRs e verificações de conformidade.
A CLI archgate aplica a governança de forma determinística — ela lê ADRs e roda verificações em qualquer lugar, totalmente offline. Mas a CLI é um conjunto de capacidades passivas: ela pode dizer a um agente quais ADRs se aplicam e se o código passa, mas nada na CLI diz a um agente de IA quando ler decisões ou como validar o próprio trabalho. Essa orquestração é o que os plugins de editor adicionam.
Um plugin conecta o loop de governança ao seu agente de codificação por IA. Com um plugin instalado, seu agente lê os ADRs aplicáveis antes de escrever código, valida depois e captura novos padrões — sem que você copie e cole regras nos prompts ou se lembre de rodar verificações.
Seis editores, um modelo de governança
Seção intitulada “Seis editores, um modelo de governança”O Archgate fornece plugins para seis superfícies de codificação por IA — Claude Code, Cursor, VS Code, Copilot CLI, Claude Desktop e OpenCode. O modelo de governança é o mesmo em todos eles; cada plugin adapta o mecanismo de invocação ao seu editor hospedeiro. A visão geral dos plugins os compara lado a lado.
O que um plugin instala
Seção intitulada “O que um plugin instala”Todo plugin do Archgate instala os mesmos dois tipos de papéis de governança:
- Agentes — os orquestradores. O agente developer conduz o fluxo de trabalho completo (ler ADRs → escrever código → validar → capturar) e recusa tarefas que violariam um ADR. O agente planner, somente leitura, projeta abordagens em conformidade com os ADRs sem escrever código.
- Skills — capacidades focadas que o agente invoca em pontos específicos:
reviewervalida,lessons-learnedcaptura,adr-authorescreve ADRs,onboardinicializa um projeto ecli-referencecarrega a sintaxe autoritativa dos comandos sob demanda.
O modelo de contexto de sessão
Seção intitulada “O modelo de contexto de sessão”Os plugins se conectam ao Archgate por meio de comandos da CLI que fornecem ao agente exatamente o contexto de que ele precisa, quando ele precisa. Dois comandos são centrais:
archgate review-context— a entrada de prevenção e detecção. Ele retorna briefings condensados de ADR (a Decisão e o Faça e Não Faça de cada ADR aplicável), agrupados por domínio e restritos aos arquivos sendo alterados. Em vez de carregar cada ADR de 100–400 linhas no contexto do agente, o agente recebe um briefing focado de ~10–20 linhas por decisão relevante. Ele também pode incluir os resultados de verificações automatizadas na mesma chamada.archgate session-context— a entrada de aprendizado. Ele lê do disco a própria transcrição da sessão do editor para que a skill lessons-learned possa revisar o que de fato aconteceu durante uma sessão — as solicitações, os erros e as alterações que uma compactação de contexto anterior pode ter descartado — e codificar lições duráveis a partir disso.
Esse modelo de contexto de sessão é o motivo pelo qual o loop sobrevive a sessões longas e a fronteiras entre sub-agentes: o agente sempre recupera o quadro completo e preciso a partir da CLI, em vez de depender do que por acaso permaneceu em sua janela de conversa. Todos esses comandos rodam localmente e leem diretamente do seu projeto — nenhum dado de governança sai da sua máquina.
Instalando e obtendo acesso
Seção intitulada “Instalando e obtendo acesso”Os plugins são instalados por meio da CLI (archgate init os conecta durante a configuração do projeto, ou archgate plugin install os adiciona a um projeto existente) e são distribuídos de forma privada pelo serviço de plugins do Archgate, em vez de um registro de pacotes público. A visão geral dos plugins e os guias por editor explicam a configuração, e os comandos de instalação autoritativos vivem na documentação da CLI.