syfo-budstikka

Brukes når norsk tekst i syfo-budstikka skal skrives eller vaskes — feilmeldinger og API-feilrespons, loggmeldinger, README, ADR-er i docs/adr/, PR-beskrivelser, release-notes — eller når brukeren ber om klarspråk, språkvask, fjerning av AI-markører, retting av anglisismer, eller hjelp med norsk/engelsk terminologivalg i Ktor-backenden (pakke no.nav.syfo).

Bruk når en økt nærmer seg slutten eller kontekstvinduet blir trangt (vindu-trykk-checkpoint), arbeidet ikke er ferdig, og en fersk tråd skal overta uten å miste tråden. Eller når noen sier 'lag en handoff', 'oppsummer tilstanden', 'vi fortsetter i morgen', 'ny chat', 'jeg mister konteksten'. IKKE for å designe nytt (se /grill-with-docs) eller for sluttverifisering (se /tdd, /diagnosing-bugs).

Brukes når en vedtatt plan skal omsettes til kode i dette Ktor-backendet — typisk @grillmester fase 4 med `.grill/PLAN.md` på plass, eller når noen sier «implementer planen», «begynn på oppgave N», «kod opp dette», «start implementeringen». Trigger også når et plukket issue/snitt er klart for koding og du vil drive frem arbeidet steg for steg med bevis og atomiske commits.

Bruk når et Ktor-endepunkt skal legges til eller endres, en konsument skal få tilgang, eller en API-kontrakt brytes — accessPolicy.inbound, TokenX-/Azure AD-validering, versjonering, breaking changes og API-katalog. Triggere: 'nytt endepunkt', 'eksponere API', 'hvem kan kalle', 'breaking change', 'versjonere API', 'aud/issuer', ny route i Routing.kt.

Bruk når dette Ktor-backendet (no.nav.syfo) skal sette opp eller feilsøke autentisering/autorisering — innkommende JWT-validering, TokenX OBO, Azure AD M2M (client_credentials), Texas-sidecar, accessPolicy i Nais, eller når et endepunkt skal beskyttes. Trigger: 'beskytt dette endepunktet', 401/403-feil, 'hvilken auth skal denne kalleren ha', token-utveksling mot nedstrøms-tjeneste, audience/issuer-mismatch. Kalles via /auth-overview.

Bruk når et modul-grensesnitt skal designes eller forbedres i dette Ktor-backend-repoet: nytt service/repository/klient-lag, finne deepening-muligheter, bestemme hvor en seam (søm) skal ligge, gjøre kode mer testbar eller AI-navigerbar — eller når en annen skill trenger dyp-modul-vokabularet. @grillmester fase 2 (Design).

Brukes når du skal lage en commit eller skrive en commit-melding i dette Ktor-backend-repoet. Trigger-signaler: «commit», «commit-melding», «git commit», «hva skal stå i committen», eller når staged changes er klare og skal beskrives.

Bruk når domenespråket skal skjerpes eller skrives ned — et begrep er uklart eller overlastet, to ord brukes om samme ting, koden og praten er uenige om hva noe betyr, eller en vanskelig-å-reversere beslutning bør festes som ADR. Den aktive disiplinen i @grillmester fase 1, eller når noen sier 'hva mener vi egentlig med X', 'er dette samme som Y', 'skriv ned den beslutningen'.

Flyway-databasemigreringer i no.nav.syfo-backend — V__ SQL-filer, schema-endringer, backfill, indeksmigrering, rollback-plan og produksjonssikker rekkefølge. Brukes når du oppretter eller endrer en migrering, legger til/endrer tabell, kolonne eller indeks i Postgres.

Bruk når et design, en ny tjeneste eller en ikke-triviell endring skal stresstestes før koding, og du vil ha ADR + glossar som faller ut underveis. @grillmester fase 1–2, eller når noen sier 'design dette', 'er dette gjennomtenkt', 'grill dette designet'. For en rask plan-stresstest UTEN dokumentasjon: /grill-me.

Bruk når brukeren vil forbedre arkitekturen, finne refaktoreringsmuligheter, gjøre grunne moduler dypere, konsolidere tett koblede moduler, eller gjøre Ktor-koden mer testbar og lettere å navigere for både folk og AI. Også når noen sier 'forbedre arkitekturen', 'finn refaktoreringsmuligheter', 'denne koden er rotete/vanskelig å teste', 'for mange tynne lag', eller 'rute → service → klient-kjedene er uoversiktlige'.

