observability-setup

This repository provides specialized GitHub Copilot customizations for the Nav ecosystem:

• 🤖 [6 Custom Agents](#-agents) - Specialized AI assistants for Nav-specific domains (Nais, Aksel, Kafka, Auth, Observability, Security)
• 📋 [4 Instructions](#-instructions) - File-pattern-based coding standards that apply automatically
• ⚡ [3 Prompts](#-prompts) - Quick scaffolding templates for common Nav patterns
• 🎯 [5 Skills](#-skills) - Production-proven patterns extracted from real Nav repositories

Quick Install (One-Click)

Install customizations directly in VS Code using install badges in the documentation:

• [View all Agents →](docs/README.agents.md) - Click to install individual agents
• [View all Instructions →](docs/README.instructions.md) - Click to install coding standards
• [View all Prompts →](docs/README.prompts.md) - Click to install scaffolding templates

Discover & Search with MCP

Use our MCP Discovery Server to browse and install customizations directly from GitHub Copilot Chat.

#### For Nav Users (Enterprise Allow List)

This MCP server is pre-approved on Nav's enterprise allow list and available through the MCP registry:

1. Install from Extensions View:

• Open VS Code Extensions view (Cmd+Shift+X)
• Search for @mcp in the search bar
• Find Nav Copilot Discovery in the MCP servers list
• Click Install

2. Or install from IntelliJ:

• Open Settings → Tools → MCP Servers
• Browse available MCP servers
• Install Nav Copilot Discovery

3. Use Discovery Tools in Copilot Chat:

```text

@workspace /mcp list_agents

@workspace /mcp search_customizations query:"kafka"

@workspace /mcp get_installation_guide type:"agent" name:"nais-agent"

```

#### For Non-Nav Users (Manual Configuration)

1. Add to VS Code Settings (settings.json):

```json

{

"github.copilot.chat.mcp.enabled": true,

"github.copilot.chat.mcp.servers": {

"nav-discovery": {

"type": "streamable-http",

"url": "https://mcp-onboarding.nav.no/mcp"

}

}

}

```

2. Authenticate via GitHub OAuth (requires Nav organization membership)

3. Use Discovery Tools in Copilot Chat:

```text

@workspace /mcp list_agents

@workspace /mcp search_customizations query:"kafka"

@workspace /mcp get_installation_guide type:"agent" name:"nais-agent"

```

Available Discovery Tools:

• list_agents, list_instructions, list_prompts, list_skills - Browse all customizations
• search_customizations - Search by query, type, or tags
• get_installation_guide - Get install instructions for any customization

Install with VS Code Tasks

Run the task: "Install Nav Copilot Customizations" from VS Code tasks menu (Cmd+Shift+P → "Tasks: Run Task")

Or install individually:

• Install Copilot Instructions - Main project instructions
• Install All Agents - All 6 specialized agents
• Install All Instructions - All 4 file-pattern rules
• Install All Prompts - All 3 scaffolding templates
• Install All Skills - All 5 production patterns

---

Specialized AI assistants for the Nav ecosystem. Use them by calling @agent-name in Copilot Chat or when assigning issues to Copilot coding agent.

Available agents: @nais-agent, @auth-agent, @kafka-agent, @aksel-agent, @observability-agent, @security-champion-agent

👉 [View full agent documentation →](docs/README.agents.md)

---

File-pattern-based rules that Copilot applies automatically when creating or modifying files matching specific patterns.

Available instructions: Testing, Kotlin/Ktor, Next.js/Aksel, Database migrations

👉 **[View full instructions documenta