Copilot CLI-plugin

Archgate Copilot CLI-pluginet gir AI-agenter som jobber i GitHub Copilot CLI 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

Copilot CLI støtter plugin-installasjon fra git-repositorier ved hjelp av copilot plugin install. Archgate-pluginet serveres fra et git-repositorium på plugins.archgate.dev/archgate.git, som Copilot CLI gjenkjenner direkte — det samme .claude-plugin/plugin.json-manifestformatet fungerer for både Claude Code og Copilot CLI.

Installasjon

Betatilgang kreves

Copilot CLI-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 copilot-flagget:

archgate init --editor copilot

Hvis du allerede er logget inn og copilot-CLI-en er på PATH, installeres pluginet automatisk via:

copilot plugin install https://<github-user>:<token>@plugins.archgate.dev/archgate.git

Hvis copilot-CLI-en ikke finnes, skriver kommandoen ut den manuelle kommandoen du må kjøre.

For å eksplisitt be om plugin-installasjon:

archgate init --editor copilot --install-plugin

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

archgate plugin install --editor copilot

Genererte filer

Kommandoen oppretter .github/copilot/-mappen for plugin-konfigurasjon. Plugin-installasjon håndteres separat via copilot plugin install-kommandoen.

Manuell installasjon

Hvis copilot-CLI-en ikke finnes under archgate init, kan du installere pluginet manuelt:

copilot plugin install https://<github-user>:<token>@plugins.archgate.dev/archgate.git

Du kan finne den autentiserte URL-en din ved å kjøre archgate plugin url copilot.

Hva pluginet tilbyr

Pluginet legger til en agent og rollebaserte ferdigheter i Copilot CLI. 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

• 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.