Brukes når dette Ktor-backendet (no.nav.syfo) skal produsere eller konsumere Kafka-hendelser — ny eller endret consumer/producer, ny topic via Kafkarator, event-kontrakt, key-strategi, idempotens eller DLQ. Triggere: 'lytte på topic', 'publisere hendelse', 'Kafkarator', 'Topic-CRD', 'consumer', 'producer', 'Rapids & Rivers', 'River', '@event_name', 'kafka.pool', 'DLQ', 'idempotent konsument'.

Bruk når dette Ktor-backendet (no.nav.syfo) skal få nytt eller endret NAIS-manifest — nais.yaml for Application eller Naisjob: ingress, resources, probes, accessPolicy, Azure AD/TokenX, Kafka eller GCP Postgres. Trigger: 'lag et nais-manifest', 'eksponer appen', 'legg til database/Kafka/auth i nais', 'skaler opp i prod', CPU-throttling, OOM-kill, batch-/cron-jobb. Kalles via /nais-manifest.

Bruk når en tyngre arkitekturbeslutning bør festes som ADR: ny tjeneste/integrasjon mot annet team, nytt lagringslag eller event-kontrakt, ny auth-mekanisme, accessPolicy mot andre team, nye personopplysninger (DPIA), eller avvik fra NAV-standard. Triggere: 'skriv en ADR', 'arkitektur-review', 'bør vi X eller Y'.

Bruk når Ktor-backendet feiler i DRIFT på NAIS: pod starter ikke / CrashLoopBackOff / OOMKilled, 401/403, Kafka consumer-lag, DB-/HikariCP-/Flyway-feil ved startup, eller sprik mellom Mimir/Loki/Tempo. For design av schema/manifest/auth, se /nais-manifest, /auth-overview, /flyway-migration.

Brukes når du setter opp eller endrer DataSource/connection-pool i no.nav.syfo-backend, ser connection-feil i loggen, velger databaseteknologi, eller reviewer en schema-/migrasjonsendring i Postgres. Dekker HikariCP-pool og dimensjonering mot Cloud SQL/replicas, samspill med Flyway og koordinering av delte schemas.

Brukes når README eller repo-dokumentasjon i dette Ktor-backend-repoet skal opprettes eller oppdateres — når brukeren ber om å skrive/forbedre README, dokumentere API, Kafka, database, NAIS-oppsett eller auth, eller når README er utdatert mot faktisk kode og .nais-manifest. Trigges typisk av /readme-update.

Bruk når en git-merge eller -rebase i dette Ktor-repoet har stoppet med konflikter — 'CONFLICT (content)', '<<<<<<< HEAD'-markører i koden, 'fix conflicts and then commit', eller en merge/rebase som henger fast. Også når oppdatering mot main/master eller en PR-branch ender i konflikt.

Sikkerhetsgjennomgang av Ktor-backend i no.nav.syfo: PII/FNR/helseopplysninger i logger, secrets, CEF-auditlogg, accessPolicy i NAIS-manifestet, JWT-validering (TokenX/Azure AD), eksterne integrasjoner, DPIA og eskalering til sikkerhetschampion. Brukes før commit/push/PR med sikkerhetsrelevans, eller når noen sier /security-review.

Bruk når en plan, et design, en PRD eller `.grill/PLAN.md` skal brytes ned i selvstendig plukkbare GitHub-issues på navikt/syfo-budstikka. Typisk etter @grillmester sin plan-fase, eller når noen sier 'lag issues', 'splitt opp i tickets', 'bryt ned arbeidet', 'lag epic + sub-issues'.

Bruk når du skal skrive en ny Copilot-skill, endre eller forbedre en eksisterende skill under .github/skills/ i dette repoet, eller vurdere om en skill trigger riktig — typisk når noen sier 'lag en skill', 'skriv en copilot-skill', 'forbedre denne skillen', 'hvorfor fyrer ikke skillen', eller /writing-great-skills.

Bruk når et GitHub-issue på navikt/syfo-budstikka skal opprettes eller håndteres gjennom livsløpet sitt — epic + sub-issues, avhengigheter, prosjektboard-status, ferdigmelding og PR-kobling. Typisk når noen sier 'lag et issue', 'opprett en sak/epic', 'koble disse issuene', 'sett issuet i gang', 'meld ferdig', eller når @grillmester skal spore arbeid mot tracker. For å bryte en hel PLAN ned i mange snitt: bruk /to-issues i stedet.

