opencode-integrasjon

Archgate integreres med opencode for å gi AI-agenter en strukturert styringsarbeidsflyt. Agenten leser ADR-ene dine før den skriver kode, validerer etterpå, og fanger opp nye mønstre for teamet — den samme arbeidsflyten som er tilgjengelig i Claude Code-pluginet.

Oppsett

Kjør archgate init med --editor opencode-flagget for å konfigurere opencode-integrasjon i prosjektet ditt:

archgate init --editor opencode

Betatilgang kreves

opencode-agentpakken er for øyeblikket i beta. Kjør archgate login for å registrere deg og autentisere.

I motsetning til Claude Code- eller Cursor-integrasjonene skrives opencode-agentene ikke til prosjekttreet ditt. De installeres i stedet på brukernivå — så de bor på maskinen din, ikke i repositoriet ditt, og er tilgjengelige på tvers av alle prosjekter du åpner med opencode.

opencode bruker XDG Base Directory-konvensjonen på alle plattformer (via xdg-basedir-pakken), så installasjonsplasseringen resolves til $XDG_CONFIG_HOME/opencode/agents/ når den variabelen er satt, og faller tilbake til $HOME/.config/opencode/agents/ ellers. Det betyr at Windows-installasjoner havner under C:\Users\<brukernavn>\.config\opencode\agents\, ikke under %APPDATA%:

| Plattform | Installasjonsplassering | | ------------- | ------------------------------------------------ | | Linux / macOS | ~/.config/opencode/agents/ | | Windows | C:\Users\<brukernavn>\.config\opencode\agents\ |

Autentisert installasjon

opencode må være installert først

Installasjonstrinnet kjører bare når opencode-CLI-en er på PATH. Archgate må bekrefte at opencode er tilstede før den skriver filer til brukernivåets konfigurasjonskatalog — ellers ville agentene ligge på en plassering ingenting leser. Installer opencode fra opencode.ai først, og kjør deretter archgate init --editor opencode eller archgate plugin install --editor opencode på nytt.

Hvis du har logget inn via archgate login og opencode er på PATH, laster init-kommandoen ned og installerer Archgate-agentpakken for opencode. Pakken tilbyr en ferdigbygd primær agent og fire underagenter som gir opencode sin AI en komplett styringsarbeidsflyt.

For å eksplisitt installere agentene:

archgate login                                  # engangsoppsett
archgate init --editor opencode --install-plugin

For å installere eller reinstallere på et allerede initialisert prosjekt:

archgate plugin install --editor opencode

Installasjonstrinnet laster ned en autentisert tarball fra Archgate plugins-tjenesten og pakker ut de fem archgate-*.md-agentfilene i opencode brukernivå-katalogen.

Genererte filer (brukernivå)

| Fil | Formål | | ----------------------------------------------- | ----------------------------------------------------------------------- | | <opencode-agents>/archgate-developer.md | Primær agent (velges med Tab) som kjører den fulle ADR-arbeidsflyten | | <opencode-agents>/archgate-architect.md | Underagent som validerer kodeendringer mot alle prosjektets ADR-er | | <opencode-agents>/archgate-quality-manager.md | Underagent som fanger opp læringer og foreslår nye ADR-er | | <opencode-agents>/archgate-adr-author.md | Underagent som oppretter og redigerer ADR-er i henhold til konvensjoner | | <opencode-agents>/archgate-cli-reference.md | Intern referanseunderagent med Archgate CLI-kommandoguiden (skjult) |

.archgate/adrs/ og .archgate/lint/ opprettes fortsatt i prosjektet som vanlig — bare de opencode-spesifikke agentfilene bor utenfor prosjekttreet.

Hva pakken tilbyr

archgate--prefikset unngår kollisjoner med brukeropprettede opencode-agenter i samme katalog. Underagenter aktiveres via opencodes @-mention-syntaks.

Primær agent

| Navn | Formål | | -------------------- | ------------------------------------------------------------------------- | | archgate-developer | Generell utviklingsagent som leser ADR-er før koding og validerer etterpå |

archgate-developer-agenten orkestrerer underagentene nedenfor automatisk som en del av arbeidsflyten.

Underagenter

| Navn | Formål | | -------------------------- | ----------------------------------------------------------------------------- | | archgate-architect | Validerer kodeendringer mot alle prosjektets ADR-er for strukturell samsvar | | archgate-quality-manager | Gjennomgår regeldekning og foreslår nye ADR-er når mønstre dukker opp | | archgate-adr-author | Oppretter og redigerer ADR-er i henhold til prosjektets konvensjoner | | archgate-cli-reference | Intern referanse for AI-agenter med den komplette Archgate CLI-kommandoguiden |

