🤖 Nav Copilot Customizations

Nav Copilot tools page

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 kuratert samling Copilot-tilpasninger for Nav-økosystemet:

🤖 10 Agenter — Spesialiserte AI-assistenter for Nav-domener
📋 8 Instruksjoner — Kodestandarder som aktiveres automatisk basert på filmønster
⚡ 5 Prompts — Scaffolding-maler for vanlige Nav-mønstre
🎯 12 Skills — Produksjonsmønstre fra ekte Nav-repoer
🔌 MCP-servere — Nav-godkjente MCP-servere fra registeret

Alle tilpasninger er tilgjengelige fra Verktøy-siden med søk, domenefiltrering og installasjonsinstruksjoner.

Kom i gang

Fra verktøysiden (anbefalt)

Gå til min-copilot.ansatt.nav.no/verktoy, finn det du trenger, og følg installasjonsinstruksjonene. MCP-servere har ferdig 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

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 →

🛠️ Applikasjoner

Monorepo med fire applikasjoner:

My Copilot — Selvbetjeningsportal

Administrer Copilot-abonnement, se bruksanalyse, og utforsk alle 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 — Serveroppdagelse

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:

Enable MCP servers in Copilot
Set MCP Registry URL: https://mcp-registry.nav.no
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

Å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)

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 on 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.collections.md
├── apps/                 # Nav applications (my-copilot, copilot-metrics, mcp-registry, mcp-onboarding)
└── dashboards/           # Grafana dashboard definitions

🎯 Why Use Nav Copilot Customizations?

Nav-Specific: Pre-configured for Nais platform, Aksel Design System, and Nav tech stack
Production-Proven: Patterns extracted from real Nav applications
Consistent Standards: Enforces Nav development principles and best practices

🤝 Contributing

To add new customizations:

Agents: Add *.agent.md to .github/agents/ following the agent docs
Instructions: Add *.instructions.md to .github/instructions/
Prompts: Add *.prompt.md to .github/prompts/
Skills: Add folder with SKILL.md to .github/skills/

For detailed contribution guidelines and development setup, see AGENTS.md.

📄 License

See LICENSE file.

copilot