okr/commands/freshen-references.md
Kjell Tore Guttormsen 2149547c0c feat(okr): F-j -- kommunal styringslinje, styringssloeyfas ut-side, gevinstrealisering
Lukker det siste av de ti F-funnene fra review-2026-07-16.md §3. F-j ble
utsatt fra 1.8.0 via Non-Goal i C-fasens brief, mens SC-85 samtidig pastod
at alle ti var lukket. review.md abc1b4f6 fant at utsettelsen kun var
registrert i gitignorede STATE.md, saa diskrepansen stod uimotsagt i repoet.
Loest ved aa faktisk lukke funnet, og registrert i CHANGELOG.

Maalt foer arbeidet (ground truth, ikke gjenbrukt fra review):
  etatsstyringsmoete   0 treff
  kommunelov           1 treff (metrics-library.md:245)
  gevinstrealiser      1 treff (metrics-library.md:296)
  ut-siden            14 linjer, en 4-raders ASCII-tabell

NY FIL skills/okr-offentlig-sektor/references/okr-kommunal-styring.md
Kommunal styring er en PARALLELL linje, ikke en variant av statlig -- egen
fil speiler det. Selvstyre uten tildelingsbrev (koml §§2-1/2-2), oekonomiplan
og kommuneplanens handlingsdel (§§14-1..14-4, jf. pbl §11-1 fjerde ledd),
kommunedirektoerens utrednings- og iverksettingsansvar (§13-1), og koblingen
4-aarig plan <-> 4-maaneders OKR. Fylkeskommunen dekket eksplisitt.

UTVIDET okr-offentlig-governance.md
Ut-siden: styringsdialogen, etatsstyringsmoetet som sentralt moetepunkt,
aarsrapportens seks faste deler med del III som anker for maaloppnaaelse og
del IV som stedet OKR-prosessen selv dokumenteres, + tre regler for aa
rapportere aspirational oppover uten at 0.7 leses som svikt.
Gevinstrealisering: eget kapittel, DFOe-metodikk mappet mot OKR, med
gevinstansvarlig som LINJErolle (= KR-eier som faktisk raar over utfallet).
Guiden merket eksplisitt som statlig, med peker til den kommunale fila.

VERIFISERING (verifiseringsplikten -- ingen maskin validerer fagprosa)
Hver domenepaastand sjekket mot offisiell kilde foer den ble skrevet:
kommuneloven kap. 14 (Lovdata), pbl §11-1 (Lovdata), aarsrapportens seks
deler (DFOes veiledningsnotat), 15. mars-fristen (Bestemmelser om
oekonomistyring i staten), etatsstyringsmoetet (DFOe hovedinstruks del D),
gevinstrealisering (DFOes veileder + Digdirs Prosjektveiviseren). Alle
lenket i fillenes kildeseksjoner.

En paastand ble FJERNET som uverifiserbar: «typisk 2-4 etatsstyringsmoeter
i aaret». DFOes hovedinstruks sier bare at antallet KAN fastsettes i
departementets hovedinstruks -- erstattet med det.

Tellinger bumpet paa alle flater som baerer dem: 17 -> 18 referansefiler
(CLAUDE.md, README.md) og 16 -> 17 scorede filer (freshen-references.md,
inkl. den nummererte lista). Verifisert mot disk: ls | wc -l = 18.

Suite 192/192 groenn. canon-consistency + reference-integrity gjoer at den
nye fila ikke redefinerer kanon (kadens/confidence/scoreband) og at alle
krysslenker resolverer paa disk.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016BDwL2pweAjLaHYZFjgYUa
2026-07-31 17:38:41 +02:00

