diff --git a/CLAUDE.md b/CLAUDE.md index fa6d6b0..bce4054 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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) ``` diff --git a/README.md b/README.md index 0f6fe5a..f08e235 100644 --- a/README.md +++ b/README.md @@ -9,9 +9,9 @@ ![Version](https://img.shields.io/badge/version-1.4.0-blue) ![Platform](https://img.shields.io/badge/platform-Claude_Code_Plugin-purple) ![Agents](https://img.shields.io/badge/agents-7-orange) -![Commands](https://img.shields.io/badge/commands-10-blue) +![Commands](https://img.shields.io/badge/commands-13-blue) ![Hooks](https://img.shields.io/badge/hooks-4-green) -![References](https://img.shields.io/badge/references-16-yellow) +![References](https://img.shields.io/badge/references-17-yellow) ![License](https://img.shields.io/badge/license-MIT-lightgrey) --- @@ -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 diff --git a/commands/help.md b/commands/help.md new file mode 100644 index 0000000..7cfa216 --- /dev/null +++ b/commands/help.md @@ -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 diff --git a/commands/kvalitet.md b/commands/kvalitet.md index cd3cfad..ad42a81 100644 --- a/commands/kvalitet.md +++ b/commands/kvalitet.md @@ -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 diff --git a/skills/okr-offentlig-sektor/SKILL.md b/skills/okr-offentlig-sektor/SKILL.md index 67f8b98..61c8338 100644 --- a/skills/okr-offentlig-sektor/SKILL.md +++ b/skills/okr-offentlig-sektor/SKILL.md @@ -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