Kjell Tore Guttormsen
6b61d63196
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
168 lines
7.9 KiB
Markdown
168 lines
7.9 KiB
Markdown
---
|
||
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
|
||
|
||
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` på `${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)
|