ktg-plugin-marketplace/plugins/okr/commands/gap.md
Kjell Tore Guttormsen ac95cd6a30 feat(okr): sync to v1.3.0 from ktg-privat
Syncs all changes from v1.0.0 through v1.3.0:

v1.1 (quick fixes):
- Fix deprecated Viva Goals references
- Add DFO-OKR terminology mapping
- Add tillitsvalgt/fagforening perspective
- Update Objectives recommendation from 3-5 to 2-3

v1.1 (persistent context):
- Deep onboarding interview (full/mvp)
- Persistent .claude/okr/ directory tree
- Context-aware commands
- Cycle archival with retrospective

v1.3 (AI-first differentiators):
- /okr:gap — tildelingsbrev gap analysis with coverage matrix
- /okr:analyse — cross-cycle Mermaid analytics
- SessionStart coaching hook (proactive, phase-aware)
- gapanalytiker + trendanalytiker agents
- inject-okr-context.mjs extended for historikk/

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-08 20:31:49 +02:00

5.3 KiB

name description allowed-tools argument-hint
okr:gap Automatisk gap-analyse mellom tildelingsbrev og gjeldende OKR Read, AskUserQuestion, Task [tildelingsbrev-fil eller tomt for auto-deteksjon]

OKR Gap-analyse — Tildelingsbrev vs OKR

Analyser automatisk om gjeldende OKR dekker kravene i tildelingsbrevet, og om OKR har forankring i styrende dokumenter.

Kontekstbevissthet

OKR-kontekst injiseres automatisk via hook. Sjekk system-konteksten FØR du spør brukeren:

  • Hvis tildelingsbrev finnes i .claude/okr/strategisk-kontekst/tildelingsbrev-*.md (listet i system-kontekst): les den automatisk.
  • Hvis OKR finnes i .claude/okr/syklus/[id]/: les dem automatisk.
  • Hvis .claude/okr/strategisk-kontekst/overordnede-okr.md finnes: les den for org-nivå alignment.
  • Bruk aldri generisk rådgivning når spesifikke data er tilgjengelig.

Arbeidsflyt

1. Datainnsamling

Auto-les fra persistent context:

  1. Tildelingsbrev: .claude/okr/strategisk-kontekst/tildelingsbrev-*.md
    • Hvis flere tildelingsbrev finnes: spør brukeren hvilken å bruke
    • Hvis ingen finnes: be brukeren lime inn tekst eller lagre med /okr:oppsett full
  2. Gjeldende OKR: .claude/okr/syklus/[id]/okr-*.md
    • Hvis ingen finnes: informer og anbefal /okr:skriv
  3. Overordnede OKR: .claude/okr/strategisk-kontekst/overordnede-okr.md
    • Valgfritt — brukes for å vise org-nivå dekning

2. Tildelingsbrev-parsing

Les referansemateriale:

  • ${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-offentlig-governance.md

Ekstraher individuelle krav fra tildelingsbrevet. Kategoriser hvert krav:

Type innhold OKR-egnet Riktig håndtering
Driftskrav ("Oppretthold X") Lav KPI-dashboard
Resultatmål med tall Høy Key Result-kandidat
Strategiske satsinger Høy Objective-kandidat
Rapporteringskrav Lav Rapporteringsrutine
Særskilte oppdrag Medium Case by case

3. OKR-mapping (tildelingsbrev → OKR)

For hvert OKR-relevant krav i tildelingsbrevet:

  • Søk i gjeldende OKR etter dekning (nøkkelord, semantisk match, eksplisitt referanse)
  • Vurder om noen KR måler det kravet etterspør
  • Klassifiser:
Status Beskrivelse
Dekket OKR eller KR dekker kravet eksplisitt
Delvis dekket Relatert OKR finnes men dekker ikke kravet fullstendig
Udekket Ingen OKR adresserer dette kravet

4. Reverse-mapping (OKR → tildelingsbrev)

For hver gjeldende OKR:

  • Spor tilbake til tildelingsbrev-krav
  • Klassifiser:
Forankring Beskrivelse
Forankret Tydelig kobling til tildelingsbrev-krav
Indirekte forankret Relatert til overordnet strategi
Fristilt Ingen governance-forankring (OK for aspirational OKR)

5. Rapport-generering

Bruk følgende output-format.

Output-format

## Gap-analyse: Tildelingsbrev vs OKR

**Tildelingsbrev:** [filnavn eller kilde]
**OKR-kilde:** [syklusmappe eller manuelt oppgitt]
**Analysedato:** [dato]
**Org-OKR:** [ja/nei — om overordnede-okr.md ble brukt]

---

### Dekningsmatrise

| # | Tildelingsbrev-krav | Type | Dekket av | Status |
|---|---------------------|------|-----------|--------|
| 1 | [krav-tekst] | Resultatmål | O1/KR2 | dekket |
| 2 | [krav-tekst] | Strategisk satsing | O2 | delvis dekket |
| 3 | [krav-tekst] | Resultatmål | — | udekket |

### Udekte krav (gap)

For hvert udekket krav:
#### Krav [N]: [tittel]
**Sitat:** > "[fra tildelingsbrev]"
**Type:** [kategori]
**Anbefalt handling:**
- [Forslag til OKR-formulering som dekker kravet]
- [Alternativ: Følg opp som KPI hvis driftskrav]

### OKR uten tildelingsbrev-forankring

| OKR | Type | Forankring |
|-----|------|------------|
| O1: [tekst] | Committed | Forankret i krav 1, 4 |
| O3: [tekst] | Aspirational | Fristilt (OK for stretch) |

### Sammendrag

- **Tildelingsbrev-krav totalt:** [N]
- **OKR-relevante krav:** [N]
- **Dekket:** [N] ([%])
- **Delvis dekket:** [N] ([%])
- **Udekket:** [N] ([%]) — krever handling
- **OKR uten forankring:** [N] (OK hvis aspirational)

### Anbefalte neste steg

1. [Handling for å lukke viktigste gap]
2. [Bruk /okr:skriv for å lage OKR for udekte krav]
3. [Bruk /okr:kvalitet for å sjekke de nye OKR]

Håndtering av ufullstendig data

Situasjon Handling
Tildelingsbrev mangler "Ingen tildelingsbrev funnet i .claude/okr/strategisk-kontekst/. Lim inn tekst eller lagre tildelingsbrev med /okr:oppsett full (fase 3)."
OKR mangler "Ingen OKR funnet i gjeldende syklus. Bruk /okr:skriv for å opprette."
Begge mangler "Verken tildelingsbrev eller OKR funnet. Start med /okr:oppsett for å sette opp kontekst."
Kun tildelingsbrev Kjør tildelingsbrev-parsing og vis forslag til OKR.
Kun OKR Vis OKR-oversikt uten gap-analyse, oppfordre til å legge inn tildelingsbrev.

Delegering

Bruk Task for å sende analysen til gapanalytiker-agenten for detaljert analyse. Send med: tildelingsbrev-innhold, OKR-innhold, og overordnede-okr hvis tilgjengelig. Motta tilbake ferdig dekningsmatrise.

Referanser

  • ${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-offentlig-governance.md
  • ${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-arshjul.md