🤖 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:

• 🤖 12 Agenter — Spesialiserte AI-assistenter for Nav-domener
• 📋 14 Instruksjoner — Kodestandarder som aktiveres automatisk basert på filmønster
• ⚡ 7 Prompts — Scaffolding-maler for vanlige Nav-mønstre
• 🎯 22 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 Navs AI-utviklerverktøy — én agent med en 4-fase modell (Intervju → Plan → Review → Lever) som koder inn Navs institusjonelle kunnskap. Installer en samling, bruk @nav-pilot, og gå fra idé til Nav-kompatibel arkitekturplan.

# 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
• MCP-servere → — Alle editorer
• Samlinger → — Installer alt på én gang
• nav-pilot → — Navs AI-utviklerverktøy
• 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	Planleggingsagent som koder inn Navs institusjonelle kunnskap	nav-pilot →

---

🛠️ Applikasjoner

Monorepo med fire applikasjoner:

My Copilot — Selvbetjeningsportal

Administrer Copilot-abonnement, se bruksstatistikk og utforsk tilpasninger fra verktøykatalogen.

URL: min-copilot.ansatt.nav.no

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

For Enterprise/Organization Admins

Enterprise Settings → AI Controls → MCP:

1. Enable MCP servers in Copilot
2. Set MCP Registry URL: https://mcp-registry.nav.no
3. Choose policy: Allow all (discoverable) or Registry only (enforced)

Important: Use the base URL without any path suffix. The Copilot client appends /v0.1/servers automatically.

For IDE-brukere

Registry-servere dukker automatisk opp i MCP-panelet i VS Code og JetBrains når registeret er konfigurert på organisasjonsnivå. 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 (my-copilot, copilot-metrics, mcp-registry, mcp-onboarding)
└── 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

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