handoff

name	handoff
description	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).

handoff

Komprimer tilstanden i den pågående økta til .grill/STATE.md slik at en fersk tråd kan plukke opp arbeidet uten å lese hele samtalen på nytt. Dette er disk-som-minne: konteksten lever på disk i .grill/, ikke i et chat-vindu som forsvinner.

Når du skriver (vindu-trykk-checkpoint)

Lag eller oppdater handoff når minst én holder:

• En fase drar ut eller du nærmer deg en fase-grense, og arbeidet er ikke ferdig — skriv før du blir tvunget, ikke når det allerede er for sent å oppsummere godt. Du kan ikke måle vindu-prosenten din, så ikke vent på et tall; fase-grensen og «drar dette ut?» er triggeren.
• Brukeren signaliserer pause / trådbytte / ny chat.
• En @grillmester-fase er fullført og neste fase skal kjøres i en fersk tråd (design → plan → implementer → verifiser).

Venter du til vinduet er fullt, har modellen allerede mistet detaljene du trenger for en god handoff. Sjekkpunktet er hele poenget.

Kontrakt

1. Skriv til .grill/STATE.md — én fil, fast plass. Ikke til OS-temp, ikke et tilfeldig navn. Neste tråd leser STATE.md først (samme konvensjon som /diagnosing-bugs).
2. Ikke dupliser det som allerede ligger i artefakter. docs/context.md (mental modell), docs/adr/ (beslutninger), .grill/PLAN.md (planen), .grill/VERIFICATION.md (ferskt grønt bevis), GitHub-issues, commits og diff bærer sin egen tilstand. Referér dem med sti/URL — ikke kopier innholdet inn.
3. STATE.md er flyktig og overskrivbar. Den fanger hvor vi er akkurat nå. Varige beslutninger hører hjemme i ADR, ikke her — oppstår en ny vanskelig-reversibel beslutning, løft den til docs/adr/ via /nav-architecture-review og referér den.
4. Redaksjon (NAV) — håndhevet av gate, ikke bare oppfordring. Aldri fnr, tokens, passord, navn eller særlige kategorier i STATE.md. Logg ID-er/correlation (callId, Nav-Call-Id), branch-navn, issue-nummer, filstier — ikke personopplysninger eller hemmeligheter. .grill/ er gitignorert (.gitignore), men behandles som om den var offentlig (defense-in-depth). Dette håndheves av pre-commit-gaten scripts/scan-grill-pii.sh (aktiveres med git config core.hooksPath .githooks), som skanner .grill/ og alt som stages, og blokkerer commit ved mistanke om PII/hemmelighet.
5. Handlingsrettet, ikke referat. Neste tråd skal kunne ta neste steg fra første avsnitt. Kutt prosa om hva som ble diskutert; behold hva som ble besluttet og hva som gjenstår.
6. Hold den liten og kuratert — readback er hele gevinsten. STATE.md leses tilbake inn i en fersk tråd, så den skal være et lite, rent delsett — ikke en voksende logg. Tommelfingerregel: får den ikke plass på ~ett skjermbilde, komprimer. Marker superseding ved å slette: når en ny beslutning erstatter en tidligere, fjern den gamle linja — ikke la begge stå. En foreldet oppføring ved siden av sin revisjon er en «confident-wrong» distraktor som skader den ferske tråden mer enn fravær gjør. Mål det du faktisk leser tilbake, ikke bare at fila ble skrevet.

STATE.md-mal

# STATE — <kort tittel> (<dato>)

## Hvor vi er
<1–3 setninger: hvilken @grillmester-fase, hvilken branch, hva som er gjort så langt.>
Branch: <navn>  ·  Issue/PR: <#nr / URL>

## Beslutninger tatt i denne økta
- <beslutning> → ADR `docs/adr/NNNN-...md` (hvis vanskelig å reversere)
- <lettere valg som ikke fortjener ADR, men neste tråd må vite>

## Hva gjenstår
- [ ] <konkret oppgave>
- [ ] <konkret oppgave>

## Neste steg (start her)
1. <første konkrete handling den ferske tråden bør gjøre>
2. <...>

## Kontekst som ikke ligger andre steder
- <fallgruver, blindveier vi allerede har utelukket, halvferdige greier i arbeidstreet>
- Uncommitted endringer: <ja/nei — hva> (`git status`)

## Referanser (ikke duplisert her)
- Mental modell: `docs/context.md`
- Plan: `.grill/PLAN.md`
- Beslutninger: `docs/adr/`
- Verifikasjon: `.grill/VERIFICATION.md`
- Issue/PR: <URL>

## Foreslåtte skills for neste tråd
- `/<skill>` — <hvorfor akkurat nå>

Foreslåtte skills (alltid med)

Avslutt alltid STATE.md med en seksjon som peker neste tråd til riktig skill for neste steg. Velg ut fra hvor i faseløkka arbeidet står:

• /grill-with-docs — designet er ikke ferdig stresstestet (fase 1–2).
• /codebase-design eller /api-design — modul-/endepunktsform skal avklares.
• /tdd — implementasjon gjenstår, test-først.
• /diagnosing-bugs — en feil er åpen og må jaktes systematisk.
• /nav-architecture-review — en arkitekturbeslutning venter på ADR.
• /security-review, /postgresql-review, /kafka-topic, /nais-manifest, /flyway-migration — når neste steg treffer det respektive området.

Etter skriving

Bekreft kort til brukeren: sti til STATE.md, og at en fersk tråd kan starte med "les .grill/STATE.md". Ikke gjenta innholdet i chatten — det er nå på disk.