Plugin para Copilot CLI

O plugin Archgate para Copilot CLI oferece aos agentes de IA que trabalham no GitHub Copilot CLI guardrails integrados. 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. Execute archgate login para se cadastrar e autenticar 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 de forma segura no gerenciador de credenciais do sistema operacional via git credential approve.

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 plugin url copilot.

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 guardrails, 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.