okr/docs/plan-referansegrad-2026-06-23.md

Utførelsesplan: OKR-plugin → referansegrad (norsk offentlig sektor)

Dato: 2026-06-23 Grunnlag: docs/evaluering-360-2026-06-23.md (360-evaluering, 14 agenter) + adversariell plan-critic-runde. Status i dag: Samlet karakter C+. Sterkt fundament (arkitektur, hooks, metodikk-kjerne, ekte forvaltningstilpasning), trukket ned av troverdighetskritiske innholdsfeil. Mål: Lukke alle funn i fire faser slik at pluginet trygt kan deles og fungere som referanse. Hver fase er et eget Voyage-løp over én eller flere sesjoner.

Denne planen er kritikk-korrigert: plan-criticen avdekket at synteserunden underestimerte flere leveranser (DDT = 61 forekomster i 14 filer, ikke 2; UTF-8 = total ASCII-stripping som krever omskriving, ikke encoding-fiks; scoring-linjelista var ufullstendig og delvis feilrettet; versjon-per-fase manglet; Fase 1/2 deler filer). Alle disse er innarbeidet under.

---

1. Slik følger vi planen (driftsmodell)

1. Én fase = ett Voyage-løp. /trekbrief (ramme + verifiseringskriterier) → /trekplan (fil-for-fil steg) → /trekexecute → /trekreview (mot brief-kriteriene). Flersesjons faser bruker .session-state + /trekcontinue.
2. Hvert /trekplan-steg MÅ bære On-failure: og Checkpoint: (git commit). Destruktive steg merkes circuit-breaker: ved feil → stopp hele fasen, ikke fortsett.
3. Verifiseringsplikt. Hver fase avsluttes med konkrete bevis (grep-/spellcheck-kommandoer som beviser at funnet er borte og at ingen nye er introdusert). Ingen fase er «ferdig» uten grønne bevis.
4. Versjon per fase. Hver fase som endrer brukervendt innhold/funksjon bumper versjon + lager release-tag + oppdaterer katalog-ref (catalog/scripts/release-plugin.mjs <plugin> <versjon>), innenfor push-vinduet. Se §6.
5. STATE.md oppdateres ved hver sesjonslutt (local-only, gitignored — offentlig remote).
6. Scope-guard. Ingen fase utvider seg utover sine leveranser uten ny godkjenning.

---

2. Beslutningsport FØR Fase 0 (avgjøres i /trekbrief)

DDT-beslutning. «Direktoratet for digital tjenesteutvikling (DDT)» er fiktiv og brukes som løpende eksempel-etat. Verifisert omfang: 61 forekomster i 14 filer (28 i okr-offentlig-governance.md, 7 i okr-integrations.md, 4 hver i okr-examples.md/okr-framework.md, flere i oppsett.md m.fl.). To veier:

Valg	Hva	Innsats	Konsekvens
(a) Merk fiktiv (anbefalt for rask troverdighet)	Konsekvent «(fiktiv eksempeletat)» + disclaimer ved første bruk; behold alle eksempler	Mekanisk, én grep-verifisert pass over alle 61	Rask, lav risiko. Eksemplene forblir koherente.
(b) Splitt i reelle etater	Statens vegvesen (vei/trafikk) + Digdir (digitale tjenester)	Egen dedikert fase (2-3 sesjoner) mellom Fase 0 og Fase 1	Omskriver tildelingsbrev-, kaskade- og metrikk-eksempler. Fase 1 avhenger av hvilken etat som «eier» hvilket eksempel.

Default i denne planen: (a). Velges (b), settes en egen «Fase 0b — Etats-resplitt» inn, og Fase 1 omdefineres til å bygge på de nye etatene. Avgjør i brief, ikke i utførelse. Uansett valg: fjern den fabrikkerte kilde-attribusjonen «Oboard (Direktoratet for digital tjenesteutviklings valg)» (okr-sources.md:299) og DDT fra README-listen over reelle brukere (README.md:23).

