Grunnlaget du må ha på plass før du slipper agenter løs på kodebasen.
Anbefaling: Skriv beskrivelser og kommentarer på norsk hvis det passer teamet. Hold kode, kommandoer, variabelnavn og tekniske termer på engelsk. Dette matcher vanlig praksis i norske utviklingsmiljøer og sikrer at Copilot forstår koden din korrekt.
1. AGENTS.md (repo-rot)
En universell kontekstfil som fungerer med Copilot, Claude Code, Codex og andre agenter. Beskriv tech stack, bygg-kommandoer, kodestil og grenser.
Tenk på det som onboarding-dokumentet for en ny utvikler – det er nøyaktig det AI-agenter trenger for å forstå prosjektet ditt.
2. copilot-setup-steps.yml
GitHub Actions workflow som klargjør miljøet for Copilot coding agent. Uten denne filen kan ikke coding agent bygge eller teste koden din.
Plasseres i .github/workflows/copilot-setup-steps.yml.
Bruk MCP onboarding-serveren for å sjekke repoets agent-beredskap og generere begge filene automatisk.
Når: Engangsoppgaver
Aktivering: /prompt-name i chat
Eksempel:"Lag README for denne modulen"
Filformat: .github/prompts/*.prompt.md
Når: Alltid aktiv
Aktivering: Automatisk på matchende filer
Eksempel: TypeScript kodestil, navnekonvensjoner
Filformat: .github/instructions/*.instructions.md
Når: Spesialiserte oppgaver
Aktivering: @agent-name
Eksempel: @nais-agent, @aksel-agent, @kafka-agent
Filformat: .github/agents/*.agent.md
Når: Automatisk ved behov
Aktivering: Automatisk når relevant
Eksempel: PDF-ekstraksjon, API-testing
Filformat: .github/skills/*/SKILL.md
← Swipe for flere eksempler →
Analyse av over 2500 agents.md-filer viser at de beste dekker disse områdene:
1. Kommandoer
Kjørbare kommandoer tidlig: npm test, pnpm build
2. Testing
Testrammeverk, hvor tester ligger, coverage
3. Prosjektstruktur
Mappestruktur, hvor kode hører hjemme
4. Kodestil
Kodeeksempler over forklaringer
5. Git-workflow
Branch-strategi, commit-meldinger
6. Grenser
Hva agenten aldri skal gjøre
Sjekk disse punktene for å gjøre repoet ditt klart for AI-agenter. Tilpasninger + verifikasjon = 14 poeng totalt.
Tilpasninger (8 poeng)
AGENTS.md
Universell kontekst (alle agenter)
copilot-setup-steps.yml
Coding agent miljøoppsett
copilot-instructions.md
Copilot-spesifikke instruksjoner
.github/instructions/
Filtype-spesifikke regler
.github/agents/
Spesialiserte agenter
.github/prompts/
Gjenbrukbare prompts
.github/skills/
Kapabiliteter med skript
.github/hooks/
Automatisk lint/format
Verifikasjonsinfrastruktur (6 poeng)
CI/CD workflows
Automatisert bygg og test i GitHub Actions
Linter-konfigurasjon
ESLint, golangci-lint, detekt
Typesjekking
tsconfig.json, Go/Kotlin/Rust (innebygd)
Testkonfigurasjon
Jest, Vitest, eller innebygd (Go, JVM)
Dependabot
Automatiske avhengighetsoppdateringer
README.md
Dokumentasjon agenter leser først