feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector

Expert OKR guidance based on Google/Doerr methodology, adapted for 4-month tertial cycles and Norwegian government accountability. Components: - 8 commands (skriv, kvalitet, kaskade, sporing, møter, innføring, governance, oppsett) - 5 agents (kvalitetssjekker, kaskadebygger, fremdriftssporer, møtefasilitator, styringsrådgiver) - 3 hooks (UserPromptSubmit context injection, PreCompact state preservation, Stop reminder) - 15 reference files covering methodology, governance, meetings, antipatterns - Linear MCP integration for OKR tracking Previously in ktg-privat, now open-sourced. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-08 13:32:45 +02:00 · 2026-04-08 13:32:45 +02:00 · 5078712f0e
commit 5078712f0e
parent 96d4d3ee45
42 changed files with 7341 additions and 0 deletions
--- a/plugins/okr/README.md
+++ b/plugins/okr/README.md
@ -0,0 +1,281 @@
+# OKR for Public Sector
+
+> Expert OKR guidance tailored for Norwegian public sector organizations.
+
+*Solo project — bug reports welcome, PRs not accepted.*
+
+![Version](https://img.shields.io/badge/version-1.0.0-blue)
+![Platform](https://img.shields.io/badge/platform-Claude_Code_Plugin-purple)
+![Agents](https://img.shields.io/badge/agents-5-orange)
+![Commands](https://img.shields.io/badge/commands-8-blue)
+![Hooks](https://img.shields.io/badge/hooks-3-green)
+![References](https://img.shields.io/badge/references-15-yellow)
+![License](https://img.shields.io/badge/license-MIT-lightgrey)
+
+A Claude Code plugin that provides structured OKR (Objectives and Key Results) guidance for Norwegian public sector organizations. Based on Google/Doerr methodology, adapted for 4-month tertial cycles, government accountability requirements, and public sector governance.
+
+---
+
+## Table of Contents
+
+- [What Is This?](#what-is-this)
+- [Quick Start](#quick-start)
+- [Commands](#commands)
+- [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)
+
+---
+
+## What Is This?
+
+This plugin transforms Claude Code into a specialized OKR advisor that understands the unique constraints of Norwegian public sector organizations:
+
+- **8 commands** covering the complete OKR lifecycle
+- **5 specialized agents** that activate automatically based on context
+- **Government alignment** — translate tildelingsbrev into actionable OKR with audit-ready documentation
+- **4-month tertial cycles** as the default cadence
+- **CFR framework** (Conversations, Feedback, Recognition) for meaningful 1:1 conversations
+- **Cascade visualization** showing alignment from organization level down to teams
+- **Linear integration** for tracking OKR as issues with progress scoring
+
+> [!TIP]
+> Start with `/okr:oppsett` to configure your organization context, then use `/okr:skriv` to create your first OKR.
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
+- Optional: [Linear](https://linear.app) account for OKR tracking
+
+### Installation
+
+Add to your Claude Code plugin configuration:
+
+```json
+{
+  "enabledPlugins": {
+    "okr@ktg-plugin-marketplace": true
+  }
+}
+```
+
+### First Conversation
+
+```
+> /okr:oppsett
+
+Welcome to the OKR plugin setup wizard.
+
+1. Which organization do you work for?
+2. What cycle model do you use? (Tertial recommended)
+3. Would you like to integrate with Linear?
+
+[Interactive configuration follows...]
+```
+
+After setup, try:
+
+```
+> /okr:skriv We want to improve digital services for citizens
+```
+
+---
+
+## Commands
+
+### Writing & Quality
+
+| Command | Description |
+|---------|-------------|
+| `/okr:skriv` | Write new OKR with guided Objective and KR creation |
+| `/okr:kvalitet` | Quality check OKR against rubric, detect antipatterns, suggest rewrites |
+
+### Alignment & Tracking
+
+| Command | Description |
+|---------|-------------|
+| `/okr:kaskade` | Cascade OKR from organization to team, visualize alignment |
+| `/okr:sporing` | Track progress, calculate scores (0.0-1.0), generate check-in reports |
+
+### Meetings & Change Management
+
+| Command | Description |
+|---------|-------------|
+| `/okr:møter` | Plan OKR workshops, check-ins, reviews, and 1:1 conversations |
+| `/okr:innføring` | OKR rollout planning, resistance handling, maturity assessment |
+
+### Governance & Setup
+
+| Command | Description |
+|---------|-------------|
+| `/okr:governance` | Translate tildelingsbrev to OKR, Riksrevisjon compliance |
+| `/okr:oppsett` | Interactive setup wizard for organization, cycle, integrations |
+
+---
+
+## Agents
+
+5 specialized agents activate automatically based on user intent:
+
+| Agent | Model | Role |
+|-------|-------|------|
+| kvalitetssjekker | Sonnet | Score OKR quality (1-10), detect 19 antipatterns |
+| kaskadebygger | Sonnet | Build cascades between org levels, find alignment gaps |
+| fremdriftssporer | Sonnet | Calculate progress scores, forecast completion |
+| møtefasilitator | Sonnet | Generate meeting agendas and facilitation materials |
+| styringsrådgiver | Opus | Tildelingsbrev analysis, governance, audit compliance |
+
+---
+
+## Hooks
+
+| Event | Type | Purpose |
+|-------|------|---------|
+| UserPromptSubmit | command | Auto-inject org/cycle context from `.claude/okr.local.md` |
+| PreCompact | prompt | Preserve OKR draft state during context compaction |
+| Stop | prompt | Remind user to save OKR work to tracking system |
+
+---
+
+## Knowledge Base
+
+15 reference files organized 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 |
+
+---
+
+## Workflow Examples
+
+### New Team Starting OKR
+
+```
+/okr:oppsett              # Configure organization and cycle
+/okr:skriv                # Write first OKR set
+/okr:kvalitet             # Quality check and improve
+/okr:kaskade              # Verify alignment with organization objectives
+```
+
+### Mid-Cycle Check-In
+
+```
+/okr:sporing              # Update scores, get confidence assessment
+/okr:møter                # Generate check-in meeting agenda
+```
+
+### Government Mandate Translation
+
+```
+/okr:governance           # Translate tildelingsbrev to OKR
+/okr:kvalitet             # Verify quality of generated OKR
+/okr:kaskade              # Cascade to team level
+```
+
+---
+
+## Public Sector Features
+
+### Governance Integration
+
+| Framework | Plugin Support |
+|-----------|---------------|
+| Tildelingsbrev | Translate requirements to OKR with audit trail |
+| Riksrevisjonen | Documentation templates with baseline, target, data source |
+| Political steering | Handle mid-cycle priority changes with rationale |
+| NTP / Stortingsmelding | Cascade from national policy to team OKR |
+
+### CFR Framework
+
+Integrated Conversations, Feedback, Recognition methodology:
+- **Conversations** — Structured 1:1 templates
+- **Feedback** — Continuous two-way feedback
+- **Recognition** — Techniques adapted for public sector (no bonus-linking)
+
+---
+
+## Configuration
+
+Run `/okr:oppsett` for interactive setup. Configuration is saved to `.claude/okr.local.md` in your project directory (gitignored).
+
+The UserPromptSubmit hook automatically injects your org context into every session when configured.
+
+### Configuration Template
+
+See `templates/okr.local.md.template` for the full template.
+
+---
+
+## 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 the full development roadmap.
+
+**Next up: v1.1 — Personalized Onboarding.** A deep interview process that understands your organization, maturity, culture, and strategic documents. Combined with a persistent context structure (`.claude/okr/`) that stores current OKRs, tildelingsbrev-mål, and cycle history — transforming the plugin from a methodology library into a personalized OKR coach.
+
+---
+
+## Limitations
+
+- Never tested in a real OKR cycle beyond the author's organization
+- No automated tests
+- Windows: not tested
+- Norwegian public sector context only — may not fit private sector or other countries
+- Linear is the only supported tracking integration
+
+---
+
+## Version History
+
+See [CHANGELOG.md](CHANGELOG.md) for full details.
+
+| Version | Date | Highlights |
+|---------|------|------------|
+| **1.0.0** | 2026-04-08 | Architecture overhaul: self-contained commands, hooks, model optimization, marketplace-ready |
+| 0.5.0 | 2026-02-07 | First formal version |
+
+---
+
+## License
+
+[MIT](LICENSE)