okr/commands/sporing.md

136 lines
5.3 KiB
Markdown

---
name: okr:sporing
description: Spor OKR-fremgang, beregn score og generer check-in rapporter
allowed-tools: Read, AskUserQuestion, Task, ToolSearch, Glob
argument-hint: "[OKR eller tall for oppdatering]"
---
# OKR Sporing - Fremgang og scoring
Hjelp brukeren med å spore OKR-fremgang, beregne score og strukturere check-ins.
## Kontekstbevissthet
Hooken for-injiserer ikke lenger en fil-liste — den emitterer kun kjerne-profil
+ en peker til wikien. Oppdag OKR-konteksten direkte fra disk FØR du spør brukeren:
- Glob `.claude/okr/syklus/*/` for de OKR-filene som skal spores — les dem direkte
i stedet for å be brukeren lime inn OKR-tekst.
- Glob `.claude/okr/syklus/*/status.md` for forrige statusrapport i samme syklus, så
fremgang måles mot sist rapporterte verdi og ikke mot baseline alene.
- Trenger du bredere kontekst fra brukerens wiki, invoker `okr-second-brain-search`.
- Kjenner du allerede organisasjon og syklus fra kjerne-profilen: hopp over de spørsmålene.
## Scoring-system
**Skala**: 0.0 - 1.0
| Score | Betydning | Typisk for |
|-------|-----------|------------|
| 1.0 | 100% oppnådd | Committed mål |
| ≈0.7 | Sweet spot — 0.7 = forventet for aspirational; 0.6-0.7 = sweet spot (Google/Doerr) | Aspirational mål |
| 0.5-0.7 | Delvis suksess | Trenger analyse |
| < 0.5 | Ikke oppnådd | Trenger intervensjon |
### Beregningsformel
```
Score = (Nåværende - Baseline) / (Target - Baseline)
```
## Arbeidsflyt
### Ved statusoppdatering
1. **Samle inn tall** — les OKR-filer fra `.claude/okr/syklus/[id]/` (hvis tilgjengelig
fra system-kontekst) eller be brukeren oppgi OKR. Spør med AskUserQuestion:
- Nåværende verdi for hver KR
- Baseline og target (hvis ikke kjent)
- Dato for måling
Er `/okr:rapport tertial` kjørt for syklusen, finnes tallene allerede i
`rapport-tertial.md` — les den i stedet for å spørre om dem på nytt.
Confidence-kolonnen der står tom med vilje: generatoren eier aritmetikken,
denne kommandoen eier vurderingen. Det er den kolonnen du fyller i steg 3.
2. **Beregn score** per KR, og oppsummer **per type** — aldri som ett felles tall.
Committed og aspirational måles mot hver sin målestokk, og et aggregat på tvers
av dem er tvetydig (`okr-framework.md`, committed/aspirational-skillet):
- **Committed:** hvor mange KR som har nådd kravet. Et committed KR er nådd
eller ikke; et snitt av binære krav er ikke en størrelse.
- **Aspirational:** snittet på tvers av aspirational-KR. Rundt 0.7 er forventet
måloppnåelse, ikke svikt.
3. **Vurder confidence** — sett nivået fra den **kanoniske confidence-tabellen i
`okr-framework.md`** (On Track 🟢 / At Risk 🟡 / Off Track 🔴, sannsynlighet for å
nå target). Innfør ingen egne nivåer eller terskler her. Trend er ett *innspill*
til vurderingen: peker den mot target, flater den ut, eller har fremgangen stoppet?
4. **Generer rapport** med anbefalte tiltak
### Ved ukentlig check-in
Generer en strukturert check-in:
1. Status på hver KR (traffic light)
2. Blokkere og støttebehov
3. Beslutninger som trengs
4. Fokus neste periode
## Eksempel på output
Når statusrapporten lagres som `.claude/okr/syklus/[id]/status.md` i second-brain-treet,
bær filen **OKF-frontmatter** (påkrevd `type: Status` + anbefalt `title`/`description`/
`timestamp`); rapportinnholdet under følger frontmatteren:
```markdown
---
type: Status
syklus: T1-2026
title: "Status T1-2026"
description: "Fremdrift og scoring uke 8 av 16"
timestamp: "[ISO-8601]"
---
## OKR Status - Uke 8 av 16
### Objective: Forbedre trafikksikkerhet i skolesoner
#### Committed Key Results
| KR | Baseline | Target | Nå | Score | Avvik | Confidence |
|----|----------|--------|-----|-------|-------|------------|
| KR1: Redusere ulykker | 40 | 30 | 35 | 0.50 | Ja | At Risk 🟡 |
| KR2: Fartshumper installert | 0 | 100 | 60 | 0.60 | Ja | On Track 🟢 |
**Committed: 0 av 2 KR har nådd kravet.** Et committed KR er nådd eller ikke;
avvikene over skal forklares, ikke rundes av til et snitt.
#### Aspirational Key Results
| KR | Baseline | Target | Nå | Score | Avvik | Confidence |
|----|----------|--------|-----|-------|-------|------------|
| KR3: Foreldre-tilfredshet | 60 | 90 | 75 | 0.50 | - | At Risk 🟡 |
**Snitt aspirational: 0.50** over 1 KR. Rundt 0.7 er forventet måloppnåelse for
aspirational — en lav score her er ikke et avvik og skal ikke rapporteres som ett.
**Confidence, committed:** At Risk 🟡 — KR1 trenger fokus, KR2 ligger foran plan.
**Confidence, aspirational:** At Risk 🟡 — KR3 flater ut.
**Anbefalte tiltak:**
1. Prioriter tiltak for KR1 (sikkerhet er kritisk)
2. Kjør brukerundersøkelse for KR3 før neste måned
```
## Linear-integrasjon
Hvis Linear er konfigurert (sjekk med ToolSearch):
1. Hent aktive OKR-issues
2. Oppdater status-felt
3. Legg til kommentar med score
## Referanser
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-calculator.md` — beregningsformler
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-framework.md` — scoring-metodikk
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/metrics-library.md` — metrikkbibliotek for offentlige KR
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-integrations.md` — Linear-/verktøyintegrasjon for statussporing