Disse er de samme rollene som er tilgjengelige i Claude Code-pluginet, tilpasset opencodes opprinnelige primær-/underagentmodell.

Hvordan det fungerer i praksis

Velg archgate-developer som din primære agent (bruk Tab-tasten i opencode) når du starter en kodeoppgave. Agenten følger en strukturert arbeidsflyt for hver endring:

1. Les gjeldende ADR-er — Agenten kjører archgate review-context for å se hvilke ADR-er som gjelder for filene som endres. Den skriver ikke kode før den har lest de gjeldende ADR-ene.

2. Skriv kode i henhold til ADR-begrensninger — Agenten implementerer endringer i henhold til Do’s and Don’ts fra de gjeldende ADR-ene.

3. Kjør samsvarssjekker — Agenten kjører archgate check for å utføre automatiserte regler. Eventuelle brudd utbedres før man går videre.

4. Arkitektgjennomgang — Agenten nevner @archgate-architect for å validere strukturelt ADR-samsvar utover det automatiserte regler fanger opp.

5. Fang opp læringer — Agenten nevner @archgate-quality-manager for å gjennomgå arbeidet og identifisere mønstre som er verdt å fange opp som nye ADR-er eller oppdateringer til eksisterende.

ADR-drevet avvisning

Når archgate-developer møter en oppgave som ville kreve brudd på en ADR, avviser den og forklarer hvilken ADR som ville bli brutt. Den foreslår deretter hvordan man kan oppnå det samme målet uten å bryte reglene.

Hvis for eksempel en utvikler ber agenten om å legge til chalk som en avhengighet i et prosjekt styrt av en ADR for avhengighetspolicy, vil agenten:

1. Avvise, med henvisning til ADR-en og den godkjente avhengighetslisten
2. Foreslå det godkjente alternativet i stedet
3. Tilby å implementere oppgaven med den samsvarende tilnærmingen

Denne oppførselen er konsistent uavhengig av hvordan utvikleren formulerer forespørselen. ADR-er behandles som obligatoriske begrensninger, ikke forslag.

Når du skal bruke hver agent eller underagent

| Scenario | Agent / Underagent | | ------------------------------------------------- | ----------------------------- | | Daglige kodeoppgaver | archgate-developer (primær) | | Gjennomgå en endring for ADR-samsvar | @archgate-architect | | Oppdage et gjentagende mønster verdt å kodifisere | @archgate-quality-manager | | Opprette eller redigere en ADR | @archgate-adr-author |

archgate-developer-agenten orkestrerer underagentene automatisk — den nevner @archgate-architect og @archgate-quality-manager som en del av arbeidsflyten. Mesteparten av tiden trenger du bare å velge archgate-developer og la den kjøre.

Brukernivå vs. prosjektnivå

opencode-pakken bor i opencode-katalogen på brukernivå i stedet for i .opencode/ inne i prosjektet ditt. Konsekvenser:

• En installasjon per maskin. archgate plugin install --editor opencode installerer pakken globalt. Alle prosjekter du åpner med opencode ser de samme archgate-*-agentene.
• Repositoriet ditt forblir rent. Ingen .opencode/-mappe opprettes noensinne av archgate init. Teammedlemmer som ønsker agentene kjører sin egen archgate plugin install --editor opencode.
• Oppgraderinger er globale. Å kjøre archgate plugin install --editor opencode på nytt overskriver de eksisterende filene med den nyeste pakken.

Tips for effektiv bruk

• Velg archgate-developer ved starten av kodeøkter. Den orkestrerer hele les-valider-fang-opp-arbeidsflyten automatisk.
• Bruk @archgate-architect for gjennomganger. Den validerer strukturelt samsvar utover det automatiserte regler fanger opp.
• Bruk @archgate-quality-manager etter å ha løst vanskelige problemer. Den fanger opp læringer slik at de samme feilene ikke gjentas.
• Hold ADR-regelfiler oppdatert. Agenten håndterer det reglene sjekker for — hvis en regel mangler, vil bruddet ikke bli fanget opp.
• Kjør archgate plugin install --editor opencode på nytt for å oppgradere. Tjenesten returnerer den nyeste agentpakken ved hver autentisert nedlasting.