GitHub Copilot CLI

O plugin Archgate para o GitHub Copilot CLI dá ao agente do Copilot um fluxo de trabalho de governança estruturado: ele lê os ADRs que se aplicam à sua mudança antes de escrever código, valida o resultado com archgate check e captura novos padrões para a equipe. É o mesmo ciclo de ler-validar-capturar disponível em todas as integrações de editor da Archgate.

Referência oficial da CLI

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

Como funciona

O Copilot CLI instala plugins a partir de repositórios git usando copilot plugin install. A Archgate serve seu plugin a partir do serviço de distribuição em plugins.archgate.dev. O plugin usa o mesmo formato de manifesto .claude-plugin/plugin.json que o Claude Code utiliza, que o Copilot CLI reconhece nativamente — então um único plugin empacotado funciona para os dois editores. O settings.json do plugin define archgate:developer como o agente padrão.

Requisitos

• CLI Archgate — instale pelo guia de instalação da CLI.
• GitHub Copilot CLI no seu PATH para a instalação automática. Se não for encontrado, o archgate init imprime o comando de instalação manual para você executar.
• Um login no GitHub — o plugin está em beta fechado e os downloads exigem um token autenticado de archgate login.

Instalação

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

   archgate login

   Isso executa um GitHub Device Flow e armazena as credenciais com segurança no gerenciador de credenciais do seu sistema operacional.

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

   archgate init --editor copilot

   Quando você está autenticado e a CLI copilot está no seu PATH, o plugin é instalado automaticamente. Isso também cria o diretório .github/copilot/ para a configuração do plugin.

3. Comece a programar com o agente archgate:developer, que o plugin define como padrão.

Instalação manual

Se a CLI copilot não for detectada durante o archgate init, instale o plugin manualmente. Obtenha sua URL autenticada com archgate plugin url copilot e depois:

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

Para reinstalar em um projeto já inicializado, use archgate plugin install --editor copilot. Ambos os fluxos estão documentados no guia da CLI.

O que o plugin oferece

O plugin adiciona um agente e um conjunto de skills de governança. O agente orquestra o fluxo de trabalho e invoca as skills conforme necessário.

archgate:developer

O agente de desenvolvimento padrão. Ele lê os ADRs aplicáveis antes de programar e valida depois — o orquestrador de todo o fluxo de trabalho.

Skills de governança

Skills para redigir ADRs, revisar mudanças contra todos os ADRs aplicáveis, fazer o onboarding único do projeto e capturar lições aprendidas.

Essas correspondem aos papéis documentados em Skills e Agentes.

O fluxo de trabalho na prática

Para cada tarefa de programação, o agente archgate:developer segue um ciclo estruturado:

1. Ler os ADRs aplicáveis — o agente executa archgate review-context para obter um resumo condensado (Decisão + O que fazer e O que não fazer) de cada ADR que se aplica aos arquivos sendo alterados. Ele não escreve código até tê-los lido.
2. Escrever código seguindo as restrições — os “O que fazer” e “O que não fazer” servem como guardrails concretos.
3. Validar — o agente executa archgate check para rodar as regras automatizadas e corrige qualquer violação antes de prosseguir.
4. Revisar — uma skill de revisão valida a conformidade estrutural além do que as regras automatizadas detectam.
5. Capturar aprendizados — uma skill de lições aprendidas revisa o trabalho e propõe novos ADRs quando padrões emergem.

Se uma tarefa exigisse violar um ADR, o agente recusa, nomeia o ADR e sugere uma alternativa em conformidade. Os ADRs são tratados como restrições obrigatórias, não sugestões.

Configuração inicial

Após a instalação, execute a skill de onboarding uma vez no seu projeto. Ela explora seu codebase, entrevista você sobre suas convenções e restrições e cria um conjunto inicial de ADRs em .archgate/. Depois disso, as outras skills cuidam do trabalho do dia a dia. Consulte Onboarding para detalhes.

Próximos passos

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

Skills As skills de governança que o agente invoca durante o fluxo de trabalho.

CLI: plugin do Copilot CLI Configuração, flags e instalação manual oficiais.