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

153 lines
5.3 KiB
Markdown

---
name: okr:gap
description: Automatisk gap-analyse mellom tildelingsbrev og gjeldende OKR
allowed-tools: Read, AskUserQuestion, Task
argument-hint: "[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`