Plugin para Copilot CLI

O plugin Archgate para Copilot CLI oferece aos agentes de IA que trabalham no GitHub Copilot CLI um fluxo de governança estruturado. Os agentes leem seus ADRs antes de escrever código, validam depois e capturam novos padrões para a equipe — o mesmo fluxo disponível no plugin para Claude Code.

Como funciona

O Copilot CLI suporta instalação de plugins a partir de repositórios git usando copilot plugin install. O plugin Archgate é servido a partir de um repositório git em plugins.archgate.dev/archgate.git, que o Copilot CLI reconhece nativamente — o mesmo formato de manifesto .claude-plugin/plugin.json funciona tanto para o Claude Code quanto para o Copilot CLI.

Instalação

Acesso beta necessário

O plugin para Copilot CLI está atualmente em beta. Cadastre-se em plugins.archgate.dev para obter acesso antes de seguir os passos abaixo.

1. Faça login com o GitHub

Autentique-se com sua conta do GitHub para obter um token do plugin:

archgate login

Isso inicia um GitHub Device Flow. O CLI exibe um código único e uma URL — abra a URL no seu navegador, insira o código e autorize. Ao concluir, as credenciais são armazenadas em ~/.archgate/credentials.

2. Inicialize seu projeto com o plugin

Execute archgate init com a flag --editor copilot:

archgate init --editor copilot

Se você já estiver logado e o CLI copilot estiver no seu PATH, o plugin é instalado automaticamente via:

copilot plugin install https://<github-user>:<token>@plugins.archgate.dev/archgate.git

Se o CLI copilot não for encontrado, o comando exibe o comando manual para você executar.

Para solicitar explicitamente a instalação do plugin:

archgate init --editor copilot --install-plugin

Para instalar ou reinstalar o plugin em um projeto já inicializado:

archgate plugin install --editor copilot

Arquivos gerados

O comando cria o diretório .github/copilot/ para configuração do plugin. A instalação do plugin é feita separadamente via o comando copilot plugin install.

Instalação manual

Se o CLI copilot não for encontrado durante archgate init, você pode instalar o plugin manualmente:

copilot plugin install https://<github-user>:<token>@plugins.archgate.dev/archgate.git

Você pode encontrar sua URL autenticada executando archgate login e verificando ~/.archgate/credentials.

O que o plugin oferece

O plugin adiciona um agente e skills baseadas em papéis ao Copilot CLI. O agente orquestra o fluxo de governança, invocando skills conforme necessário.

Agente

Agente	Propósito
archgate:developer	Agente de desenvolvimento geral que lê ADRs antes de codificar e valida depois

O agente archgate:developer é definido como agente padrão via as configurações do plugin. Ele orquestra as skills abaixo automaticamente como parte do seu fluxo.

Skills

Skill	Propósito
archgate:architect	Valida alterações de código contra todos os ADRs do projeto para conformidade estrutural
archgate:quality-manager	Revisa a cobertura de regras e propõe novos ADRs quando padrões emergem
archgate:adr-author	Cria e edita ADRs seguindo as convenções do projeto
archgate:onboard	Configuração única: explora o codebase, entrevista o desenvolvedor e cria os ADRs iniciais

Configuração inicial com onboard

Após a instalação, execute a skill archgate:onboard no seu projeto uma vez. Essa skill:

1. Explora a estrutura do seu codebase (diretórios, arquivos-chave, configuração de pacotes)
2. Entrevista você sobre as convenções, restrições e decisões arquiteturais da sua equipe
3. Cria um conjunto inicial de ADRs com base nas suas respostas
4. Configura o diretório .archgate/ com suas primeiras regras

A skill de onboard foi projetada para ser executada uma vez por projeto. Após o onboarding, as outras skills cuidam do desenvolvimento no dia a dia.

Como funciona na prática

O plugin segue um fluxo estruturado para cada tarefa de codificação:

1. Ler os ADRs aplicáveis

Quando o desenvolvedor atribui uma tarefa de codificação, o agente executa archgate review-context para ler todos os ADRs que se aplicam aos arquivos sendo alterados. Isso fornece um resumo condensado com as seções Decision e Do’s and Don’ts de cada ADR relevante.

2. Escrever código seguindo as restrições dos ADRs

O agente escreve código que cumpre as restrições dos ADRs. As seções Do’s and Don’ts servem como guardrails concretos.

3. Validar as alterações

Após escrever o código, o agente executa archgate check para rodar as regras automatizadas contra as alterações. Qualquer violação é corrigida antes de prosseguir.

4. Revisão do arquiteto

O agente invoca archgate:architect para validar a conformidade estrutural com os ADRs além do que as regras automatizadas capturam.

5. Capturar aprendizados

O agente invoca archgate:quality-manager para revisar o trabalho e identificar padrões que valem ser capturados como novos ADRs.

Dicas

• Execute o onboard uma vez por projeto para gerar seus ADRs iniciais a partir do seu codebase real.
• Mantenha os arquivos de regras dos ADRs atualizados — o agente aplica o que as regras verificam.