diff --git a/commands/freshen-references.md b/commands/freshen-references.md new file mode 100644 index 0000000..dfa78e3 --- /dev/null +++ b/commands/freshen-references.md @@ -0,0 +1,166 @@ +--- +name: okr:freshen-references +description: KB-selvevaluator og currency-polling — scorer de 16 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 16 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 + +OKR-kontekst injiseres automatisk via hook. Før du starter: +- Hvis brukeren oppgir en spesifikk referansefil som argument: scor kun den. +- Ellers: kjør full gjennomgang av alle 16 filer. +- Bruk `Glob` på `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/*.md` + for å bekrefte at fil-listen under fortsatt stemmer før scoring. + +## Arbeidsflyt + +### Del A — KB-selvevaluator + +**Filer som scores (16 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-oboard-guide.md` +15. `okr-offentlig-governance.md` +16. `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 dokumentert i +`${CLAUDE_PLUGIN_ROOT}/.claude/projects/2026-06-24-fase3-referansegrad-loft/research/01-norsk-offentlig-metrikker.md` +(lokal research). 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 16 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)