archgate init

Initialiser Archgate-styring i det gjeldende prosjektet.

archgate init [options]

Oppretter .archgate/-katalogen med en eksempel-ADR, tilhørende regelfil og linter-konfigurasjon. Kan valgfritt konfigurere editor-integrasjon for AI-agentarbeidsflyter og installere Archgate editor-pluginen.

Valg

| Valg | Standard | Beskrivelse | | ------------------- | -------- | -------------------------------------------------------------------------------------- | | --editor <editor> | claude | Editor-integrasjon å konfigurere (claude, cursor, vscode, copilot, opencode) | | --install-plugin | auto | Installer Archgate editor-pluginen (krever tidligere archgate login) |

Når --install-plugin sendes med, installerer CLI-en Archgate-pluginen for den valgte editoren. Hvis flagget utelates, autodetekterer CLI-en: den installerer pluginen når gyldig legitimasjon finnes (fra en tidligere archgate login) og hopper over ellers.

Installasjonsoppførsel for plugins

Claude Code: Hvis claude-CLI-en er på din PATH, installeres pluginen automatisk via claude plugin marketplace add og claude plugin install. Hvis claude-CLI-en ikke finnes, skriver kommandoen ut de manuelle installasjonskommandoene i stedet.

Cursor: Hvis cursor-CLI-en er på din PATH, installeres VS Code-utvidelsen automatisk via cursor --install-extension. Team-markedsplassen-URL-en skrives ut for manuell plugin-oppdagelse.

opencode: Krever at opencode-CLI-en er på din PATH — hvis den ikke er det, hoppes installasjonen over og en melding ber deg installere opencode først. Når den er til stede, laster CLI-en ned en autentisert tarball med agentfiler fra Archgate plugins-tjenesten og pakker den ut i opencode-agentkatalogen for brukerskoopet ($XDG_CONFIG_HOME/opencode/agents/, faller tilbake til $HOME/.config/opencode/agents/ på alle plattformer inkludert Windows — opencode bruker XDG-stier via xdg-basedir og leser ikke %APPDATA%). Ingen filer skrives til prosjekttreet. Se opencode-integrasjonsguiden for detaljer.

Utdata

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.

Når --editor cursor brukes, viser utdataene .cursor/ i stedet for .claude/.

Deteksjon av hovedgren

Når kommandoen kjøres i et git-repositorium, autodetekterer archgate init hovedgrenen og lagrer den i .archgate/config.json som baseBranch-feltet. Dette lar archgate check hoppe over grendeteksjon ved hver kjøring, noe som sparer 1-4 git-subprosessanrop.

Deteksjonen prøver origin/HEAD, origin/main, origin/master, lokal main og lokal master (første treff vinner). Hvis ingen finnes (f.eks. ikke et git-repo), skrives ingen baseBranch.

Å kjøre archgate init på nytt overskriver ikke en manuelt konfigurert baseBranch. Se Konfigurasjon — baseBranch for detaljer.

Generert struktur

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