docs(okr): rewrite README for non-technical audience, reframe around strategy-to-OKR
Shift focus from tildelingsbrev-specific to general strategy transformation. More motivating, explains what and why for leaders/advisors, not developers. Updated marketplace root README section to match. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen
parent
ac95cd6a30
commit
a8323f99d5
2 changed files with 171 additions and 276 deletions
22
README.md
22
README.md
|
|
@ -125,22 +125,20 @@ Key commands: `/linkedin:onboarding`, `/linkedin:post`, `/linkedin:quick`, `/lin
|
|||
|
||||
### [OKR for Public Sector](plugins/okr/) `v1.3.0` `🇳🇴 Norwegian`
|
||||
|
||||
Your AI-powered OKR coach for Norwegian public sector — not just methodology, but a partner that learns your organization, tracks your progress across cycles, and coaches proactively.
|
||||
Turn strategy into measurable goals. An AI coach that learns your organization, tracks progress across cycles, and guides you from first OKR to organizational mastery.
|
||||
|
||||
Generic OKR assumes quarterly cycles, bonus-linked performance, and flat org charts. Norwegian government operates on 4-month tertials, tildelingsbrev mandates, and a six-level governance chain: Stortingsmelding → departementsstrategi → tildelingsbrev → etatsstrategi → divisjon → team OKR. v1.3 adds the AI-first features that no commercial OKR tool can match.
|
||||
Most OKR tools explain methodology. This plugin *knows your organization*. After a one-time onboarding conversation, it remembers your maturity level, strategic goals, current OKR, and cultural challenges. Every interaction builds on that knowledge — so you spend time on strategy, not re-explaining context.
|
||||
|
||||
- **Tildelingsbrev gap analysis** — `/okr:gap` auto-reads your stored tildelingsbrev and current OKR, produces a coverage matrix showing which requirements are met, partially met, or uncovered
|
||||
- **Cross-cycle analytics** — `/okr:analyse` reads archived cycles from historikk/, generates Mermaid trend charts for score progression, antipattern frequency, and alignment coverage
|
||||
- **Proactive coaching** — SessionStart hook calculates cycle position, detects at-risk KR, surfaces previous cycle learnings, and recommends actions based on phase (early/mid/late)
|
||||
- **Deep onboarding** — 28-question interview across 6 phases (or 6-question MVP for quick start) builds a persistent organizational profile. Every command adapts automatically.
|
||||
- **Persistent context** — store tildelingsbrev, org-OKR, and cycle data in `.claude/okr/`. Commands auto-read relevant files instead of asking you to paste.
|
||||
- **DFO terminology bridge** — maps between DFO's "mål- og resultatstyring" vocabulary and OKR concepts for smoother adoption
|
||||
- **Antipattern detection** — 19 named failure modes (sandbagging, quarterly theater, goalpost moving, OKR-shaming) across formuleringsfeil, prosessfeil, kulturfeil, strukturfeil, ledelsesfeil
|
||||
- **Cycle archival** — end-of-cycle workflow generates retrospective with scoring analysis, archives to historikk, and rolls forward to next cycle
|
||||
- **Strategy to OKR** — transform goals from virksomhetsplan, tildelingsbrev, or any strategic document into well-structured OKR with guided writing, quality checks, and alignment scoring
|
||||
- **Gap analysis** — `/okr:gap` compares your strategic documents against current OKR and shows what's covered, what's missing, and what to do about it
|
||||
- **Cross-cycle learning** — `/okr:analyse` tracks score trends, recurring antipatterns, and alignment progress across cycles with visual charts
|
||||
- **Proactive coaching** — automatically tells you where you are in the cycle and what to focus on — progress checks mid-cycle, retrospective prep near the end
|
||||
- **19 antipattern detection** — catches sandbagging, activity-disguised-as-KR, set-and-forget, and 16 more named failure modes before they take root
|
||||
- **Built for norsk offentlig sektor** — 4-month tertials, DFO terminology, tillitsvalgt involvement, Riksrevisjon-ready documentation, governance chain from Stortingsmelding to team OKR
|
||||
|
||||
Key commands: `/okr:oppsett`, `/okr:skriv`, `/okr:kvalitet`, `/okr:governance`, `/okr:gap`, `/okr:analyse`, `/okr:kaskade`, `/okr:sporing`
|
||||
Key commands: `/okr:skriv`, `/okr:kvalitet`, `/okr:gap`, `/okr:analyse`, `/okr:kaskade`, `/okr:sporing`, `/okr:governance`, `/okr:oppsett`
|
||||
|
||||
7 specialized agents · 10 commands · 4 hooks · 16 reference docs
|
||||
7 agents · 10 commands · 4 hooks · 16 reference docs
|
||||
|
||||
→ [Full documentation](plugins/okr/README.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# OKR for Public Sector
|
||||
|
||||
> Your AI-powered OKR coach for Norwegian public sector organizations — not just a methodology library, but a partner that knows your organization, your challenges, and your current OKRs.
|
||||
> Turn strategy into measurable goals. An AI coach that learns your organization, tracks progress across cycles, and guides you from first OKR to organizational mastery.
|
||||
|
||||
*Solo project — bug reports welcome, PRs not accepted.*
|
||||
|
||||
|
|
@ -9,58 +9,124 @@
|
|||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## The Difference
|
||||
## Why This Exists
|
||||
|
||||
Most OKR tools explain methodology. This plugin *coaches* you through it.
|
||||
Every organization has a strategy. Few manage to turn it into goals that teams actually work toward.
|
||||
|
||||
The secret: persistent organizational context. After a one-time onboarding interview, every command knows who you are, where you are in the cycle, and what strategic goals you're working toward. No more pasting the same tildelingsbrev into every session. No more re-explaining your maturity level.
|
||||
OKR (Objectives and Key Results) is a proven framework for that translation — used by Google, Intel, and increasingly by Norwegian public sector organizations like NAV, FINN.no, and Statens vegvesen. But adopting OKR is hard. The methodology sounds simple ("write inspiring goals with measurable results") until you try it. Then you hit real questions:
|
||||
|
||||
```
|
||||
# Before v1.1 — every session started from scratch
|
||||
> /okr:governance
|
||||
"Please paste your tildelingsbrev..."
|
||||
"What organization are you in?"
|
||||
"What cycle are you in?"
|
||||
- *How do we connect our OKR to the goals in our tildelingsbrev?*
|
||||
- *What's a good Key Result vs. just an activity disguised as one?*
|
||||
- *How do we handle it when political priorities shift mid-cycle?*
|
||||
- *Are we actually getting better at this, or just going through the motions?*
|
||||
|
||||
# After v1.1 — the plugin already knows
|
||||
> /okr:governance
|
||||
"I see your tildelingsbrev for 2026 in .claude/okr/strategisk-kontekst/.
|
||||
Starting gap analysis against your org-level OKR..."
|
||||
```
|
||||
This plugin is an AI coach that helps with all of these. It's built specifically for Norwegian public sector — 4-month tertial cycles, DFO's "mål- og resultatstyring" framework, tillitsvalgt involvement, and the governance chain from Stortingsmelding to team OKR.
|
||||
|
||||
### What makes it different from a methodology guide?
|
||||
|
||||
A methodology guide explains OKR theory. This plugin *knows your organization*.
|
||||
|
||||
After a one-time onboarding conversation, it remembers your maturity level, your strategic documents, your current OKR, and your cultural challenges. Every interaction builds on that knowledge. When you ask it to write new OKR, it already knows what your organization is trying to achieve. When you check quality, it checks alignment against your actual strategy — not a generic rubric.
|
||||
|
||||
Over time, it tracks how your OKR practice evolves. It spots recurring mistakes, shows score trends, and coaches you based on where you are in the cycle. Early in the cycle? Focus on alignment. Midway? Time for a progress check. Near the end? Let's prepare the retrospective.
|
||||
|
||||
---
|
||||
|
||||
## Table of Contents
|
||||
## What It Does
|
||||
|
||||
- [Quick Start](#quick-start)
|
||||
- [Commands](#commands)
|
||||
- [What's New in v1.1](#whats-new-in-v11)
|
||||
- [Agents](#agents)
|
||||
- [Hooks](#hooks)
|
||||
- [Knowledge Base](#knowledge-base)
|
||||
- [Workflow Examples](#workflow-examples)
|
||||
- [Public Sector Features](#public-sector-features)
|
||||
- [Configuration](#configuration)
|
||||
- [Integrations](#integrations)
|
||||
- [Limitations](#limitations)
|
||||
- [Version History](#version-history)
|
||||
- [License](#license)
|
||||
### From Strategy to OKR
|
||||
|
||||
The core workflow: take your strategic goals (from virksomhetsplan, tildelingsbrev, etatsstrategi, or any strategic document) and transform them into well-structured OKR.
|
||||
|
||||
```
|
||||
> /okr:skriv We want to make the application process faster for citizens
|
||||
```
|
||||
|
||||
The plugin guides you through writing an inspiring Objective and measurable Key Results, calibrating ambition, and checking alignment against your organization's strategic direction.
|
||||
|
||||
### Quality That Goes Beyond Spell-Check
|
||||
|
||||
```
|
||||
> /okr:kvalitet
|
||||
```
|
||||
|
||||
Checks your OKR against 19 named antipatterns (like "activity disguised as a Key Result", "sandbagging", or "set-and-forget") and scores quality across multiple dimensions. If your OKR has issues, you get concrete improvement suggestions — not just "try harder."
|
||||
|
||||
### Strategy Alignment
|
||||
|
||||
```
|
||||
> /okr:kaskade
|
||||
```
|
||||
|
||||
Cascades OKR from organizational level down to teams. Shows which strategic goals have team support and which are orphaned. If you've stored your org-level OKR, it reads them automatically.
|
||||
|
||||
### Gap Analysis
|
||||
|
||||
```
|
||||
> /okr:gap
|
||||
```
|
||||
|
||||
Compares your strategic documents (tildelingsbrev, virksomhetsplan) against your current OKR and produces a coverage matrix: which requirements are fully covered, which are partially covered, and which are completely missing. For each gap, it suggests OKR formulations.
|
||||
|
||||
### Progress Tracking
|
||||
|
||||
```
|
||||
> /okr:sporing
|
||||
```
|
||||
|
||||
Calculates scores (0.0–1.0), assesses confidence levels, generates forecasts, and flags Key Results that are at risk. If you use Linear, it can sync status there too.
|
||||
|
||||
### Cross-Cycle Learning
|
||||
|
||||
```
|
||||
> /okr:analyse
|
||||
```
|
||||
|
||||
After your first completed cycle, this is where the real value begins. Reads your archived cycles and shows:
|
||||
- **Score trends** — are you improving? Visualized with charts.
|
||||
- **Recurring antipatterns** — the same mistakes across cycles get flagged explicitly.
|
||||
- **Alignment progression** — is your team coverage of org goals getting better?
|
||||
|
||||
### Proactive Coaching
|
||||
|
||||
You don't have to remember to check in. When you start a session, the plugin automatically tells you where you are in the cycle and what to focus on:
|
||||
|
||||
> *"OKR coaching: Week 12 of 16 in T1-2026. Approaching cycle end — focus on final scoring and retrospective preparation. 2 KR flagged as at-risk in last status update."*
|
||||
|
||||
### Meetings and Facilitation
|
||||
|
||||
```
|
||||
> /okr:moter
|
||||
```
|
||||
|
||||
Generates tailored agendas for OKR workshops, check-ins, reviews, and 1:1 conversations using the CFR (Conversations, Feedback, Recognition) framework — adapted for public sector where bonuses aren't an option.
|
||||
|
||||
### Adoption and Change Management
|
||||
|
||||
```
|
||||
> /okr:innforing
|
||||
```
|
||||
|
||||
Planning to introduce OKR in your organization? Get a phased rollout plan with resistance-handling strategies, maturity assessment, and guidance on involving tillitsvalgte — because in Norwegian public sector, change management without union involvement doesn't work.
|
||||
|
||||
### Governance and Compliance
|
||||
|
||||
```
|
||||
> /okr:governance
|
||||
```
|
||||
|
||||
Translate tildelingsbrev requirements into OKR. Map the governance chain (Stortingsmelding → tildelingsbrev → etatsstrategi → OKR). Verify that your OKR documentation meets Riksrevisjon standards.
|
||||
|
||||
---
|
||||
|
||||
## Quick Start
|
||||
## Getting Started
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
|
||||
- Optional: [Linear](https://linear.app) account for OKR tracking
|
||||
|
||||
### Installation
|
||||
### Install
|
||||
|
||||
Add to your Claude Code plugin configuration:
|
||||
|
||||
|
|
@ -80,310 +146,141 @@ Add to your Claude Code plugin configuration:
|
|||
|
||||
Six questions, five minutes. The plugin learns your organization, maturity level, tools, and cycle phase. From that point on, every command adapts to your context.
|
||||
|
||||
Want the full experience? Run `/okr:oppsett full` for a 28-question deep interview across six phases (identity, maturity, strategic context, structure, tools, culture). Takes 15-20 minutes, but unlocks everything — including storing your tildelingsbrev and org-level OKR for automatic alignment checks.
|
||||
Want the full experience? `/okr:oppsett full` runs a deeper interview (15-20 minutes) that also captures your strategic context, cultural challenges, and organizational structure.
|
||||
|
||||
After setup:
|
||||
### Typical Workflow
|
||||
|
||||
**Starting fresh:**
|
||||
```
|
||||
> /okr:skriv We want to improve digital self-service for citizens
|
||||
/okr:oppsett full # One-time setup
|
||||
/okr:skriv # Write your first OKR
|
||||
/okr:kvalitet # Quality check
|
||||
/okr:kaskade # Align with org goals
|
||||
```
|
||||
|
||||
The plugin already knows your organization, cycle, and strategic goals. It drafts aligned OKR immediately.
|
||||
**During a cycle:**
|
||||
```
|
||||
/okr:sporing # Update progress
|
||||
/okr:moter # Prepare check-in meeting
|
||||
```
|
||||
|
||||
**End of cycle:**
|
||||
```
|
||||
/okr:oppsett arkiver # Archive with retrospective
|
||||
/okr:analyse # See how you're trending
|
||||
/okr:skriv # Start the next cycle
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Commands
|
||||
## Built for Norwegian Public Sector
|
||||
|
||||
### Writing & Quality
|
||||
### What's different about OKR in offentlig sektor?
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/okr:skriv` | Write new OKR with guided Objective and KR creation. Reads stored strategic context for alignment. |
|
||||
| `/okr:kvalitet` | Quality check against rubric, detect 19 antipatterns, check alignment vs. stored org-OKR |
|
||||
| Challenge | How the plugin helps |
|
||||
|-----------|---------------------|
|
||||
| 4-month tertial cycles (not quarterly) | Built-in tertial support with correct week counting and phase detection |
|
||||
| Tildelingsbrev drives priorities | `/okr:governance` and `/okr:gap` translate and check coverage |
|
||||
| DFO uses different terminology | Built-in mapping between "mål- og resultatstyring" and OKR concepts |
|
||||
| Riksrevisjonen requires documentation | Audit-ready format with baseline, target, data source per KR |
|
||||
| No performance bonuses | CFR framework designed for recognition without financial incentives |
|
||||
| Tillitsvalgte must be involved | Guidance on drøftingsplikt, transparent KR, and union involvement |
|
||||
| Consensus culture | Advice calibrated for organizations where stretch goals feel risky |
|
||||
| Political priorities can shift mid-cycle | Strategies for handling mid-cycle mandate changes |
|
||||
|
||||
### Alignment & Tracking
|
||||
### The governance chain
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/okr:kaskade` | Cascade OKR from organization to team. Auto-reads org-OKR from stored context. |
|
||||
| `/okr:sporing` | Track progress (0.0-1.0 scoring), auto-load OKR from `.claude/okr/syklus/` |
|
||||
```
|
||||
Stortingsmelding / NTP
|
||||
|
|
||||
Tildelingsbrev fra departement
|
||||
|
|
||||
Etatsstrategi / Virksomhetsplan
|
||||
|
|
||||
Org-level OKR (annual, strategic)
|
||||
|
|
||||
Cycle OKR (tertial, tactical)
|
||||
|
|
||||
Team OKR
|
||||
```
|
||||
|
||||
### Meetings & Change Management
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/okr:moter` | Plan OKR workshops, check-ins, reviews, and 1:1 conversations (CFR framework) |
|
||||
| `/okr:innforing` | Rollout planning, resistance handling, maturity assessment. Adapts to your known maturity level. |
|
||||
|
||||
### Governance & Setup
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/okr:governance` | Translate tildelingsbrev to OKR, Riksrevisjon compliance. Auto-reads stored tildelingsbrev. |
|
||||
| `/okr:oppsett` | Onboarding interview, profile management, cycle archival. Args: `full` `mvp` `arkiver` `oppdater` `vis` |
|
||||
The plugin understands this hierarchy and helps you maintain alignment at every level.
|
||||
|
||||
---
|
||||
|
||||
## What's New in v1.1
|
||||
## Under the Hood
|
||||
|
||||
### Deep Onboarding Interview
|
||||
### Agents
|
||||
|
||||
`/okr:oppsett full` runs a structured 28-question interview across six phases:
|
||||
7 specialized agents activate automatically:
|
||||
|
||||
| Phase | Duration | What the Plugin Learns |
|
||||
|-------|----------|----------------------|
|
||||
| 1. Identity | 2 min | Organization type, ministry, domain, size |
|
||||
| 2. Maturity | 5 min | OKR history, sponsor/champion, salary decoupling |
|
||||
| 3. Strategic context | 5 min | Tildelingsbrev goals, org-level OKR, strategic plan |
|
||||
| 4. Structure | 3 min | OKR levels, user role, team count, cascade approach |
|
||||
| 5. Tools | 2 min | Task/OKR/meeting tools, delivery methodology |
|
||||
| 6. Culture | 3 min | Check-in rhythm, psychological safety, known antipatterns |
|
||||
| Agent | Role |
|
||||
|-------|------|
|
||||
| kvalitetssjekker | Score quality, detect antipatterns, check alignment |
|
||||
| kaskadebygger | Build cascades between organizational levels |
|
||||
| fremdriftssporer | Calculate scores, forecast completion, flag risks |
|
||||
| møtefasilitator | Generate meeting agendas and facilitation materials |
|
||||
| styringsrådgiver | Governance analysis, tildelingsbrev translation, audit compliance |
|
||||
| gapanalytiker | Coverage matrix between strategic documents and OKR |
|
||||
| trendanalytiker | Cross-cycle pattern analysis with trend visualization |
|
||||
|
||||
Don't have 20 minutes? `/okr:oppsett mvp` asks 6 questions and gets you 80% of the value.
|
||||
### Hooks
|
||||
|
||||
The interview is **interruptible** — if you quit mid-session, it saves progress and picks up where you left off next time.
|
||||
| Event | What it does |
|
||||
|-------|-------------|
|
||||
| SessionStart | Proactive coaching — tells you where you are in the cycle and what to focus on |
|
||||
| UserPromptSubmit | Injects your organization profile and available context files into every interaction |
|
||||
| PreCompact | Preserves OKR draft state if the conversation gets long |
|
||||
| Stop | Reminds you to save work to your tracking system |
|
||||
|
||||
### Persistent Context Directory
|
||||
### Knowledge Base
|
||||
|
||||
The plugin now maintains a structured context tree in your project:
|
||||
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.
|
||||
|
||||
### Persistent Context
|
||||
|
||||
```
|
||||
.claude/
|
||||
okr.local.md # Expanded organizational profile
|
||||
okr.local.md # Your organizational profile
|
||||
okr/
|
||||
strategisk-kontekst/ # Your strategic documents
|
||||
tildelingsbrev-2026.md # Key mandate goals
|
||||
overordnede-okr.md # Org-level OKR
|
||||
virksomhetsplan.md # Strategic plan
|
||||
syklus/
|
||||
T1-2026/ # Active cycle
|
||||
okr-digitalt-team.md # Team OKR files
|
||||
status.md # Confidence levels
|
||||
historikk/ # Archived cycles with retrospectives
|
||||
dokumenter/ # Ad-hoc reference documents
|
||||
strategisk-kontekst/ # Strategic documents you provide
|
||||
syklus/T1-2026/ # Active cycle OKR and status
|
||||
historikk/ # Archived cycles with retrospectives
|
||||
dokumenter/ # Any other relevant documents
|
||||
```
|
||||
|
||||
Every command reads from this tree automatically. Place your tildelingsbrev in `strategisk-kontekst/` once, and `/okr:governance` starts gap analysis without asking you to paste anything.
|
||||
|
||||
### Context-Aware Commands
|
||||
|
||||
All commands now check injected context before asking questions:
|
||||
|
||||
- **Already know your org and cycle?** Skips those questions entirely.
|
||||
- **OKR files in the cycle directory?** Reads them directly instead of asking you to paste.
|
||||
- **Tildelingsbrev stored?** Starts gap analysis immediately.
|
||||
- **Maturity level known?** Tailors advice to your exact phase.
|
||||
|
||||
### Cycle Archival
|
||||
|
||||
`/okr:oppsett arkiver` handles the end-of-cycle workflow:
|
||||
|
||||
1. Reads all active OKR and collects final scores
|
||||
2. Generates a retrospective with results, learnings, and antipattern analysis
|
||||
3. Archives everything to `historikk/`
|
||||
4. Rolls the profile forward to the next cycle
|
||||
5. Creates a fresh cycle directory ready for planning
|
||||
|
||||
### The Single Most Important Question
|
||||
|
||||
> "Is OKR decoupled from salary and medarbeidersamtale?"
|
||||
|
||||
If the answer is no or uncertain, the plugin flags this as priority zero. OKR tied to compensation is the single most destructive antipattern — it kills stretch goals, breeds sandbagging, and undermines the entire methodology.
|
||||
|
||||
---
|
||||
|
||||
## Agents
|
||||
|
||||
5 specialized agents activate automatically based on context:
|
||||
|
||||
| Agent | Model | Role |
|
||||
|-------|-------|------|
|
||||
| kvalitetssjekker | Sonnet | Score OKR quality (1-10), detect 19 antipatterns, check alignment |
|
||||
| kaskadebygger | Sonnet | Build cascades between org levels, find alignment gaps |
|
||||
| fremdriftssporer | Sonnet | Calculate progress scores, forecast completion, flag at-risk KRs |
|
||||
| motefasilitator | Sonnet | Generate meeting agendas and facilitation materials |
|
||||
| styringsradgiver | Opus | Tildelingsbrev analysis, governance mapping, audit compliance |
|
||||
|
||||
---
|
||||
|
||||
## Hooks
|
||||
|
||||
| Event | Type | Purpose |
|
||||
|-------|------|---------|
|
||||
| UserPromptSubmit | command | Inject org profile, cycle phase, maturity, and `.claude/okr/` directory listing |
|
||||
| PreCompact | prompt | Preserve OKR draft state during context compaction |
|
||||
| Stop | prompt | Remind user to save OKR work to tracking system |
|
||||
|
||||
The UserPromptSubmit hook reads your expanded profile and scans the `.claude/okr/` tree in under 50ms. It tells every command what context files are available so they can read them proactively.
|
||||
|
||||
---
|
||||
|
||||
## Knowledge Base
|
||||
|
||||
15 reference files in `skills/okr-offentlig-sektor/references/`:
|
||||
|
||||
| File | Content |
|
||||
|------|---------|
|
||||
| `okr-framework.md` | Core methodology, scoring, cycle management |
|
||||
| `okr-examples.md` | Good and bad examples from public sector |
|
||||
| `okr-antipatterns.md` | 19 common OKR mistakes across 5 categories |
|
||||
| `okr-offentlig-governance.md` | Tildelingsbrev, political steering, audit compliance |
|
||||
| `okr-implementation.md` | Rollout methodology and change management |
|
||||
| `okr-integrations.md` | OKR + Scrum/Kanban/SAFe integration |
|
||||
| `cfr-framework.md` | CFR methodology and 1:1 templates |
|
||||
| `meeting-guides.md` | Agendas for all OKR meeting types |
|
||||
| `metrics-library.md` | Common KPIs for transport/roads/digital |
|
||||
| `okr-calculator.md` | Progress calculation and confidence assessment |
|
||||
| `okr-arshjul.md` | Annual cycle and budget synchronization |
|
||||
| `okr-sources.md` | Bibliographic evidence base |
|
||||
| `okr-cheatsheet.md` | One-page OKR best practices |
|
||||
| `okr-oboard-guide.md` | Oboard tool guide |
|
||||
| `individual-vs-team-okr.md` | Team vs individual OKR rationale |
|
||||
| `dfo-okr-mapping.md` | DFO terminology mapping (maal- og resultatstyring) |
|
||||
|
||||
---
|
||||
|
||||
## Workflow Examples
|
||||
|
||||
### New Team Starting OKR
|
||||
|
||||
```
|
||||
/okr:oppsett full # Deep onboarding (once, 15-20 min)
|
||||
/okr:skriv # Write first OKR — plugin knows your context
|
||||
/okr:kvalitet # Quality check with alignment scoring
|
||||
/okr:kaskade # Verify alignment with org objectives (auto-loaded)
|
||||
```
|
||||
|
||||
### Mid-Cycle Check-In
|
||||
|
||||
```
|
||||
/okr:sporing # Auto-loads OKR from .claude/okr/syklus/, asks for new scores
|
||||
/okr:moter # Generate check-in agenda pre-filled with actual OKR status
|
||||
```
|
||||
|
||||
### Government Mandate Translation
|
||||
|
||||
```
|
||||
/okr:governance # Auto-reads stored tildelingsbrev, starts gap analysis
|
||||
/okr:kvalitet # Verify generated OKR quality
|
||||
/okr:kaskade # Cascade to team level
|
||||
```
|
||||
|
||||
### End of Cycle
|
||||
|
||||
```
|
||||
/okr:oppsett arkiver # Archive with retrospective, roll forward to next cycle
|
||||
/okr:moter # Plan kick-off workshop for new cycle
|
||||
/okr:skriv # Draft new OKR informed by last cycle's learnings
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Public Sector Features
|
||||
|
||||
### Governance Integration
|
||||
|
||||
| Framework | Plugin Support |
|
||||
|-----------|---------------|
|
||||
| Tildelingsbrev | Translate to OKR with audit trail. Store once, reference automatically. |
|
||||
| Riksrevisjonen | Documentation with baseline, target, data source per KR |
|
||||
| Political steering | Handle mid-cycle priority changes with rationale |
|
||||
| NTP / Stortingsmelding | Cascade from national policy to team OKR |
|
||||
| DFO terminology | Mapping between maal- og resultatstyring and OKR concepts |
|
||||
|
||||
### Tillitsvalgt Perspective
|
||||
|
||||
The plugin includes guidance on union involvement in OKR processes — droftingsplikt under Hovedavtalen, transparent KR that builds trust, and techniques for including tillitsvalgte as OKR stakeholders.
|
||||
|
||||
### CFR Framework
|
||||
|
||||
Integrated Conversations, Feedback, Recognition methodology:
|
||||
- **Conversations** — Structured 1:1 templates adapted for offentlig sektor
|
||||
- **Feedback** — Continuous two-way feedback decoupled from formal medarbeidersamtale
|
||||
- **Recognition** — Techniques that work without bonus-linking (which public sector can't do)
|
||||
|
||||
---
|
||||
|
||||
## Configuration
|
||||
|
||||
### Interactive Setup
|
||||
|
||||
Run `/okr:oppsett` to configure. The expanded profile covers:
|
||||
|
||||
| Section | Fields |
|
||||
|---------|--------|
|
||||
| Organisation | Name, type, ministry, domain, size, geography |
|
||||
| Program | Maturity level, cycles completed, sponsor, champion, salary decoupling |
|
||||
| Current cycle | ID, period, phase, team count |
|
||||
| Tools | Task management, OKR tracking, meetings, delivery methodology |
|
||||
| Culture | Check-in rhythm, psychological safety, known challenges |
|
||||
| Integrations | Linear (team and project IDs) |
|
||||
| Preferences | Language, examples, ambition level |
|
||||
|
||||
Configuration is saved to `.claude/okr.local.md` in your project directory (add to `.gitignore`).
|
||||
|
||||
### Subcommands
|
||||
|
||||
| Subcommand | Purpose |
|
||||
|------------|---------|
|
||||
| `/okr:oppsett full` | 28-question deep interview (recommended first time) |
|
||||
| `/okr:oppsett mvp` | 6-question quick start |
|
||||
| `/okr:oppsett arkiver` | Archive current cycle with retrospective |
|
||||
| `/okr:oppsett oppdater` | Update specific profile fields |
|
||||
| `/okr:oppsett vis` | Display current configuration |
|
||||
|
||||
---
|
||||
|
||||
## Integrations
|
||||
|
||||
### Linear
|
||||
|
||||
OKR tracking via Linear MCP when configured through `/okr:oppsett`:
|
||||
- Progress score updates via comments
|
||||
- Status field tracking
|
||||
- Team and project organization
|
||||
|
||||
### Agile Frameworks
|
||||
|
||||
Knowledge base includes integration patterns for Scrum, Kanban, SAFe, and project portfolio management. See `references/okr-integrations.md`.
|
||||
|
||||
---
|
||||
|
||||
## Roadmap
|
||||
|
||||
See [ROADMAP.md](ROADMAP.md) for full details.
|
||||
|
||||
| Version | Status | Focus |
|
||||
|---------|--------|-------|
|
||||
| v1.1 | **Shipped** | Personalized onboarding, persistent context, cycle archival |
|
||||
| v1.3 | Planned | Cycle lifecycle automation, cross-cycle analytics |
|
||||
| v1.4 | Planned | Proactive coaching, deadline notifications, quality gates |
|
||||
| v2.0 | Future | Multi-team support, cross-team alignment views, consolidated dashboards |
|
||||
| v1.1 | Shipped | Personalized onboarding, persistent context, cycle archival |
|
||||
| v1.3 | **Shipped** | Gap analysis, cross-cycle analytics, proactive coaching |
|
||||
| v2.0 | Planned | Multi-team support, cross-team alignment views |
|
||||
|
||||
---
|
||||
See [ROADMAP.md](ROADMAP.md) for details.
|
||||
|
||||
## Limitations
|
||||
|
||||
- Not tested in a real OKR cycle beyond the author's organization
|
||||
- No automated tests (hooks are verified manually)
|
||||
- Windows: not tested
|
||||
- Norwegian public sector context only — may not fit private sector or other countries
|
||||
- Designed for Norwegian public sector — may not fit other contexts without adaptation
|
||||
- Not yet tested in a real multi-cycle OKR program
|
||||
- Linear is the only supported tracking integration
|
||||
- YAML parsing in hooks uses regex, not a full parser (works for controlled output)
|
||||
- Norwegian language for all user-facing interactions
|
||||
|
||||
---
|
||||
|
||||
## Version History
|
||||
|
||||
See [CHANGELOG.md](CHANGELOG.md) for full details.
|
||||
|
||||
| Version | Date | Highlights |
|
||||
|---------|------|------------|
|
||||
| **1.3.0** | 2026-04-08 | AI-first differentiators: `/okr:gap` (tildelingsbrev gap analysis), `/okr:analyse` (cross-cycle Mermaid analytics), proactive SessionStart coaching |
|
||||
| **1.1.0** | 2026-04-08 | Persistent context: deep onboarding interview (full/mvp), `.claude/okr/` directory tree, context-aware commands, cycle archival with retrospective |
|
||||
| **1.0.0** | 2026-04-08 | Architecture overhaul: self-contained commands, hooks, model optimization, marketplace-ready |
|
||||
| **1.3.0** | 2026-04-08 | Gap analysis, cross-cycle analytics with Mermaid visualizations, proactive SessionStart coaching |
|
||||
| **1.1.0** | 2026-04-08 | Persistent context, deep onboarding, context-aware commands, cycle archival |
|
||||
| **1.0.0** | 2026-04-08 | Architecture overhaul, self-contained commands, hooks, marketplace-ready |
|
||||
| 0.5.0 | 2026-02-07 | First formal version |
|
||||
|
||||
See [CHANGELOG.md](CHANGELOG.md) for full details.
|
||||
|
||||
---
|
||||
|
||||
## License
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue