Cursor-integrasjon

Archgate integreres med Cursor for å gi AI-agenter innebygde guardrails. 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 cursor-flagget for å konfigurere Cursor-integrasjon i prosjektet ditt:

archgate init --editor cursor

Betatilgang kreves

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

Hvis du har logget inn via archgate login, installerer init-kommandoen også Archgate-pluginet for Cursor. Pluginet tilbyr ferdigbygde agenter, skills og hooks som gir Cursors AI-agent en komplett guardrails-arbeidsflyt.

Pluginet distribueres som en autentisert tarball. CLI-en laster det ned og pakker ut skills, agenter og hooks i ~/.cursor/. Ingen CLI-deteksjon er nødvendig — filene skrives direkte til Cursor-brukerkatalogen.

For å eksplisitt installere pluginet:

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

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

archgate plugin install --editor cursor

Genererte filer

Brukerscope (~/.cursor/):

Fil	Formål
~/.cursor/skills/archgate-reviewer.md	Validerer kodeendringer mot alle prosjektets ADR-er
~/.cursor/skills/archgate-lessons-learned.md	Fanger opp læringer og foreslår nye ADR-er når mønstre dukker opp
~/.cursor/skills/archgate-adr-author.md	Oppretter og redigerer ADR-er i henhold til prosjektets konvensjoner
~/.cursor/skills/archgate-onboard.md	Engangsoppsett: utforsker kodebasen, intervjuer deg og oppretter ADR-er
~/.cursor/skills/archgate-cli-reference.md	Intern referanse for AI-agenter med Archgate CLI-guiden
~/.cursor/agents/archgate-developer.md	Primær utviklingsagent med den komplette ADR-guardrails-arbeidsflyten
~/.cursor/agents/archgate-planner.md	Planleggingsagent for scoping og oppdeling av arbeid

Prosjektscope:

Fil	Formål
.cursor/hooks.json	afterFileEdit-hook som kjører archgate check etter hver filredigering

Filen .cursor/hooks.json er den eneste filen som skrives til prosjekttreet ditt. Den sørger for at archgate check kjøres automatisk etter hver filredigering, og fanger opp ADR-brudd i sanntid.

Hva pluginet tilbyr

Pluginet legger til agenter og skills i Cursor, installert i brukerscope slik at de er tilgjengelige på tvers av alle prosjektene dine.

Agenter

Navn	Formål
archgate-developer	Generell utviklingsagent som leser ADR-er før koding og validerer etterpå
archgate-planner	Planleggingsagent for scoping av arbeid og oppdeling i ADR-samsvarende trinn

Brukere aktiverer agenter eksplisitt via /archgate-developer eller /archgate-planner i Cursor-chatten.

Skills

Navn	Formål
archgate-reviewer	Validerer kodeendringer mot alle prosjektets ADR-er for strukturelt samsvar
archgate-lessons-learned	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 deg og oppretter innledende ADR-er
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 (archgate:reviewer, archgate:lessons-learned, osv.), tilpasset Cursors skill- og agentsystem.

Hooks

Hook	Utløser	Handling
afterFileEdit	Hver filredigering	Kjører archgate check for å fange opp ADR-brudd i sanntid

Hooken er definert i .cursor/hooks.json på prosjektnivå, slik at den fungerer både lokalt og i skybaserte agentmiljøer.

Første oppsett med onboard

Etter å ha installert pluginet, aktiver /archgate-developer og be den kjøre onboard-ferdigheten i prosjektet ditt. 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

Aktiver /archgate-developer i Cursors chat 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. afterFileEdit-hooken fanger også opp brudd i sanntid. Eventuelle brudd utbedres før man går videre.

4. Gjennomgå endringer — Agenten aktiverer archgate-reviewer-ferdigheten for å validere strukturelt ADR-samsvar utover det automatiserte regler fanger opp.

5. Fang opp læringer — Agenten aktiverer archgate-lessons-learned-ferdigheten 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 agenten 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 ferdighet

Scenario	Agent / Ferdighet
Starte et nytt prosjekt med Archgate	/archgate-developer (be den om å gjøre onboard)
Daglige kodeoppgaver	/archgate-developer
Planlegging og scoping av arbeid	/archgate-planner
Gjennomgå en endring for ADR-samsvar	archgate-reviewer
Oppdage et gjentagende mønster verdt å kodifisere	archgate-lessons-learned
Opprette eller redigere en ADR	archgate-adr-author

archgate-developer-agenten orkestrerer ferdighetene automatisk — den aktiverer archgate-reviewer og archgate-lessons-learned som en del av arbeidsflyten. Mesteparten av tiden trenger du bare å aktivere /archgate-developer og la den kjøre.

Støtte for skyagenter

Cursor støtter skyagenter som kjører på fjernstyrte VM-er. Disse miljøene har ikke tilgang til ~/.cursor/, så skills og agenter i brukerscope er ikke tilgjengelige. Imidlertid er filen .cursor/hooks.json en del av prosjekttreet ditt og fungerer i sky-VM-er. Dette betyr at archgate check fortsatt kjøres automatisk etter hver filredigering, selv i skyagentøkter.

For full styring i skymiljøer, sørg for at archgate er tilgjengelig på VM-ens PATH (f.eks. via installasjonsscriptet i prosjektets oppsett).

Tilgang til sesjonsutskrifter

Kommandoen archgate session-context cursor leser Cursor-agentens sesjonsutskrifter fra disk. Dette lar ferdigheter få tilgang til historikken til den gjeldende samtalen, noe som er nyttig for å gjenopprette kontekst som kan ha blitt komprimert eller avkortet.

Kommandoen aksepterer to valgfrie flagg:

• --max-entries <n> — Maksimalt antall oppføringer å returnere (standard: 200, nyeste oppføringer).
• --session-id <uuid> — En spesifikk sesjons-UUID å lese. Hvis utelatt, brukes den nyeste sesjonen.

Tips for effektiv bruk

• Aktiver /archgate-developer for kodeoppgaver. Den orkestrerer hele les-valider-fang-opp-arbeidsflyten automatisk.
• Kjør onboard en gang per prosjekt. Den setter opp de innledende ADR-ene basert på den faktiske kodebasen og konvensjonene dine.
• Bruk archgate-reviewer for gjennomganger. Den validerer strukturelt samsvar utover det automatiserte regler fanger opp.
• Bruk archgate-lessons-learned etter å ha løst vanskelige problemer. Den fanger opp læringer slik at de samme feilene ikke gjentas.
• Commit .cursor/-mappen. Filen hooks.json sørger for at hvert teammedlem får archgate check på filredigeringer når de kloner repositoriet.
• Hold ADR-regelfiler oppdatert. Agenten håndhever det reglene sjekker for — hvis en regel mangler, vil bruddet ikke bli fanget opp.
• Kjør archgate plugin install --editor cursor for å oppgradere. Tjenesten returnerer den nyeste plugin-pakken ved hver autentisert nedlasting.