🤖 Nav Copilot Customizations

Agenter, instruksjoner, skills og MCP-servere som gjør GitHub Copilot smartere for Navs stack. Alt samlet i én verktøyskatalog.

Hva er dette?

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

Innhold

• 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 — Nytt!

nav-pilot er et CLI-verktøy og en AI-agent. CLI-et installerer agenter, skills og instruksjoner i repoet ditt. 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øknader

Les mer → · Samlinger →

Kom i gang

Fra verktøysiden (anbefalt)

Gå 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.

Fra dokumentasjonen

• Agenter → — VS Code one-click, JetBrains via coding agent
• Instruksjoner → — Alle editorer
• Prompts → — VS Code, JetBrains
• Skills → — VS Code (security-owasp dekker 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)

Med MCP Onboarding

Bruk MCP Onboarding-serveren for å utforske tilpasninger, sjekke agent-readiness og generere AGENTS.md — direkte fra Copilot Chat.

---

Tilpasninger

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 →

---

🛠️ Applikasjoner

Monorepo med fem applikasjoner + cplt (eget repo):

cplt — Kernel-level sandbox for AI-agenter

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/cplt

My Copilot — Selvbetjeningsportal

Administrer 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

Copilot API — Backend for my-copilot

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

Copilot Metrics — BigQuery-datapipeline

Naisjob som henter daglige Copilot-bruksmetrikker fra GitHub API og lagrer i BigQuery.

MCP Registry — MCP-register

Offentlig register over Nav-godkjente MCP-servere. Implementerer MCP Registry v0.1-spesifikasjonen.

URL: mcp-registry.nav.no

Organisasjonsoppsett (allerede konfigurert)

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.

For IDE-brukere

Registry-servere dukker automatisk opp i MCP-panelet i VS Code og JetBrains. Ingen oppsett per bruker.

For Copilot CLI

# 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/mcp

MCP Onboarding — Agent Readiness

MCP-server for å utforske Nav Copilot-tilpasninger, vurdere agent-readiness og generere AGENTS.md.

URL: mcp-onboarding.nav.no

Installer

1. Åpne Command Palette i VS Code (Cmd+Shift+P)
2. Kjør MCP: Add Server
3. Søk etter Mcp Onboarding i Nav MCP-registeret
4. Logg inn med GitHub (krever navikt-medlemskap)

Bruk i Copilot Chat

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-sak med ditt reponavn i navikt/.
• For team_readiness, bruk repo-prefiks teamet bruker (f.eks. fp for foreldrepenger), ikke fullt teamnavn.

---

🏗️ Nav Tech Stack

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)

📖 Repository Structure

├── .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

---

🤝 Bidra

Legg til tilpasninger

1. Agenter: Legg til *.agent.md i .github/agents/ — se agent-dokumentasjonen
2. Instruksjoner: Legg til *.instructions.md i .github/instructions/
3. Prompts: Legg til *.prompt.md i .github/prompts/
4. Skills: Legg til mappe med SKILL.md i .github/skills/

Kjør mise check etter endringer for å validere alt.

Utvikleroppsett for applikasjonene

Forutsetninger: mise og fnox

mise install          # Installer verktøy
lefthook install      # Aktiver pre-commit og commit-msg hooks

Hemmeligheter 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_ID

Ikke-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 fnox

Se AGENTS.md for fullstendig utviklerguide.

---

👥 Team

Vedlikeholdes av Team Copilot i Nav IT.

---

📄 Lisens

MIT

---

🔗 Ressurser

• Nais Documentation
• Aksel Design System
• Nav GitHub