---

3. Fase 0 — Fakta- og troverdighetssanering (credibility-critical)

Avhenger av: ingenting. Estimat: 2-3 sesjoner (oppjustert fra 1-2 etter kritikk: UTF-8 = omskriving av 2 hele filer; DDT = 61 sites). Versjon ved slutt: 1.3.1 (patch). Hvorfor først: alt annet bygger på at teksten er til å stole på.

Leveranser (hver med On-failure + Checkpoint):

1. [CIRCUIT-BREAKER, flyttet hit fra Fase 2] OKR-01 rm -rf-validering. Høyeste data-tap-risiko. Valider at [id] matcher ^[TQ][1-4]-[0-9]{4}$ og er ikke-tom før rm -rf .claude/okr/syklus/[id]/ i oppsett.md:457/459. Manuell test: tom + malformert id skal avvises. On-failure: halt hele fasen.
2. DDT per beslutningsporten (default: merk fiktiv). Grep-fasit: grep -rni 'DDT\|Direktoratet for digital tjenesteutvikling' . → forvent 61 → 0 umerkede. Fjern fabrikkert Oboard-attribusjon + DDT fra README reell-bruker-liste.
3. Find-replace-artefakter. Re-derivér full målliste (ikke stol på synteselista alene): grep -rni 'saksbehandlingbehandling\|saksbehandlingtjenester\|saksbehandlingklager\|saksbehandling-søknad\|saksbehandlingsøknad\|vevedlikehold\|fornye saksbehandling' .. Rett til koherent domene. Regresjonssjekk: blanket-erstatninger må ikke mangle korrekte sammensetninger — bevis 0 GAMLE og 0 NYE artefakter.
4. ÉN kanonisk scoringsterskel. Re-derivér: grep -rn '0\.[567]-0\.[789]\|70-80%\|0\.7 =' .. Innfør overalt: «0.7 = forventet for aspirational; 0.6-0.7 = sweet spot (Google/Doerr)». BEVAR okr-sources.md:44 og :115 (de ER kanon 0.6-0.7 — ikke slett). Fjern 0.7-0.9 (okr-cheatsheet.md:48, fremdriftssporer-agent.md:44) og 70-80% (governance.md:73). Inkluder styringsrådgiver-agent.md:90. Avklar: analyse.md:138-139 (0.5-0.7/>0.7) er trolig tverr-syklus modenhet ≠ enkelt-OKR stretch-score → sannsynlig utenfor scope; bekreft før endring. Verifisering: nøyaktig én stretch-definisjon, kanonisk kilde ikke rørt.
5. [CIRCUIT-BREAKER] UTF-8: manuell norsk omskriving av individual-vs-team-okr.md og commands/oppsett.md (begge 0 å + 0 ø/æ — total ASCII-stripping, ingen ren kilde å «regenerere» fra). Dette er korrekturlesing/omskriving, ikke encoding-fiks. Checkpoint (git) før start. Verifisering: spellcheck (aspell -l nb eller kuratert vokabular-diff mot øvrige referansefiler) — ikke bare å > 0 (en fil kan ha riktig å men feil ø/æ).
6. ASCII-kommandonavn. grep -rn '/okr:moter\|/okr:innforing\|oppstartsmate' . → inkluderer README.md (L106/114/166), oppsett.md (L246/478), coaching-hook.mjs (L125). Rett til /okr:møter, /okr:innføring.
7. coaching-hook-strenger + læring-regex. coaching-hook.mjs:115/124/125 (brukervendte strenger, synlig hver sesjonsstart) + L100 regex → /## (?:Laering|Læring)/.
8. Døde/feil lenker + dokumenttittel. futureworks.no (404) fjern/erstatt; rework.withgoogle.com normaliser til /en/-form + Wayback-fallback; rett tittel til «Fremtidens digitale Norge — Nasjonal digitaliseringsstrategi 2024-2030» (governance.md:395).
9. Dokument-motsigelser. CONTRIBUTING PR-seksjon → kryssreferanse til GOVERNANCE; SECURITY GitHub → Forgejo/e-post; uciterte statistikker (39/43/30-45/60%) merk «industri-rapportert (ikke fagfellevurdert)» eller erstatt med Locke & Latham-effektstørrelser.
10. CLAUDE.md «References (15)» → utsett til etter Fase 2 (Fase 2 kan avskrive filer og endre tallet). Sett her bare hvis Fase 2-beslutningen allerede er tatt; ellers er dette en Fase 2-leveranse.
11. Versjon: SKILL.md version → 1.3.1, sync plugin.json, release-tag + katalog-ref (release-plugin.mjs), push-vindu.

