Skills
Skills baseadas em papéis que o agente invoca durante uma tarefa — revisar mudanças contra ADRs, criar novos ADRs, capturar lições aprendidas, fazer o onboarding de um projeto e consultar a referência da CLI.
Como o Archgate entrega governança de ADRs no seu editor de IA. Compare as seis integrações de editores e entenda como os plugins são distribuídos por plugins.archgate.dev.
A CLI do Archgate aplica seus Architecture Decision Records (ADRs) como regras executáveis. Os plugins de editor levam essa governança um passo antes — para dentro do próprio agente de IA. Em vez de depender de instruções de prompt que se degradam com o tempo, os plugins ensinam o agente a ler os ADRs aplicáveis antes de escrever código, validar suas mudanças depois e capturar novos padrões para o time.
Os plugins são uma camada sobre a CLI, não um substituto para ela. A referência autoritativa de comandos, regras e ADRs vive em cli.archgate.dev. Todo plugin, em última instância, executa os mesmos comandos archgate — archgate review-context, archgate check, archgate adr show — localmente na sua máquina. Nenhum dado de ADR sai do seu computador.
O que os plugins adicionam
Seção intitulada “O que os plugins adicionam”Em todos os editores, os plugins empacotam o fluxo de governança em unidades reutilizáveis:
Agentes
Subagentes pré-configurados — um developer que executa o ciclo completo de ler-validar-capturar, e um planner somente leitura que projeta abordagens em conformidade com ADRs sem tocar no código.
Regras / contexto
Contexto de governança sempre ativo, para que o agente saiba consultar os ADRs antes de codar e verificar conformidade depois — entregue como uma regra do Cursor, memória do agente ou contexto de sessão, dependendo do editor.
Diagnósticos
Violações de ADR exibidas onde você trabalha — inline no editor (VS Code) ou através do archgate check no terminal e na CI para os demais.
As seis integrações de editores
Seção intitulada “As seis integrações de editores”O Archgate entrega governança a seis superfícies de edição com IA. Elas compartilham as mesmas skills e agentes, mas cada uma se adapta ao modelo de extensão do editor hospedeiro — então as capacidades exatas e o método de instalação variam.
| Editor | Skills | Agents | Diagnostics | Session context | Install |
|---|---|---|---|---|---|
| Claude Code | 5 skills | developer · planner | via CLI / CI | ✓ | /plugin marketplace add |
| Cursor | 5 skills | developer · planner | via CLI / CI | always-apply rule | tar.gz · plugin install |
| VS Code | 4 chat skills | — | native, on save | — | .vsix extension |
| Copilot CLI | 5 skills | developer | via CLI / CI | ✓ | git clone (shallow) |
| Claude Desktop | 5 skills | — | — | — | .zip skill bundles |
| OpenCode | as agents | 7 agents | via CLI / CI | ✓ | tar.gz |
As duas integrações mais usadas estão documentadas em profundidade:
Claude Code A integração mais completa: 5 skills, agentes developer e planner, ciclo de governança completo. Comece por aqui.
Cursor Skills e agentes mais uma regra de governança always-apply para a IA do Cursor.
Modelo de distribuição
Seção intitulada “Modelo de distribuição”Os plugins são distribuídos por meio de um serviço customizado compatível com git em plugins.archgate.dev, e não por um registro público de pacotes. Durante o beta fechado, isso dá ao Archgate controle total sobre o acesso — tokens por usuário, revogação instantânea e analytics de download — sem os custos de licenciamento do GitHub.
Como funciona
Seção intitulada “Como funciona”O serviço é um único binário Bun implantado no Railway. Ele implementa o protocolo git smart HTTP, de modo que editores que instalam plugins via git clone (Claude Code, Copilot CLI) podem buscar diretamente dele. Os arquivos do plugin são embutidos no binário em tempo de build e servidos a partir de um repositório git virtual pré-computado — toda requisição retorna o mesmo packfile pré-construído, então não há computação por requisição. Para editores que esperam artefatos empacotados, o mesmo serviço também serve uma extensão .vsix para VS Code, arquivos tar.gz para Cursor e OpenCode, e pacotes .zip de skills para o Claude Desktop.
O acesso é controlado por tokens por usuário armazenados em um banco de dados Turso/libSQL. O token viaja na URL de clone — https://<token>@plugins.archgate.dev/archgate.git — e o editor armazena essa URL localmente, de modo que as atualizações automáticas em segundo plano continuam funcionando entre sessões. Toda requisição git valida o token antes de servir qualquer byte.
Obtendo acesso
Seção intitulada “Obtendo acesso”Você não monta a URL manualmente. A CLI do Archgate cuida de todo o fluxo:
archgate login— autentica com sua conta do GitHub via Device Flow e armazena as credenciais do plugin no gerenciador de credenciais do seu SO.archgate init(ouarchgate plugin install) — detecta seu editor e instala o plugin correspondente usando seu token automaticamente.
Atualizações
Seção intitulada “Atualizações”O repositório git virtual tem um único branch main com um commit por versão de plugin. Quando o serviço é reimplantado com novos arquivos de plugin, ele produz um novo SHA de commit endereçável por conteúdo; o editor detecta a mudança na próxima atualização do marketplace e baixa a versão mais recente. O campo version no manifesto de cada plugin (atualmente 0.7.0) é incrementado a cada release para que os editores detectem atualizações de forma confiável.
Próximos passos
Seção intitulada “Próximos passos” Configurar o Claude Code Configuração completa e como skills e agentes conduzem o ciclo.
Configurar o Cursor Instale o plugin e configure a regra de governança always-apply.
Referência da CLI Documentação autoritativa de comandos, regras e ADRs.