VS Code-plugin

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

Hvordan det fungerer

VS Code støtter agent-plugins installert fra git-baserte markedsplasser. Archgate-pluginet serveres fra et git-repositorium på plugins.archgate.dev/archgate/vscode.git. Når du legger til denne markedsplassen i VS Code-brukerinnstillingene dine, oppdager og installerer VS Code pluginet automatisk.

Pluginet serveres i VS Code Copilots opprinnelige .github/plugin/-manifestformat, adskilt fra Claude Code .claude-plugin/-formatet.

Installasjon

Krav til VS Code-versjon

Agent-plugins krever VS Code 1.110 (februar 2026-utgivelsen) eller nyere. Tidligere versjoner støtter ikke git-baserte agent-plugin-markedsplasser. Sjekk versjonen din med code --version.

Betatilgang kreves

VS Code-pluginet er for øyeblikket i beta. Kjør archgate login for å registrere deg og autentisere før du følger trinnene nedenfor.

1. Logg inn med GitHub

Autentiser med GitHub-kontoen din for å få et plugin-token:

archgate login

Dette starter en GitHub Device Flow. CLI-en viser en engangskode og URL — åpne URL-en i nettleseren din, skriv inn koden, og autoriser. Når det er fullført, lagres legitimasjonen sikkert i operativsystemets legitimasjonsbehandler via git credential approve.

2. Initialiser prosjektet ditt med pluginet

Kjør archgate init med --editor vscode-flagget:

archgate init --editor vscode

Hvis du allerede er logget inn, vil denne kommandoen:

1. Opprette .archgate/-styringsmappen (ADR-er, lint-regler)
2. Legge til den autentiserte markedsplassens URL i VS Code-brukerinnstillingene dine
3. Laste ned og installere Archgate VS Code-utvidelsen (.vsix) hvis code-CLI-en er tilgjengelig

Innstillingen chat.plugins.marketplaces er applikasjonsscopet i VS Code, så den kan ikke settes per arbeidsområde. CLI-en skriver den automatisk til settings.json på brukernivå:

| Plattform | Sti til brukerinnstillinger | | --------- | ------------------------------------------------------- | | Windows | %APPDATA%\Code\User\settings.json | | macOS | ~/Library/Application Support/Code/User/settings.json | | Linux | ~/.config/Code/User/settings.json |

For å eksplisitt be om plugin-installasjon:

archgate init --editor vscode --install-plugin

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

archgate plugin install --editor vscode

Genererte filer

Kommandoen oppretter eller oppdaterer følgende:

| Fil | Omfang | Formål | | ---------------------- | ----------- | ------------------------------------------------------- | | Bruker settings.json | Bruker | chat.plugins.marketplaces med den autentiserte URL-en | | Archgate-utvidelse | Applikasjon | VS Code-utvidelse installert via .vsix |

Brukerinnstillingsfilen flettes additivt — eksisterende innstillinger overskrives aldri. VS Codes innebygde standardmarkedsplasser (github/copilot-plugins, github/awesome-copilot) bevares når nøkkelen settes for første gang.

VS Code-utvidelsen lastes ned fra Archgate plugins-tjenesten og installeres via code --install-extension. Hvis code-CLI-en ikke er tilgjengelig, skrives instruksjoner for manuell installasjon ut.

Markedsplassinnstillingen på brukernivå (lagt til i settings.json):

{
  "chat.plugins.marketplaces": [
    "https://<github-user>:<token>@plugins.archgate.dev/archgate/vscode.git"
  ]
}

Manuelt oppsett

Hvis du foretrekker at CLI-en ikke endrer brukerinnstillingene dine, kan du sette opp ting manuelt:

Markedsplassens URL: Åpne VS Codes brukerinnstillinger-JSON (Ctrl+Shift+P -> “Preferences: Open User Settings (JSON)”) og legg til chat.plugins.marketplaces-oppføringen vist ovenfor. Du kan finne den autentiserte URL-en din ved å kjøre archgate plugin url vscode.

Utvidelse: Last ned og installer .vsix-filen direkte:

curl -H "Authorization: Bearer <token>" https://plugins.archgate.dev/api/vscode -o archgate.vsix
code --install-extension archgate.vsix
rm archgate.vsix

Erstatt <token> med archgate-tokenet ditt (hent det via archgate plugin url vscode).

Hva pluginet tilbyr

Pluginet legger til en agent og rollebaserte ferdigheter i VS Codes AI. Agenten orkestrerer styringsarbeidsflyten og aktiverer ferdigheter etter behov.

Agent

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

archgate:developer-agenten er satt som standardagent via plugin-innstillingene. Den orkestrerer ferdighetene nedenfor automatisk som en del av arbeidsflyten.

Ferdigheter

| Ferdighet | 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:onboard | Engangsoppsett: utforsker kodebasen, intervjuer utvikleren, oppretter innledende ADR-er |

Første oppsett med onboard

Etter installasjon, kjør archgate:onboard-ferdigheten i prosjektet ditt en gang. Denne ferdigheten:

1. Utforsker kodebasestrukturen din (mapper, nøkkelfiler, pakkekonfigurasjon)
2. Intervjuer deg om teamets konvensjoner, begrensninger og arkitekturbeslutninger
3. Oppretter et innledende sett med ADR-er basert på svarene dine
4. Setter opp .archgate/-mappen med de første reglene dine

Onboard-ferdigheten er designet for å kjøres en gang per prosjekt. Etter onboarding håndterer de andre ferdighetene daglig utvikling.

Hvordan det fungerer i praksis

Pluginet følger en strukturert arbeidsflyt for hver kodeoppgave:

1. Les gjeldende ADR-er

Når utvikleren gir en kodeoppgave, kjører agenten archgate review-context for å lese alle ADR-er som gjelder for filene som endres. Dette gir en komprimert briefing med Decision- og Do’s and Don’ts-seksjonene fra hver relevante ADR.

2. Skriv kode i henhold til ADR-begrensninger

Agenten skriver kode som samsvarer med begrensningene fra ADR-ene. Do’s and Don’ts-seksjonene fungerer som konkrete retningslinjer.

3. Valider endringer

Etter å ha skrevet kode, kjører agenten archgate check for å utføre automatiserte regler mot endringene. Eventuelle brudd utbedres før man går videre.

4. Arkitektgjennomgang

Agenten aktiverer archgate:architect for å validere strukturelt ADR-samsvar utover det automatiserte regler fanger opp.

5. Fang opp læringer

Agenten aktiverer archgate:quality-manager for å gjennomgå arbeidet og identifisere mønstre som er verdt å fange opp som nye ADR-er.

Tips

• Hver utvikler kjører archgate init --editor vscode etter archgate login for å konfigurere markedsplassens URL på brukernivå.
• Kjør onboard en gang per prosjekt for å generere de innledende ADR-ene fra den faktiske kodebasen din.
• Hold ADR-regelfiler oppdatert — agenten håndterer det reglene sjekker for.