Bruk når en endring i navikt/syfo-budstikka skal pakkes til en pull request, eller en eksisterende PR skal oppdateres — semantisk tittel, kort beskrivelse, issue-kobling, teststatus (./gradlew test), risiko og reviewer-kontekst. Trigger når noen sier 'opprett PR', 'lag pull request', 'oppdater PR-en', eller etter at et vertikalt snitt er implementert og verifisert i @grillmester sin faseløkke.

Brukes når du skal bygge ny funksjonalitet eller fikse en feil test-først i dette Ktor-backendet — når noen nevner "red-green-refactor", "test først", ber om en reproduksjonstest for en bug, eller vil ha integrasjonstester mot en route/tjeneste. Trigger også når du står foran et nytt endepunkt, en ny domenetjeneste eller en Kafka-/databasenær endring og vil drive frem grensesnittet via tester.

Bruk når en løs idé skummer av seg FLERE sammenkoblede, åpne beslutninger som ikke kan avgjøres i én økt — du må gjøre avhengighetene og avveiningene synlige før du velger. @grillmester fase 1–2, når noen sier 'det henger sammen med...', 'vi må avgjøre X først', 'tegn opp beslutningstreet', 'dette blir for stort for én økt', eller når en /grill-with-docs-økt drukner i åpne valg som peker på hverandre.

Bruk ved arbeid på Ktor-backend i no.nav.syfo: nye routes/plugins, ContentNegotiation, auth (TokenX/Azure AD, JWT-claims som NAVident), Koin DI, CallId/CallLogging/MDC, StatusPages/ApiError-feilkontrakt, paginering, input-validering, Postgres/Flyway/Kafka-oppsett, avhengigheter via version catalog — eller når noen sier /kotlin-ktor.

Brukes når du skal gå gjennom DIN EGEN diff før du ber om kryssmodell-review (grill-inspektor) eller åpner PR: en uforpliktet endring, en branch mot main, eller diffen siden et fast punkt skal granskes for korrekthet, regresjon, kanttilfeller og scope. Trigget når du nettopp har skrevet ferdig kode i implementer-fasen, eller når noen sier 'selvreview', 'gå gjennom egen diff', 'review før PR', 'review siden X'.

Bruk ved etablering eller forbedring av observability i syfo-budstikka: Micrometer-metrikker og PrometheusMeterRegistry i Ktor, MicrometerMetrics-plugin, /internal/isalive|isready|prometheus, strukturert JSON-logging med trace_id/callId, korrelasjons-ID (Nav-Callid/x_request_id), OpenTelemetry-tracing, PromQL/LogQL, Grafana-dashboards og Prometheus-alerts i NAIS — eller når noen sier /observability-setup.

Bruk når et design er for usikkert for papir og du vil teste det med kjørbar kast-vekk-kode FØR du forplikter deg — datamodell, tilstandsmaskin, API-/feilkontrakt eller Kafka-flyt (idempotens/replay). Triggere: 'spike dette', 'la meg leke med det', 'er datamodellen riktig', 'prøv et par varianter'.

Bruk når innkommende issues/bug-meldinger på navikt/syfo-budstikka skal vurderes og klargjøres: klassifiser, verifiser påstanden, avklar, prioriter, gjør AFK-klar. Triggere: 'triage', 'gå gjennom innboksen', 'se på #42', 'er denne buggen ekte'. Ikke for å bryte en ferdig plan i issues (se /to-issues).

Bruk når en feil skal diagnostiseres systematisk — noe kaster, feiler, henger eller er tregt i test eller drift, en flaky test, en ytelsesregresjon, eller et runtime-symptom på NAIS (pod-krasj/OOMKilled, 401/403, Kafka consumer lag, DB-timeout, Flyway-feil). Eller når noen sier 'debug dette', 'diagnostiser', 'hvorfor feiler X'. IKKE for å designe ny funksjonalitet (se /grill-with-docs).

Bruk når en ferdig-grillet idé eller design skal støpes til et PRD og legges på issue-trackeren — UTEN nytt intervju, bare syntese av det som allerede er diskutert i tråden og skrevet til .grill/. @grillmester rett etter design/plan-fasen, eller når noen sier 'skriv et PRD', 'lag kravspec', 'oppsummer dette til en sak'.

Bruk når du vil ha en rask, nådeløs stresstest av en plan eller idé UTEN den fulle design-/dokumentasjonsflyten. Si 'grill meg'. For full design med ADR/glossar, bruk /grill-with-docs i stedet.