archgate init

Configura o linting e a aplicação de regras do Archgate no projeto atual.

archgate init [options]

Cria o diretório .archgate/ com um ADR de exemplo, arquivo de regras complementar e configuração do linter. Opcionalmente configura a integração com o editor para fluxos de trabalho com agentes de IA e instala o plugin de editor do Archgate.

Opções

Opção	Padrão	Descrição
--editor <editor>	claude	Integração de editor a configurar (claude, cursor, vscode, copilot, opencode)
--install-plugin	auto	Instalar o plugin de editor do Archgate (requer archgate login prévio)

Quando --install-plugin é passado, a CLI instala o plugin do Archgate para o editor selecionado. Se a flag for omitida, a CLI faz detecção automática: instala o plugin quando existem credenciais válidas (de um archgate login anterior) e pula caso contrário.

Comportamento de instalação do plugin

Claude Code: Se a CLI claude estiver no seu PATH, o plugin é instalado automaticamente via claude plugin marketplace add e claude plugin install. Se a CLI claude não for encontrada, o comando exibe os comandos de instalação manual.

Cursor: Faz o download de um tarball autenticado de skills, agentes e hooks em ~/.cursor/. Também grava .cursor/hooks.json no projeto para compatibilidade com agentes na nuvem. Nenhuma detecção de CLI é necessária.

opencode: Requer que a CLI opencode esteja no seu PATH. Se não estiver, a instalação é pulada e uma mensagem pede que você instale o opencode primeiro. Quando presente, a CLI baixa um tarball autenticado de arquivos de agente do serviço de plugins do Archgate e o extrai no diretório de agentes opencode do escopo do usuário ($XDG_CONFIG_HOME/opencode/agents/, com fallback para $HOME/.config/opencode/agents/ em qualquer plataforma, inclusive Windows; o opencode usa paths XDG via xdg-basedir e não lê %APPDATA%). Nenhum arquivo é gravado na árvore do projeto. Veja o guia de integração com opencode para detalhes.

Saída

Initialized Archgate governance in /path/to/project
  adrs/          - architecture decision records
  lint/          - linter-specific rules
  .claude/       - Claude Code settings configured

Archgate plugin installed for Claude Code.

Quando --editor cursor é usado, a saída mostra .cursor/ para arquivos no nível do projeto e indica que os componentes no escopo de usuário foram instalados em ~/.cursor/.

Detecção de branch base

Quando executado dentro de um repositório git, archgate init detecta automaticamente o branch base e o salva em .archgate/config.json como o campo baseBranch. Isso permite que archgate check pule a detecção de branch a cada execução, economizando 1-4 chamadas de subprocesso git.

A detecção tenta origin/HEAD, origin/main, origin/master, main local e master local (primeiro encontrado vence). Se nenhum for encontrado (ex: não é um repositório git), nenhum baseBranch é gravado.

Re-executar archgate init não sobrescreve um baseBranch configurado manualmente. Veja Configuração — baseBranch para detalhes.

Estrutura gerada

.archgate/
  adrs/
    GEN-001-example.md           # Example ADR
    GEN-001-example.rules.ts     # Example rules file
  lint/
    README.md                    # Linter rules guide