Claude Desktop

O Claude Desktop suporta a Archgate por meio de pacotes de skills independentes. Diferentemente dos plugins de editor que entregam um agente mais skills juntos, o Claude Desktop é configurado instalando skills individuais da Archgate como pacotes .zip. Cada pacote ensina ao Claude uma parte do fluxo de trabalho de governança — redigir ADRs, revisar mudanças, fazer o onboarding de um projeto, capturar lições e carregar a referência da CLI.

Referência oficial da CLI

Esta página cobre a instalação dos pacotes de skills no Claude Desktop. Para a sintaxe exata dos comandos archgate que as skills invocam (archgate check, archgate review-context, archgate adr ...), consulte a referência da CLI em cli.archgate.dev.

Requisitos

• Claude Desktop com suporte a skills habilitado.
• CLI Archgate — instale pelo guia de instalação da CLI. As skills invocam a CLI archgate para ler ADRs e executar verificações, então ela precisa estar disponível no ambiente em que o Claude Desktop pode executar comandos.
• Um projeto com um diretório .archgate/ — criado por archgate init. As skills operam sobre os ADRs e as regras nesse diretório.

Os pacotes de skills

Cada pacote é um .zip contendo um Skill.md (a definição da skill) e seu LICENSE. Cinco pacotes são distribuídos:

archgate-reviewer

Valida mudanças de código contra todos os ADRs aplicáveis do projeto, usando sub-agentes focados em domínio. Invoque após fazer as mudanças, antes de commitar.

archgate-adr-author

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

archgate-onboard

Configuração única: executa archgate init, explora o codebase, entrevista você e cria o conjunto inicial de ADRs.

archgate-lessons-learned

Captura aprendizados de uma sessão e os codifica em novos ADRs ou na memória do projeto — o passo final do fluxo de trabalho.

archgate-cli-reference

Referência interna que carrega o guia completo de comandos e de redação de regras da CLI Archgate sob demanda. Dá suporte às outras skills em vez de ser invocada diretamente.

Esses são os mesmos papéis documentados em Skills, empacotados para o formato de skill do Claude Desktop.

Instalação

Os pacotes são distribuídos como arquivos archgate-<role>.zip. Instale cada um pela interface de skills do Claude Desktop.

1. Obtenha os pacotes de skills. Baixe os arquivos archgate-*.zip da distribuição de plugins da Archgate (beta fechado — execute archgate login para solicitar acesso).

2. Abra as configurações de skills do Claude Desktop e escolha adicionar uma skill a partir de um arquivo.

3. Instale cada pacote .zip que desejar. No mínimo, instale archgate-reviewer (validar mudanças) e archgate-cli-reference (para que as outras skills possam carregar a sintaxe dos comandos). Adicione archgate-adr-author, archgate-onboard e archgate-lessons-learned para o fluxo de trabalho completo.

4. Verifique se a CLI está acessível confirmando que archgate --version funciona no ambiente em que o Claude Desktop executa comandos. As skills dependem disso.

As skills chamam a CLI

Os pacotes de skills não contêm o motor da Archgate — eles instruem o Claude a executar comandos archgate e a ler seus ADRs. Se a CLI não estiver instalada ou não estiver no PATH, as skills não conseguem reunir contexto nem executar verificações.

Como as skills trabalham juntas

Cada skill é autossuficiente, mas elas formam um fluxo de trabalho quando usadas em sequência:

1. Faça o onboarding uma vez — archgate-onboard configura .archgate/ e seus ADRs iniciais para um novo projeto.
2. Redija decisões — archgate-adr-author cria e refina ADRs à medida que sua arquitetura evolui.
3. Revise mudanças — depois de escrever código, archgate-reviewer executa archgate review-context e archgate check, depois valida cada domínio afetado contra seus ADRs. Violações de ADRs são bloqueios definitivos.
4. Capture aprendizados — archgate-lessons-learned revisa a sessão e propõe novos ADRs ou atualizações quando um padrão emerge.

Ao longo de tudo isso, archgate-cli-reference carrega a sintaxe exata dos comandos da CLI e a API de regras sob demanda, já que esses detalhes são mais recentes do que a maioria dos cortes de treinamento dos modelos.

Próximos passos

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

Skills Referência detalhada de cada skill de governança.

Referência da CLI Documentação oficial de comandos e regras.