okr/commands/freshen-references.md
Kjell Tore Guttormsen 6b61d63196 fix(okr): fase D patch-lane D1-D3 (vakter som ikke voktet)
Tre C7-review-funn der vakten var groenn fordi den ikke KUNNE se defekten sin.
Alle tre TDD: vakten skrevet om foerst, mutasjons-verifisert roed mot ekte
filer, deretter kilden rettet. Suite 179 -> 182.

D1 (607313e3) tests/canon-consistency.test.mjs case (b) -- F-d-kadensvakten
kunne ikke feile paa den KANONISKE kadens-tabellen. teamMonthly bandt kadens-
adjektivet direkte til check-in med \s+, men etter "Maanedlig" kommer "**" og
en cellevegg, aldri whitespace; ledWeekly krevde /review/, mens den kanoniske
raden sier "statusgjennomgang". Vakten var altsaa blind paa nettopp det
artefaktet F-d produserer. Erstattet av to former med ulik struktur: prosa
(kadens + binding i SAMME klausul -- setning/komma/celle/" og ") og kadens-rad
(kadens-adjektivet alene i foerste celle, binding paa tvers av celleveggene).
Klausul-splittingen er det som skiller korrekt dobbeltrytme ("Ukentlig 15-min
check-in + maanedlig 30-min review", okr-implementation.md:181) fra motsigelse.
To nye fixture-caser holder hverandre i sjakk: (b2) de fire muterte kanoniske
linjene MAA flagges, (b3) ti legitime former MAA ikke.

D2 (7579d59c) case (g) -- agent.includes(d) er substring-containment, saa
rubrikk-dimensjonen "Outcome" var subsumert av "Outcome-fokus" og kunne
slettes uten at vakten falt. Ni av ti dims var ekte dekket; den tiende var
utestbar. Matcher naa token-grenser (uthevede listeledd + overskrifter).
Ny fixture (g2) pinner skillet.

D3 (029ef814) case (i) + commands/freshen-references.md:24 -- vakten
ekskluderte to filer permanent under en kommentar som kalte dem
"allerede-fiksede". freshen-references.md var aldri fikset; den falt utenfor
review-lista paa ni, og bar fortsatt "OKR-kontekst injiseres automatisk via
hook" -- en eksakt match for vaktens egen frase. Begge ekskluderinger fjernet
(analyse.md-ekskluderingen var dead code: fila matcher ingenting), kontekst-
blokken skrevet om til analyse.md-moensteret (oppdag fra disk via Glob).

Mutasjons-verifisering (alle fem forble groenne FOER, roede ETTER):
  okr-framework.md:54 -> team maanedlig check-in        -> (b) RED
  okr-framework.md:55 -> ledelse ukentlig               -> (b) RED
  okr-framework.md:58 -> prosa "holdes maanedlig"       -> (b) RED
  okr-framework.md:59 -> prosa "holdes ukentlig"        -> (b) RED
  kvalitetssjekker-agent.md:48 slettet (Outcome)        -> (g) RED

Artefakt: .claude/projects/2026-07-23-en-kanon-metodekonsolidering/review.md
2026-07-25 20:36:01 +02:00

7.9 KiB
Raw Blame History

name description allowed-tools argument-hint
okr:freshen-references KB-selvevaluator og currency-polling — scorer de 16 domene-referansefilene mot en ankret kvalitetsrubrikk og oppdager utdaterte kilder Read, Glob, WebSearch, Task [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

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 16 filer.

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 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 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)