Agenter, instruksjoner, skills og MCP-servere som gjør GitHub Copilot smartere for Navs stack. Alt samlet i én verktøyskatalog.
En samling Copilot-tilpasninger for Nav-økosystemet:
- 🤖 13 Agenter — Spesialiserte AI-assistenter for Nav-domener
- 📋 16 Instruksjoner — Kodestandarder som aktiveres automatisk basert på filmønster
- ⚡ 7 Prompts — Scaffolding-maler for vanlige Nav-mønstre
- 🎯 30 Skills — Produksjonsmønstre fra ekte Nav-repoer
- 🔌 MCP-servere — Nav-godkjente MCP-servere fra registeret
Alle tilpasninger finnes på verktøysida med søk, filtrering og installeringshjelp.
- Hva er dette? — oversikt og nav-pilot
- Kom i gang — installer tilpasninger
- Tilpasninger — agenter, instruksjoner, skills, prompts, MCP
- Applikasjoner — portalen, metrikker, MCP-register, onboarding
- Nav Tech Stack — stack som dekkes
- Repository Structure — mappestruktur
- Bidra — legg til tilpasninger
- Team
- Lisens
- Ressurser
nav-pilot er et CLI-verktøy og en AI-agent. CLI-et klargjør repoet ditt med riktige agenter, skills og instruksjoner, og sørger automatisk for en optimalisert integrasjon (inkludert token-optimalisering). Agenten (@nav-pilot) guider deg gjennom fire faser (Intervju → Plan → Review → Lever) i Copilot Chat.
# Installer nav-pilot CLI
brew install navikt/tap/nav-pilot
# Installer Kotlin-backend-samlingen i repoet ditt
cd /path/to/your/repo
nav-pilot install kotlin-backend
# Bruk i Copilot
@nav-pilot Jeg trenger en ny tjeneste som behandler dagpengesøknaderGå til min-copilot.ansatt.nav.no/verktoy, finn det du trenger og følg installeringsstega. MCP-servere har ferdige code --add-mcp-kommandoer du kan kopiere rett inn i terminalen.
- Agenter → — VS Code one-click, JetBrains via coding agent
- Instruksjoner → — Alle editorer
- Prompts → — VS Code, JetBrains
- Skills → — VS Code (
security-owaspdekker OWASP Top 10:2025 for Kotlin, Go, Java og Node.js) - MCP-servere → — Alle editorer
- Samlinger → — Installer alt på én gang
- nav-pilot → — CLI-verktøy og AI-agent for Nav-tilpasninger
- Testing → — Strukturelle og E2E-tester for nav-pilot
- Hold tilpasninger oppdatert → — Automatisk sync-workflow (som Dependabot)
Bruk MCP Onboarding-serveren for å utforske tilpasninger, sjekke agent-readiness og generere AGENTS.md — direkte fra Copilot Chat.
| Type | Beskrivelse | Dokumentasjon |
|---|---|---|
| 🤖 Agenter | Spesialiserte AI-assistenter for Nav-domener — bruk med @agent-name i Copilot Chat |
Agenter → |
| 📋 Instruksjoner | Kodestandarder som aktiveres automatisk basert på filmønster (*.kt, *.tsx, *.sql) |
Instruksjoner → |
| ⚡ Prompts | Scaffolding-maler tilgjengelig via #prompt-name i Copilot Chat |
Prompts → |
| 🎯 Skills | Produksjonsmønstre med innebygde maler og referanser | Skills → |
| 🔌 MCP-servere | Nav-godkjente servere fra MCP-registeret | MCP-servere → |
| 🔄 Sync | Hold tilpasninger oppdatert automatisk (som Dependabot) | Sync → |
| 📦 Samlinger | Installer en hel pakke med agenter, skills og instruksjoner på én gang | Samlinger → |
| 🧭 nav-pilot | CLI-verktøy og AI-agent som installerer og bruker Nav-tilpasninger i Copilot Chat | nav-pilot → |
Monorepo med fem applikasjoner + cplt (eget repo):
Sandboxer AI-kodingsagenter med OS-primitiver (macOS Seatbelt, Linux Landlock + seccomp-BPF). Blokkerer filsystemtilgang, nettverkstrafikk og credential-exfiltration.
Repo: navikt/cplt · Docs: min-copilot.ansatt.nav.no/cplt
brew install navikt/tap/cpltAdministrer Copilot-abonnement, se bruksstatistikk og utforsk tilpasninger fra verktøykatalogen. Har også offentlige sider for cplt, nav-pilot og kom i gang.
URL: min-copilot.ansatt.nav.no
Go-tjeneste som håndterer BigQuery-analyser, GitHub API-operasjoner og seat-administrasjon. Bruker Azure AD On-Behalf-Of (OBO) token exchange for sikker kommunikasjon.
- 11 API-endepunkter for bruksdata, adopsjon, tilpasninger, fakturering og seat-administrasjon
- In-memory cache (1t TTL) for BigQuery-data
- Bakgrunnsinnsamling av metrikker hvert 5. minutt
- Audit logging av alle seat-endringer
Arkitektur: Se ARCHITECTURE.md
Naisjob som henter daglige Copilot-bruksmetrikker fra GitHub API og lagrer i BigQuery.
Offentlig register over Nav-godkjente MCP-servere. Implementerer MCP Registry v0.1-spesifikasjonen.
URL: mcp-registry.nav.no
Nav har konfigurert MCP-policyen på organisasjonsnivå:
- MCP servers in Copilot: Enabled
- MCP Registry URL:
https://mcp-registry.nav.no - Policy: Registry only (kun servere fra registeret kan brukes)
Denne policyen håndheves automatisk for alle med Copilot-sete i navikt-organisasjonen. Enkeltbrukere kan ikke endre policyen.
Håndhevelse: Basert på server name/ID-matching. Lokale servere (som IntelliJ MCP) må ha en oppføring i registeret med ID som matcher nøyaktig det installerte server-ID-et. Se GitHub docs: MCP allowlist enforcement.
Registry-servere dukker automatisk opp i MCP-panelet i VS Code og JetBrains. Ingen oppsett per bruker.
# Bla gjennom tilgjengelige servere
curl -s https://mcp-registry.nav.no/v0.1/servers | jq
# Legg til en server
gh copilot mcp add --url https://mcp-onboarding.nav.no/mcpMCP-server for å utforske Nav Copilot-tilpasninger, vurdere agent-readiness og generere AGENTS.md.
- Åpne Command Palette i VS Code (
Cmd+Shift+P) - Kjør MCP: Add Server
- Søk etter Mcp Onboarding i Nav MCP-registeret
- Logg inn med GitHub (krever navikt-medlemskap)
List all Nav agents
Search for kafka customizations
Check agent readiness for navikt/fp-sak
Generate AGENTS.md for navikt/fp-sak
Show agent readiness for repos with prefix fp
Tips:
- Erstatt
fp-sakmed ditt reponavn inavikt/.- For
team_readiness, bruk repo-prefiks teamet bruker (f.eks.fpfor foreldrepenger), ikke fullt teamnavn.
Tilpasningene dekker Navs kjernestack:
- Backend: Kotlin, Ktor, PostgreSQL, Kafka
- Frontend: Next.js 16+, React, TypeScript, Aksel Design System
- Plattform: Nais (Kubernetes på GCP)
- Auth: Azure AD, TokenX, ID-porten, Maskinporten
- Observability: Prometheus, Grafana Loki, Tempo (OpenTelemetry)
├── .github/
│ ├── agents/ # Custom GitHub Copilot agents (.agent.md)
│ ├── instructions/ # File-pattern-based coding standards (.instructions.md)
│ ├── prompts/ # Task-specific scaffolding templates (.prompt.md)
│ └── skills/ # Production patterns with bundled resources
├── docs/ # Detailed documentation for each customization type
│ ├── README.agents.md
│ ├── README.instructions.md
│ ├── README.mcp.md
│ ├── README.prompts.md
│ ├── README.skills.md
│ ├── README.testing.md
│ └── README.collections.md
├── apps/ # Nav applications
│ ├── copilot-api/ # Go backend API (BigQuery, GitHub API, seat management)
│ ├── copilot-metrics/ # BigQuery data pipeline (Naisjob)
│ ├── mcp-onboarding/ # MCP server for agent readiness
│ ├── mcp-registry/ # MCP server registry
│ └── my-copilot/ # Next.js frontend portal
└── dashboards/ # Grafana dashboard definitions
- Agenter: Legg til
*.agent.mdi.github/agents/— se agent-dokumentasjonen - Instruksjoner: Legg til
*.instructions.mdi.github/instructions/ - Prompts: Legg til
*.prompt.mdi.github/prompts/ - Skills: Legg til mappe med
SKILL.mdi.github/skills/
Kjør mise check etter endringer for å validere alt.
Alle pull requests og merge queue-oppføringer kjører ci.yaml, som produserer én sjekk: ci-ok. Dette er den eneste required status check i branch-rulesettet — blir den grønn, kan PR-en merges via køen.
Slik fungerer det:
- Jobben
changesbruker dorny/paths-filter til å finne hvilke komponenter som er berørt av endringen (samme path-lister som komponent-workflowene bruker). Kun de berørte komponentenes sjekker kjøres — endrer du ingenting relevant, blirci-okgrønn med en gang. - gitleaks-skann av hele historikken kjører alltid, uavhengig av hvilke filer som er endret.
ci-okfeiler hvis en kjørt sjekk feiler eller avbrytes, og lykkes når alt som trengtes er grønt (hoppede jobber teller som OK).
Komponent-workflowene (copilot-api.yaml, my-copilot.yaml, osv.) kjører fortsatt på pull requests for PR-preview-deploy til dev, og på push til main for deploy til produksjon. De er bevisst ikke required checks og kjører ikke i merge-køen — deploys skal ikke skje per køoppføring.
CI skanner hele historikken med gitleaks. Vil du fange lekkasjer allerede før commit, installer gitleaks lokalt (brew install gitleaks) og legg til en valgfri pre-commit-sjekk:
gitleaks git --pre-commit --staged # Skanner kun stagede endringerFalske positiver håndteres i .gitleaks.toml.
Utvikleroppsett for applikasjonene
mise install # Installer verktøy
lefthook install # Aktiver pre-commit og commit-msg hooksHemmeligheter håndteres med fnox + macOS Keychain — ingen .env-filer. Hver app har en fnox.toml med nødvendige hemmeligheter:
| Service | Apper | Hemmeligheter |
|---|---|---|
copilot-portal |
my-copilot | GITHUB_APP_ID, GITHUB_APP_PRIVATE_KEY, GITHUB_APP_INSTALLATION_ID |
copilot-jobs |
copilot-adoption, copilot-metrics, mcp-onboarding | GITHUB_APP_ID, GITHUB_APP_PRIVATE_KEY, GITHUB_APP_INSTALLATION_ID, SLACK_WEBHOOK_URL |
cd apps/my-copilot
fnox set GITHUB_APP_ID # Ber om verdi, lagrer i Keychain
fnox set GITHUB_APP_PRIVATE_KEY
fnox set GITHUB_APP_INSTALLATION_IDIkke-hemmelig konfig (org-navn, BigQuery-datasett osv.) ligger i .mise.toml under [env] per app.
Annen secrets-backend? fnox.toml bruker macOS Keychain som standard, men du kan overstyre med 1Password, GCP Secret Manager osv. i en gitignored fnox.local.toml. Se fnox providers.
cd apps/my-copilot && mise dev # Starter med hemmeligheter via fnoxSe AGENTS.md for fullstendig utviklerguide.
Vedlikeholdes av Team Copilot i Nav IT.