169 lines
7.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
name: okr:freshen-references
description: KB-selvevaluator og currency-polling — scorer de 17 domene-referansefilene mot en ankret kvalitetsrubrikk og oppdager utdaterte kilder
allowed-tools: Read, Glob, WebSearch, Task
argument-hint: "[referansefil å fokusere på, eller tom for full gjennomgang]"
---
# OKR Freshen References - KB-selvevaluator + currency-polling
Vedlikehold kunnskapsbasen (KB) bak OKR-pluginet. Kommandoen gjør to ting:
1. **KB-selvevaluator** — scorer hver av de 17 domene-referansefilene mot en
ankret kvalitetsrubrikk (dekning + kvalitet), slik at svake filer kan
prioriteres for forbedring.
2. **Currency-polling** — sjekker navngitte offentlige kilder for å oppdage om
`Sist oppdatert`-markører i KB-en har blitt utdaterte siden sist.
Dette speiler KB-selvevaluatoren i ms-ai-architect (ankret rubrikk, dekning- og
kvalitetsdimensjoner med fem ankere hver), tilpasset OKR-domenet for norsk
offentlig sektor.
## Kontekstbevissthet
Oppdag referansefilene direkte fra disk (hooken for-injiserer ikke lenger en fil-liste
— den emitterer kun et kjerne-sammendrag + en peker til wikien):
- Bruk `Glob``${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/*.md`
for å bekrefte at fil-listen under fortsatt stemmer før scoring.
- Hvis brukeren oppgir en spesifikk referansefil som argument: scor kun den.
- Ellers: kjør full gjennomgang av alle 17 filer.
## Arbeidsflyt
### Del A — KB-selvevaluator
**Filer som scores (17 domene-referansefiler):**
1. `cfr-framework.md`
2. `dfo-okr-mapping.md`
3. `individual-vs-team-okr.md`
4. `meeting-guides.md`
5. `metrics-library.md`
6. `okr-antipatterns.md`
7. `okr-arshjul.md`
8. `okr-calculator.md`
9. `okr-cheatsheet.md`
10. `okr-examples.md`
11. `okr-framework.md`
12. `okr-implementation.md`
13. `okr-integrations.md`
14. `okr-kommunal-styring.md`
15. `okr-oboard-guide.md`
16. `okr-offentlig-governance.md`
17. `okr-sources.md`
**Eksplisitt ekskludert:** `okr-quality-rubrics.md` scores IKKE av denne
evaluatoren. Den er selv scoringsinstrumentet for `/okr:kvalitet`; en
KB-evaluator som scorer sin egen rubrikk blir sirkulær.
**Slik scorer du:** les hver fil, finn ankeret den faktisk treffer per
dimensjon, og gi 1-5. Rapporter en tabell (fil × dimensjon) + en prioritert
liste over filer som scorer ≤ 2 på en eller flere dimensjoner.
#### KB-kvalitetsrubrikk
**Dekning** — måler om filen dekker domenet sitt fullstendig.
##### Fullstendighet
Måler om filen dekker hele sitt erklærte domene uten åpenbare hull.
1. **Anker 1 (svakest)** — Fragmentarisk; dekker bare en liten del av domenet filen lover.
2. **Anker 2** — Vesentlige hull; flere sentrale undertemaer mangler.
3. **Anker 3** — Dekker kjernen, men med merkbare hull i randsoner.
4. **Anker 4** — Nær fullstendig; kun mindre kanttilfeller utelatt.
5. **Anker 5 (sterkest)** — Fullstendig dekning av domenet med kanttilfeller adressert.
##### Offentlig-sektor-tilpasning
Måler om innholdet er tilpasset norsk offentlig kontekst (ikke generisk privat-sektor-OKR).
1. **Anker 1 (svakest)** — Rent generisk; ingen tilpasning til offentlig sektor.
2. **Anker 2** — Overflatisk tilpasning; norske termer limt på generisk innhold.
3. **Anker 3** — Delvis tilpasset; noen offentlig-spesifikke eksempler.
4. **Anker 4** — Godt tilpasset; tertialsyklus, tildelingsbrev og etatskontekst gjennomgående.
5. **Anker 5 (sterkest)** — Fullt forankret i norsk offentlig praksis med konkrete, etterprøvbare eksempler.
##### Eksempeldekning
Måler om filen gir konkrete eksempler, ikke bare abstrakte prinsipper.
1. **Anker 1 (svakest)** — Ingen eksempler; ren teori.
2. **Anker 2** — Ett eller to tynne eksempler.
3. **Anker 3** — Noen eksempler, men ujevnt fordelt.
4. **Anker 4** — Gode eksempler på de fleste sentrale punkter.
5. **Anker 5 (sterkest)** — Rike, varierte gode-vs-dårlige eksempler gjennomgående.
##### Kryssreferanser
Måler om filen kobler til relevante søsken-referanser og kommandoer.
1. **Anker 1 (svakest)** — Isolert; ingen kobling til resten av KB-en.
2. **Anker 2** — Én løs henvisning.
3. **Anker 3** — Noen kryssreferanser, men ufullstendige.
4. **Anker 4** — Godt koblet til relaterte filer og kommandoer.
5. **Anker 5 (sterkest)** — Fullt integrert; peker presist til alle relevante naboer.
**Kvalitet** — måler hvor pålitelig og brukbart innholdet er.
##### Presisjon
Måler om påstandene er presise og entydige.
1. **Anker 1 (svakest)** — Vagt og flertydig; vanskelig å handle på.
2. **Anker 2** — Flere upresise eller løse formuleringer.
3. **Anker 3** — Stort sett presist, med noen vage partier.
4. **Anker 4** — Presist; kun ubetydelige uklarheter.
5. **Anker 5 (sterkest)** — Skarpt og entydig hele veien; ingen tolkningsrom.
##### Provenans
Måler om faktapåstander er kildebelagt (jf. verifiseringsplikt).
1. **Anker 1 (svakest)** — Ingen kilder; påstander hviler på antakelse.
2. **Anker 2** — Få kilder; det meste ubelagt.
3. **Anker 3** — Sentrale påstander belagt, men hull gjenstår.
4. **Anker 4** — Godt kildebelagt; uverifisert merket som «Ikke verifisert».
5. **Anker 5 (sterkest)** — Hver faktapåstand provenans-tagget til primærkilde.
##### Aktualitet
Måler om innholdet er oppdatert mot gjeldende rammeverk, lover og tall.
1. **Anker 1 (svakest)** — Utdatert; refererer opphevde lover eller døde rammeverk.
2. **Anker 2** — Flere foreldede referanser.
3. **Anker 3** — Stort sett aktuelt, men enkelte utdaterte tall.
4. **Anker 4** — Aktuelt; `Sist oppdatert`-markør innenfor siste år.
5. **Anker 5 (sterkest)** — Fullt aktuelt mot nyeste rammeverk og gjeldende rett.
##### Handlingsbarhet
Måler om leseren kan handle på innholdet uten ekstra oppslag.
1. **Anker 1 (svakest)** — Ren bakgrunn; gir ingen handlingsretning.
2. **Anker 2** — Antyder handling, men for abstrakt til å følge.
3. **Anker 3** — Handlingsbart for den erfarne, men krever tolkning.
4. **Anker 4** — Klar handlingsretning på de fleste punkter.
5. **Anker 5 (sterkest)** — Umiddelbart handlingsbart; konkrete steg og maler.
### Del B — Currency-polling
Volatile offentlige kilder endrer seg uavhengig av KB-en. Bruk en
`WebSearch`/Tavily-subagent (via `Task`) til å sjekke om `Sist oppdatert`-
markørene i KB-en (særlig i `metrics-library.md` og `okr-offentlig-governance.md`)
har blitt utdaterte. Poll disse navngitte kildene:
- **UN E-Government Survey (EGDI)** — ny utgave annethvert år; sjekk siste indeksår.
- **EU eGovernment Benchmark** — årlig rapport; sjekk gjeldende årgang.
- **OECD Digital Government Index (DGI)** — periodisk; sjekk siste publisering.
- **Digdir «Rikets digitale tilstand»** — årlig; sjekk siste utgave.
- **WCAG** — sjekk om gjeldende referansenivå (2.1 A+AA) fortsatt er det som
henvises i offentlig regelverk, og status for EAA-ikrafttredelse i Norge.
- **Forvaltningsloven** — sjekk om den nye forvaltningsloven (vedtatt 2025) har
trådt i kraft og erstattet 1967-loven KB-en refererer.
- **eFormidling** — sjekk om status fortsatt er «bør» (ikke påbudt) for statlige virksomheter.
Kildegrunnlaget for de volatile markørene er oppsummert i
`${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/metrics-library.md`
(seksjonen «Review-kadens»; full provenans i lokalt research-arkiv, ikke
distribuert med pluginen). Rapporter hvilke `Sist oppdatert`-markører som bør
bumpes, og hvilke faktapåstander som må re-verifiseres.
## Referanser
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/` — de 17 domenefilene som scores
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-quality-rubrics.md` — OKR-scoringsrubrikk (ekskludert fra KB-scoring; ankerstilen gjenbrukt her)
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-sources.md` — primærkilde-register (provenans-stil)
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/metrics-library.md` — bærer volatile offentlig-metrikker (hovedmål for currency-polling)