Plugin do Cursor

O Archgate se integra ao Cursor para dar ao seu agente de IA o mesmo fluxo de governança estruturado disponível no Claude Code: ler os ADRs aplicáveis antes de escrever código, validar depois e capturar novos padrões para o time. A integração combina uma regra always-apply do Cursor com as skills e os agentes do Archgate.

Acesso beta necessário

O plugin do Cursor está em beta fechado. Execute archgate login para se cadastrar e autenticar. O plugin é distribuído a partir de plugins.archgate.dev e a CLI gerencia seu token para você. A CLI em si é gratuita — mesmo sem o plugin, o Cursor pode consultar os ADRs através de comandos da CLI (consulte Sem o plugin abaixo).

O que o plugin oferece

O plugin (archgate, versão 0.7.0) registra uma entrada de marketplace do Cursor e instala um agente, cinco skills e uma regra de governança. O sistema de plugins do Cursor cuida do namespacing, então skills e agentes usam seus nomes diretos sem o prefixo archgate:.

Agentes

Nome	Modo	Propósito
developer	Edições	Agente de desenvolvimento geral. Lê os ADRs antes de codar, valida depois, orquestra as skills.
planner	Somente leitura	Projeta abordagens de implementação em conformidade com ADRs sem escrever ou modificar qualquer arquivo.

Skills

Nome	Quando é usada
reviewer	Após uma mudança de código — valida as mudanças contra os ADRs do projeto usando subagentes focados por domínio.
lessons-learned	Após codar e validar — captura padrões recorrentes e os codifica em ADRs.
adr-author	Ao criar ou editar um ADR — segue a estrutura e as convenções estabelecidas no projeto.
onboard	Uma vez por projeto — executa archgate init, explora o codebase, entrevista você, escreve ADRs.
cli-reference	Interno: carrega as referências autoritativas de comandos da CLI, autoria de regras e formato de ADR.

São o mesmo agente e as mesmas skills entregues no plugin do Claude Code, adaptados para o sistema de plugins do Cursor.

Regra de governança

Arquivo	Propósito
.cursor/rules/archgate-governance.mdc	Uma regra always-apply que instrui o agente a consultar os ADRs e executar verificações.

A regra usa alwaysApply: true, então o agente do Cursor sempre tem o contexto de governança disponível sem ativação manual. Ela diz ao agente para executar archgate review-context antes de codar e archgate check --staged depois, e reforça o princípio central: decisões arquiteturais são aplicadas, não sugeridas — se o archgate check reportar violações, elas devem ser corrigidas.

Instalação

1. Faça login com o GitHub.

   archgate login

   Isso obtém seu token de plugin e armazena as credenciais no gerenciador de credenciais do seu SO.

2. Inicialize o projeto para o Cursor.

   Execute archgate init com a flag --editor cursor:

   archgate init --editor cursor

   Se você estiver logado, isso também instala o plugin Archgate. Para solicitar o plugin explicitamente:

   archgate init --editor cursor --install-plugin

O plugin é entregue por dois canais, ambos gerenciados pela CLI:

• Marketplace de time do Cursor — um repositório de marketplace baseado em git servido a partir de plugins.archgate.dev. Após a instalação, o Cursor descobre o plugin pela URL do marketplace que a CLI imprime. (Por baixo dos panos, o arquivo do plugin é servido como um tar.gz.)
• Extensão do VS Code (VSIX) — um .vsix é instalado no Cursor via cursor --install-extension quando a CLI cursor está disponível.

O comando archgate plugin install --editor cursor instala o VSIX via CLI cursor, se presente, e imprime a URL do marketplace de time; caso contrário, imprime instruções manuais.

Instalando em um projeto existente

archgate plugin install --editor cursor

Para recuperar a URL autenticada do marketplace para configuração manual:

archgate plugin url --editor cursor

Dica

Faça commit do diretório .cursor/. Isso garante que cada colega de time receba a mesma configuração de governança ao clonar o repositório.

Configuração inicial: onboard