Voyage: /trekbrief (ramme sanering + DDT-beslutning + verifiseringsplikt) → /trekplan (fil-for-fil, hvert steg med On-failure/Checkpoint, circuit-breakers på #1/#5) → /trekexecute → /trekreview (bekreft 0 artefakter, 0 strippede tegn, én scoringsverdi, kanonisk kilde intakt).

---

4. Fase 1 — Domenedybde og kildeintegritet

Avhenger av: Fase 0. Serialisér FØR Fase 2 (deler møter.md + møtefasilitator-agent.md — kan ikke kjøre parallelt). Estimat: 2-3 sesjoner. Versjon ved slutt: 1.4.0 (sammen med Fase 2).

Leveranser:

1. Tertial-korreksjon. Presiser: formelt regime har 2 interim-punkter (30. april / 31. august) + årsrapport; DFØ vektlegger nå halvårs-/årsrapportmøte. 4-mnd OKR-syklus = pragmatisk valg som aligner med — ikke er identisk med — rapporteringsregimet. «Sjekk eget tildelingsbrev.» (dfo-okr-mapping.md:45, okr-framework.md:205).
2. OKR posisjonert som lag oppå mål- og resultatstyring (MRS, økonomireglementet §4) — ikke erstatning. Ny seksjon om tillitsreformen (sentral styringsspenning, i dag fraværende). «Målforskyvning» lagt til som førsteklasses norsk antipattern.
3. Metodikk-presisjoner. Doerrs advarsel mot å snitte committed+aspirational sammen (inn i aggregeringslogikk); Intel rettet (85% = gjenvunnet 16-bit-andel, ikke «fra 0%»; ~2300-2500 design wins oppnådd vs 2000 mål); Locke & Latham «250%» → «vanskeligste vs enkleste mål»; legg til Kleingeld-journalref (JAP 96(6):1289-1304).
4. «Kvartalsreview» → «Syklusreview» (møter.md:60, møtefasilitator-agent.md:39); «kvartalsvise» → «syklusvise» (okr-implementation.md:48/415).
5. Reelle norske offentlig-sektor-referanser (Digdir produktorganisering, NRK/Ruter som faktisk offentlige, Knowit «fire fallgruver») med tydelig vendor-/praktiker- vs uavhengig-merking.

Voyage: /trekresearch (Tavily/WebFetch triangulerer DFØ-currency, tillitsreform, reelle caser mot primærkilder; confidence-rating) → /trekplan → /trekexecute → /trekreview.

---

5. Fase 2 — UX-koherens og kommando-/agent-modning

Avhenger av: Fase 0 (+ org-kontekst-sti-beslutning, se under). Serialisér ETTER Fase 1 (delt fil-eierskap). Estimat: 1-2 sesjoner. Versjon ved slutt: 1.4.0.

Forhåndsbeslutning (kritisk avhengighet): Bestem kanonisk org-kontekst-sti FØR denne fasen — ~/.claude/okr/org/ (reinstall-overlevende, Fase 3-mål) vs prosjektlokal. Agentene wires til å lese fra endelig sti her, slik at Fase 3 ikke må gjøre om arbeidet.

Leveranser:

1. Kontekstbevissthet-blokk i møter.md (syklusfase-deteksjon + OKR-antall) — på linje med de 8 andre.
2. gap vs governance disambiguert. «Bruk /okr:gap når … (kvantitativ dekningsmatrise)» vs «Bruk /okr:governance når … (kvalitativ oversettelse + compliance)». Avdupliser den identiske innholdstabellen.
3. Negative triggere per agent (særlig styringsrådgiver vs gapanalytiker, begge på «tildelingsbrev»); fremdriftssporer instruert til å lese full antipatterns-fil; alle Task-spawnbare agenter leser org-kontekst direkte fra fil (endelig sti).
4. 6 usiterte referansefiler (dfo-okr-mapping, individual-vs-team-okr, metrics-library, okr-cheatsheet, okr-integrations, okr-sources) — wire inn i relevant kommando/agent eller eksplisitt avskriv. Deretter rett CLAUDE.md referanse-tall til post-avskriv-tallet.
5. Template-YAML ↔ onboarding-skjema-sync (okr.local.md.template); paritetstest manuell bootstrap vs hook-forventet skjema.

Filer eid av Fase 2 (ikke Fase 1): møter.md (Kontekstbevissthet), agentfilene (negative triggere). Fase 1s møter.md-rename (Kvartalsreview) gjøres FØR Fase 2 starter.

Voyage: /trekbrief (avgrens UX-scope + org-sti-beslutning) → /trekplan (Verifisering: grep bekrefter Kontekstbevissthet i alle 10 kommandoer; manuell rm-validering allerede gjort i Fase 0) → /trekexecute.

---

6. Fase 3 — Referansegrad-løft mot ms-ai-architect-paritet

Avhenger av: Fase 1 + Fase 2. Estimat: 2-3 sesjoner (flersesjons). Versjon ved slutt: 1.5.0 (nye kommandoer = minor).

Leveranser (prioritert etter adopsjonsverdi):

1. [MUST] Reinstall-overlevende ~/.claude/okr/org/. Implementer flytting + bakoverkompatibel fallback (les ny sti, fall tilbake til prosjektlokal). Oppdater CLAUDE.md «State Management» + okr.local.md.template i samme endring. On-failure: agenter faller tilbake til hook-injeksjon, ikke error. (Sti-beslutningen ble tatt i Fase 2; her implementeres migrasjonen.)
2. [MUST] /okr:help — alle 10 kommandoer + 7 agenter + anbefalt tidlig/midt/sen-syklus-arbeidsflyt.
3. [SHOULD] Ankrede scoringsrubrikker (okr-quality-rubrics.md, 5 ankere/dimensjon) som kvalitetssjekker laster → determinisme i governance-kontekst.
4. [SHOULD] Test-fixtures + node --test smoke-test for de to hookene (fanger skjema-drift).
5. [SHOULD] /okr:export (PDF) for kvalitetsvurderinger, gap-matriser, statusrapporter, retrospektiver — deling med ledelse/tillitsvalgte/Riksrevisjon.
6. [SHOULD] UserPromptSubmit emne-guard — injiser ikke OKR-kontekst på hver prompt uten relevans.
7. [SHOULD] Bredere offentlig-metrikkbibliotek (eForvaltningsindeks, WCAG/universell utforming, klagebehandlingsfrist, eFormidling) + minst én reell etat/kommune-differensiering (statlig vs kommunalt styringsregime).
8. [NICE] /okr:freshen-references — WebSearch/Tavily-subagenter mot dfo.no/regjeringen.no/riksrevisjonen.no for KB-currency.

Voyage: flersesjons /trekplan med .session-state; /trekexecute + /trekcontinue mellom sesjoner; /trekresearch for metrikkbiblioteket; avslutt med /trekreview mot brief-kriteriene for å bekrefte referansegrad.

---

7. Tverrgående krav

Krav	Detalj
Versjon per fase	Fase 0 → 1.3.1 (patch) · Fase 1+2 → 1.4.0 (minor) · Fase 3 → 1.5.0 (minor, nye kommandoer). Tag + katalog-ref (release-plugin.mjs) som avsluttende leveranse i HVER fase, i push-vinduet.
Rollback	Hvis en publisert tag senere må korrigeres fordi en senere fase endret kanonisk innhold tag-en averterte: dokumentér og lag patch-tag.
Fil-eierskap	møter.md + møtefasilitator-agent.md deles av Fase 1 (rename) og Fase 2 (Kontekstbevissthet/triggere) → serialisér Fase 1 før Fase 2. Ingen fil redigeres av to parallelle løp.
On-failure/Checkpoint	Hvert /trekplan-steg bærer begge. Destruktive steg (UTF-8-omskriving, DDT, rm -rf) = circuit-breaker (halt hele fasen ved feil).
Gemini-triangulering	Gemini-bridge var nede (deprecated Interactions API SDK). Oppgradér gemini-mcp-SDK før neste runde som trenger uavhengig triangulering.
STATE.md	Local-only (offentlig remote). Oppdatér ved hver sesjonslutt.

---

8. Sporbarhet: funn → fase

#	Funn (alvorlighet)	Fase
1	Scoringsterskel selvmotsigende ≥5 filer (KRITISK)	Fase 0
2	Fiktiv etat DDT presentert som fakta + fabrikkert Oboard-kilde (KRITISK)	Beslutningsport + Fase 0 (el. Fase 0b)
3	Total UTF-8-korrupsjon i 2 filer + hook (KRITISK/HØY)	Fase 0
4	Find-replace-artefakter i kopierte eksempler (HØY)	Fase 0
5	Læring-regex feiler på «Læring» (HØY)	Fase 0
6	CONTRIBUTING↔GOVERNANCE-motsigelse (HØY)	Fase 0
7	SECURITY peker GitHub på Forgejo-repo (HØY)	Fase 0
8	OKR-01 rm -rf ugardert (MEDIUM, men høyest data-tap-risiko)	Fase 0 (flyttet fra Fase 2)
9	ASCII-kommandonavn i README/oppsett/hook (MEDIUM)	Fase 0
10	Døde lenker + feil dokumenttittel (MEDIUM)	Fase 0
11	Uciterte statistikker som fakta (MEDIUM)	Fase 0
12	Intel/Locke faktarammings-feil (INFO/MEDIUM)	Fase 1
13	Committed+aspirational snittes sammen (MEDIUM)	Fase 1
14	Tertial overdrevet som DFØ-standard (MEDIUM)	Fase 1
15	Tillitsreform + målforskyvning fraværende (REFERANSEGRAD-GAP)	Fase 1
16	«Kvartalsreview» i 4-mnd-plugin (MEDIUM)	Fase 1
17	møter.md mangler Kontekstbevissthet (LAV)	Fase 2
18	gap vs governance overlapp (MEDIUM)	Fase 2
19	Agenter mangler negative triggere (MEDIUM)	Fase 2
20	Agenter blinde ved Task-spawn (MEDIUM)	Fase 2
21	6 usiterte referansefiler (SHOULD) + CLAUDE.md-tall	Fase 2
22	Template ≠ onboarding-YAML (MEDIUM)	Fase 2
23	Ikke reinstall-overlevende org-kontekst (REFERANSEGRAD-GAP/MUST)	Fase 2 (beslutning) + Fase 3 (impl.)
24	Mangler /okr:help, rubrikker, fixtures, PDF-eksport (SHOULD)	Fase 3
25	UserPromptSubmit uten emne-guard (SHOULD)	Fase 3
26	Tynt offentlig-metrikkbibliotek (SHOULD)	Fase 3
27	SKILL-versjon 1.0.0 vs 1.3.0 (MUST)	Fase 0 (del av versjonsbump)

Vurdert og forkastet: Share-session-as-artifacts (claude.ai-hostet, Team/Enterprise-gated, dataresidens/Schrems II for offentlig sektor) — operatørbeslutning 2026-06-23, tas ikke inn.