メニュー
Arkitektur-review og ADR for Nav — systemgrenser, eierskap, dataflyt, plattform, sikkerhet, DPIA, TokenX, accessPolicy og beslutningsdokumentasjon. Brukes via /nav-architecture-review ved arkitekturbeslutninger.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | nav-architecture-review |
| description | Arkitektur-review og ADR for Nav — systemgrenser, eierskap, dataflyt, plattform, sikkerhet, DPIA, TokenX, accessPolicy og beslutningsdokumentasjon. Brukes via /nav-architecture-review ved arkitekturbeslutninger. |
Skriv Architecture Decision Records (ADR) og gjør tyngre arkitektur-review for Nav-apper. Skillen dekker det som er Nav-spesifikt: Nais/GCP-plattformen, TokenX/Azure AD/ID-porten/Maskinporten, accessPolicy, Datatilsynet/DPIA og Navs arkitekturprinsipper (Team First, Architecture Advice Process, foretrekk plattform-kapabiliteter).
Generisk stoff om "hva er en ADR" eller generiske security-OWASP-lister er ikke replikert her — bruk det fra ditt eget repertoar.
Aktiveres av inspektor-claude/inspektor-gpt i hovmester Steg 4 for tyngre arkitekturendringer. Typiske signaler:
accessPolicy-oppdatering hos andre team, eller ny auth-mekanisme (TokenX/Azure AD/ID-porten/Maskinporten).Lettere valg (biblioteksvalg innenfor eksisterende stack, intern refaktor) trenger ikke formell ADR.
Evaluer endringen fra tre perspektiver før ADR-en konkluderer. Skriv én til tre linjer per perspektiv — noter bekymring, risiko og anbefaling.
accessPolicy (inngang/utgang), PII-beskyttelse i logg/lagring/transport, behov for DPIA.Full sjekkliste med Nav-spesifikke spørsmål per perspektiv ligger i references/perspektiv-sjekklister.md.
Ved endring av eksisterende system: ta også med migrasjon (bakoverkompatibilitet, rollback-plan, feature toggle, exit criteria, dekommisjonering).
Før du anbefaler løsning: sjekk hva teamet faktisk kjører (Kotlin/Ktor, Kotlin/Spring, Next.js, fullstack). Forslagene i ADR-en skal matche det stacket — ikke tvinge teamet over på noe annet uten at det er selve beslutningen.
Dokumenter minst to alternativer pluss "gjøre ingenting". Navs Architecture Advice Process er rådgivende, ikke godkjenningsbasert: teamet søker råd fra berørte parter, men eier beslutningen selv. Identifiser berørte team tidlig og del utkast-ADR med dem før beslutning fattes.
Bruk malen i references/adr-template.md. Lagre ADR-er under docs/adr/ADR-{nummer}-{kort-tittel}.md i teamets repo.
Korte ADR-er er best — én beslutning per ADR. Oppdater status når beslutningen er tatt; bruk "Erstattet av ADR-{n}" når en beslutning revideres.
nais-manifest — manifest-struktur, resources, accessPolicy, Cloud SQL, Kafka pool.auth-overview — Azure AD, TokenX, ID-porten, Maskinporten, Texas/Oasis.security-review — dypere sikkerhetsgjennomgang, trusselmodellering, PII-håndtering, DPIA-vurdering.observability-setup — metrikker, logging, tracing, varsling.nav-troubleshoot — drift-diagnose, ikke design.accessPolicy, Nais-endringer.accessPolicy).Utforsk designkonsepter visuelt med Aksel-tema i nettleser, og lever som Figma-skisse. Brukes via /prototype når et konsept skal visualiseres.
Klarsprak-skillen veileder klarspråk og språkvask av feilmeldinger, mikrotekst og AI-markører i norsk tekst. Brukes via /klarsprak når brukeren ber om klarspråk, språkvask, AI-markører, feilmeldinger eller mikrotekst.
Feilsøking av runtime-problemer i Nav-miljø — pod crash, OOMKilled, 401/403, auth-feil, Kafka lag, DB-timeout, Flyway-feil, logger og Nais-diagnostikk. Brukes via /nav-troubleshoot ved driftsfeil.
Sikkerhetsgjennomgang for Nav-applikasjoner — PII, FNR, helseopplysninger, secrets, logging, auditlogg, accessPolicy, eksterne integrasjoner, DPIA og sikkerhetschampion. Brukes via /security-review ved sikkerhetsreview.
UU/WCAG-review for Nav-frontend — tastaturflyt, skjermleser, axe, kontrast, fokus, feilmeldinger, skjema og Aksel-bruk. Brukes via /accessibility-review før PR eller release.
Dulting (nudging) i Nav-tjenester — utforsk muligheter, design intervensjoner og prototype med EAST, Fogg og FORGOOD-etikk. Brukes via /dulting ved utforsking av dulting-muligheter eller design av atferdsintervensjoner.