Após instalar o plugin, execute a skill onboard uma vez por projeto. Ela:

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 do seu time.
3. Cria um conjunto inicial de ADRs a partir das suas respostas.
4. Configura o diretório .archgate/ com suas primeiras regras.

Após o onboarding, as outras skills cuidam do desenvolvimento do dia a dia. Consulte Escrevendo ADRs para o formato que ela segue.

Como funciona na prática

Com o plugin

O agente developer segue um fluxo de trabalho estruturado para cada tarefa de código:

1. Ler os ADRs aplicáveis — executa archgate review-context para ver quais ADRs se aplicam aos arquivos alterados. Ele não escreve código até tê-los lido.
2. Escrever código seguindo as restrições dos ADRs — implementa mudanças respeitando os Do’s and Don’ts dos ADRs aplicáveis.
3. Executar verificações de conformidade — executa archgate check --staged para rodar as regras automatizadas; corrige quaisquer violações antes de prosseguir.
4. Rodada de revisão — invoca a skill reviewer, que lança um subagente focado por domínio afetado para verificar a conformidade estrutural contra o conjunto completo de ADRs.
5. Capturar aprendizados — invoca a skill lessons-learned para identificar padrões que valem a pena codificar como novos ADRs ou atualizações aos existentes.

Para trabalho apenas de planejamento, mude para o agente planner: ele lê os ADRs relevantes, analisa o codebase e produz um plano em conformidade com os ADRs sem modificar qualquer arquivo.

Sem o plugin

Mesmo sem o plugin (o caminho gratuito), archgate init --editor cursor configura a regra de governança. O agente usa essa regra e comandos da CLI para seguir quatro passos manuais:

1. Revisar o contexto — execute archgate review-context para ver quais ADRs se aplicam aos arquivos alterados.
2. Ler ADRs individuais — execute archgate adr show <id> (por exemplo, archgate adr show ARCH-001) para o contexto completo de uma decisão.
3. Escrever código — implemente mudanças seguindo as restrições dos ADRs aplicáveis.
4. Executar verificações de conformidade — execute archgate check --staged para validar a conformidade.

O caminho gratuito dá ao Cursor contexto de governança e verificações conduzidas pela CLI, mas não as skills baseadas em papéis e os subagentes acima.

Recusa orientada por ADR

Quando uma tarefa exigiria violar um ADR, o agente recusa, nomeia o ADR e sugere uma alternativa em conformidade — de forma consistente, independentemente da formulação. Os ADRs são restrições obrigatórias. Por exemplo, ao ser solicitado a adicionar uma dependência não permitida em um projeto governado por um ADR de política de dependências, o agente recusa, cita o ADR e a lista aprovada, e propõe a alternativa autorizada.

Acesso a transcrições de sessão

O comando archgate session-context cursor lê as transcrições de sessão do agente do Cursor a partir do disco, permitindo que as skills recuperem contexto que pode ter sido compactado ou truncado. Ele aceita duas flags opcionais:

• --max-entries <n> — número máximo de entradas (mais recentes) a retornar; padrão 200.
• --session-id <uuid> — um UUID de sessão específico; se omitido, a sessão mais recente é usada.

Para flags exatas de comando e formatos de saída, consulte a referência autoritativa em cli.archgate.dev.

Quando usar cada agente ou skill

Cenário	Use
Configurar o Archgate em um projeto novo	onboard
Planejar uma abordagem antes de codar	planner
Tarefas de código do dia a dia	developer
Revisar mudanças para conformidade com ADRs	reviewer
Capturar um padrão recorrente como um ADR	lessons-learned
Criar ou editar um ADR manualmente	adr-author

Na maior parte do tempo você interage apenas com o agente developer — ele orquestra reviewer e lessons-learned automaticamente.

Próximos passos

Plugin do Claude Code A integração mais completa, com mais detalhes de fluxo de trabalho.

Ecossistema de plugins Compare todas as seis integrações de editores e o modelo de distribuição.

Referência da CLI Comandos autoritativos, API de regras e formato de ADR.