feat(okr): /okr:help kommando-/agentoversikt + syklusarbeidsflyt (SC2)
This commit is contained in:
parent
4488a84e3a
commit
88eaca81e0
5 changed files with 106 additions and 4 deletions
|
|
@ -16,6 +16,9 @@ Expert OKR guidance for Norwegian public sector. Google/Doerr methodology adapte
|
|||
| `/okr:gap` | Automatic gap analysis between tildelingsbrev and current OKR |
|
||||
| `/okr:analyse` | Cross-cycle analytics with Mermaid trend visualizations |
|
||||
| `/okr:oppsett` | Configure plugin: onboarding interview (full/mvp), cycle archival, profile update. Args: `full\|mvp\|arkiver\|oppdater\|vis` |
|
||||
| `/okr:export` | Export OKR deliverables (quality review, gap matrix, status report, retrospective) to print-ready PDF via weasyprint |
|
||||
| `/okr:freshen-references` | KB self-evaluator: score the 16 reference files against an anchored rubric + currency-poll public sources |
|
||||
| `/okr:help` | Full overview of all commands, agents, and recommended cycle workflow |
|
||||
|
||||
## Agents
|
||||
|
||||
|
|
@ -42,7 +45,7 @@ Expert OKR guidance for Norwegian public sector. Google/Doerr methodology adapte
|
|||
| Component | Location |
|
||||
|-----------|----------|
|
||||
| SKILL.md | `skills/okr-offentlig-sektor/SKILL.md` |
|
||||
| References (16) | `skills/okr-offentlig-sektor/references/` |
|
||||
| References (17) | `skills/okr-offentlig-sektor/references/` |
|
||||
|
||||
## State Management
|
||||
|
||||
|
|
@ -73,5 +76,8 @@ Cycle archival: `/okr:oppsett arkiver` — moves `syklus/` to `historikk/`, gene
|
|||
/okr:analyse ──→ trendanalytiker
|
||||
/okr:oppsett ──→ (inline wizard: full/mvp/arkiver/oppdater/vis)
|
||||
/okr:oppsett arkiver ──→ cycle archival + retrospektiv-generering
|
||||
/okr:export ──→ scripts/export-pdf.py (weasyprint, documented prerequisite)
|
||||
/okr:freshen-references ──→ (inline KB-evaluator + currency-polling via WebSearch/Task)
|
||||
/okr:help ──→ (inline command/agent/workflow overview)
|
||||
SessionStart ──→ coaching-hook.mjs (proactive coaching)
|
||||
```
|
||||
|
|
|
|||
23
README.md
23
README.md
|
|
@ -9,9 +9,9 @@
|
|||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
|
@ -124,6 +124,23 @@ Planning to introduce OKR in your organization? Get a phased rollout plan with r
|
|||
|
||||
Translate tildelingsbrev requirements into OKR. Map the governance chain (Stortingsmelding → tildelingsbrev → etatsstrategi → OKR). Verify that your OKR documentation meets Riksrevisjon standards.
|
||||
|
||||
### Export Deliverables
|
||||
|
||||
```
|
||||
> /okr:export
|
||||
```
|
||||
|
||||
Renders any OKR deliverable — quality review, gap matrix, status report, or retrospective — to a print-ready A4 PDF for management or Riksrevisjon. Tables get striping and score cells are color-coded (green/yellow/red). PDF generation is a documented prerequisite (`pip install markdown weasyprint`, `brew install pango`), not bundled — a missing dependency exits with a clear install hint, never a traceback.
|
||||
|
||||
### Help and Maintenance
|
||||
|
||||
```
|
||||
> /okr:help
|
||||
> /okr:freshen-references
|
||||
```
|
||||
|
||||
`/okr:help` lists all 13 commands, 7 agents, and a recommended workflow keyed to where you are in the tertial cycle. `/okr:freshen-references` is a knowledge-base self-evaluator: it scores the 16 domain reference files against an anchored quality rubric and polls named public sources (UN EGDI, EU eGov Benchmark, OECD DGI, Digdir, WCAG, forvaltningsloven) to flag outdated `Sist oppdatert` markers.
|
||||
|
||||
---
|
||||
|
||||
## Getting Started
|
||||
|
|
@ -237,7 +254,7 @@ The plugin understands this hierarchy and helps you maintain alignment at every
|
|||
|
||||
### Knowledge Base
|
||||
|
||||
16 reference files covering OKR methodology, Norwegian public sector governance, antipatterns, meeting guides, metrics library, integration patterns, and more. The plugin reads only what's relevant to each interaction — never the whole library at once.
|
||||
17 reference files covering OKR methodology, Norwegian public sector governance, antipatterns, meeting guides, metrics library, anchored quality rubrics, integration patterns, and more. The plugin reads only what's relevant to each interaction — never the whole library at once.
|
||||
|
||||
### Persistent Context
|
||||
|
||||
|
|
|
|||
77
commands/help.md
Normal file
77
commands/help.md
Normal file
|
|
@ -0,0 +1,77 @@
|
|||
---
|
||||
name: okr:help
|
||||
description: Full oversikt over alle OKR-kommandoer, agenter og anbefalt arbeidsflyt gjennom tertialsyklusen
|
||||
allowed-tools: Read
|
||||
argument-hint: "[tema å få hjelp med, eller tom for full oversikt]"
|
||||
---
|
||||
|
||||
# OKR Help - Kommando- og agentoversikt
|
||||
|
||||
Gi brukeren en oversikt over hva pluginet kan, og hvilken kommando som passer
|
||||
til hva. Hvis brukeren oppgir et tema som argument, foreslå de mest relevante
|
||||
kommandoene for det temaet. Ellers vis full oversikt.
|
||||
|
||||
## Kommandoer (13)
|
||||
|
||||
| Kommando | Hva den gjør |
|
||||
|----------|--------------|
|
||||
| `/okr:skriv` | Skriv ny OKR med veiledet Objective- og KR-utforming |
|
||||
| `/okr:kvalitet` | Kvalitetssjekk OKR mot ankret rubrikk og 19 antipatterns |
|
||||
| `/okr:kaskade` | Kaskader OKR fra org til team, visualiser alignment |
|
||||
| `/okr:sporing` | Spor fremdrift, beregn score (0.0–1.0), generer check-ins |
|
||||
| `/okr:møter` | Planlegg OKR-workshops, check-ins, reviews og 1:1 (CFR) |
|
||||
| `/okr:innføring` | Innføringsplan, motstandshåndtering, modenhetsvurdering |
|
||||
| `/okr:governance` | Tildelingsbrev-oversettelse, Riksrevisjon-compliance |
|
||||
| `/okr:gap` | Automatisk gap-analyse mellom tildelingsbrev og gjeldende OKR |
|
||||
| `/okr:analyse` | Kryss-syklus-analyse med Mermaid-trendvisualisering |
|
||||
| `/okr:oppsett` | Konfigurer plugin: onboarding (`full`/`mvp`), `arkiver`, `oppdater`, `vis` |
|
||||
| `/okr:export` | Eksporter OKR-dokumenter til print-klar PDF (ledelse/Riksrevisjon) |
|
||||
| `/okr:freshen-references` | KB-selvevaluator + currency-polling av offentlige kilder |
|
||||
| `/okr:help` | Denne oversikten — kommandoer, agenter, anbefalt arbeidsflyt |
|
||||
|
||||
## Agenter (7)
|
||||
|
||||
Agentene aktiveres automatisk av kommandoene over; du kaller dem ikke direkte.
|
||||
|
||||
| Agent | Rolle |
|
||||
|-------|-------|
|
||||
| kvalitetssjekker | Score kvalitet, oppdage antipatterns, sjekke alignment |
|
||||
| kaskadebygger | Bygge OKR-kaskader mellom organisasjonsnivåer |
|
||||
| fremdriftssporer | Beregne score, lage prognoser, flagge risiko-KR |
|
||||
| møtefasilitator | Generere møteagendaer og fasiliteringsmateriell |
|
||||
| styringsrådgiver | Governance-analyse, tildelingsbrev-oversettelse, audit-compliance |
|
||||
| gapanalytiker | Dekningsmatrise mellom strategidokumenter og OKR |
|
||||
| trendanalytiker | Kryss-syklus mønsteranalyse med trendvisualisering |
|
||||
|
||||
## Anbefalt arbeidsflyt
|
||||
|
||||
OKR-arbeid følger tertialsyklusen (16 uker). Velg kommando etter hvor i syklusen
|
||||
du er — coaching-hooken minner deg på dette ved sesjonsstart.
|
||||
|
||||
### Tidlig i syklus (uke 1–5) — sett retning
|
||||
1. `/okr:oppsett full` (én gang) — la pluginet lære organisasjonen din
|
||||
2. `/okr:governance` / `/okr:gap` — forankre i tildelingsbrev, finn dekningshull
|
||||
3. `/okr:skriv` — skriv Objectives og Key Results
|
||||
4. `/okr:kvalitet` — kvalitetssjekk og forbedre
|
||||
5. `/okr:kaskade` — juster mot org-OKR
|
||||
|
||||
### Midt i syklus (uke 6–11) — hold tempo
|
||||
6. `/okr:sporing` — oppdater fremdrift, fang risiko tidlig
|
||||
7. `/okr:møter` — forbered check-in og 1:1 (CFR)
|
||||
|
||||
### Sent i syklus (uke 12–16) — lukk og lær
|
||||
8. `/okr:sporing` — endelig scoring
|
||||
9. `/okr:export` — eksporter status/retrospektiv til PDF for ledelse/Riksrevisjon
|
||||
10. `/okr:oppsett arkiver` — arkiver syklus, generer retrospektiv
|
||||
11. `/okr:analyse` — se trender på tvers av sykluser
|
||||
12. `/okr:skriv` — start neste syklus med lærdommene
|
||||
|
||||
### Løpende vedlikehold
|
||||
- `/okr:help` — denne oversikten når du er usikker på hvilken kommando du trenger
|
||||
- `/okr:freshen-references` — hold kunnskapsbasen aktuell (KB-scoring + kilde-polling)
|
||||
|
||||
## Referanser
|
||||
|
||||
- `${CLAUDE_PLUGIN_ROOT}/README.md` — fyldig introduksjon og bruksområder
|
||||
- `${CLAUDE_PLUGIN_ROOT}/CLAUDE.md` — kommando-/agent-/hook-arkitektur
|
||||
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/SKILL.md` — kunnskapsbase-indeks
|
||||
|
|
@ -114,5 +114,6 @@ OKR-kontekst injiseres automatisk via hook. Sjekk system-konteksten FØR du spø
|
|||
|
||||
## Referanser
|
||||
|
||||
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-quality-rubrics.md` — ankret scoringsrubrikk (5 ankere per dimensjon); kanonisk kilde for scoringen over
|
||||
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-antipatterns.md` — alle 19 antipatterns
|
||||
- `${CLAUDE_PLUGIN_ROOT}/skills/okr-offentlig-sektor/references/okr-examples.md` — gode vs dårlige eksempler
|
||||
|
|
|
|||
|
|
@ -129,6 +129,7 @@ All reference material is in `references/`:
|
|||
|
||||
### Methodology
|
||||
- `okr-framework.md` — Core methodology, scoring, cycle management
|
||||
- `okr-quality-rubrics.md` — Anchored quality rubric (5 anchors per dimension) for `/okr:kvalitet`
|
||||
- `okr-examples.md` — Good and bad examples from public sector
|
||||
- `okr-antipatterns.md` — 19 common OKR mistakes
|
||||
- `okr-sources.md` — Bibliographic evidence base
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue