5078712f0e
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>
281 lines
8.7 KiB
Markdown
281 lines
8.7 KiB
Markdown
# OKR for Public Sector
|
|
|
|
> Expert OKR guidance tailored for Norwegian public sector organizations.
|
|
|
|
*Solo project — bug reports welcome, PRs not accepted.*
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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)
|