VS Code-plugin

Archgate VS Code-pluginet gir AI-agenter som jobber i VS Code innebygde guardrails. 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/-mappen med ADR-er og lint-regler
2. Legge til markedsplassens URL i VS Code-brukerinnstillingene dine

archgate init laster ikke ned VS Code-utvidelsen. For å installere selve utvidelsen, kjør archgate plugin install --editor vscode (se nedenfor).

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
WSL	Stien på Windows-siden ovenfor (VS Code kjører på Windows)

3. Installer utvidelsen

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

archgate plugin install --editor vscode

Uten --editor oppdager en interaktiv kjøring hvilke editorer som er installert på maskinen din og lar deg velge; en ikke-interaktiv kjøring (en agent eller CI) faller tilbake til Claude Code.

Dette skriver markedsplassens URL på nytt inn i brukerinnstillingene dine, og når code-CLI-en er på PATH, laster den ned Archgate VS Code-utvidelsen fra plugins-tjenesten og installerer den via code --install-extension. Hvis code-CLI-en ikke er tilgjengelig, skrives instruksjoner for manuell installasjon ut. Hvis selve installasjonen feiler, beholdes den nedlastede .vsix-filen på ~/.archgate/archgate.vsix slik at du kan installere den for hånd.

Genererte filer

Kommandoene oppretter eller oppdaterer følgende:

Fil	Omfang	Formål
Bruker settings.json	Bruker	chat.plugins.marketplaces med Archgate-markedsplassens URL (init)
Archgate-utvidelse	Applikasjon	VS Code-utvidelse installert via .vsix (archgate plugin install)

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.

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

{
  "chat.plugins.marketplaces": [
    "https://plugins.archgate.dev/archgate/vscode.git"
  ]
}

URL-en inneholder ingen legitimasjon. Git autentiserer mot plugins.archgate.dev med tokenet archgate login lagret i operativsystemets legitimasjonsbehandler.

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 skrive ut URL-en ved å kjøre archgate plugin url --editor 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 plugin-tokenet archgate login lagret for plugins.archgate.dev i operativsystemets legitimasjonsbehandler. Du kan lese det tilbake med git credential fill (printf 'protocol=https\nhost=plugins.archgate.dev\n\n' | git credential fill).

Hva pluginet tilbyr

Pluginet legger til agenter og rollebaserte ferdigheter i VS Codes AI. Utvikleragenten orkestrerer guardrails-arbeidsflyten og aktiverer ferdigheter etter behov.

Agenter

Agent	Formål
archgate:developer	Generell utviklingsagent som leser ADR-er før koding og validerer etterpå
archgate:planner	Planleggingsagent for å avgrense arbeid og bryte oppgaver ned i ADR-samsvarende steg

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:reviewer	Validerer kodeendringer mot alle prosjektets ADR-er for strukturelt samsvar
archgate:lessons-learned	Fanger opp lærdommer 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
archgate:cli-reference	Intern referanse for AI-agenter med den komplette kommandoguiden for Archgate CLI

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. Gjennomgå endringer

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

5. Fang opp læringer

Agenten aktiverer archgate:lessons-learned 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å, deretter archgate plugin install --editor vscode for å installere utvidelsen.
• 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.