ktg-plugin-marketplace/plugins/okr
Kjell Tore Guttormsen cfd3c7cd1c docs(okr): rewrite README v2 — onboarding-first, show real value
Major restructure based on user feedback:
- Lead with onboarding as the key differentiator
- Add "Bring What You Have" section with two real examples:
  tildelingsbrev parsing and existing OKR quality review
- Show iterative development process, not one-shot usage
- Stronger value proposition: OKR expert that learns your context
- Remove simplistic Q&A example that made plugin look like a form-filler

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-08 15:29:48 +02:00
..
.claude-plugin feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
agents feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
commands feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
hooks feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
skills/okr-offentlig-sektor feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
templates feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
.gitignore docs(okr): remove Roadmap section, gitignore ROADMAP.md 2026-04-08 15:12:15 +02:00
BACKLOG.md feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
CHANGELOG.md feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
CLAUDE.md feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
CODE_OF_CONDUCT.md feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
CONTRIBUTING.md feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
LICENSE feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00
README.md docs(okr): rewrite README v2 — onboarding-first, show real value 2026-04-08 15:29:48 +02:00
SECURITY.md feat: add okr plugin v1.0.0 — OKR guidance for Norwegian public sector 2026-04-08 13:32:45 +02:00

OKR for Public Sector

Expert OKR guidance tailored for Norwegian public sector organizations.

Solo project — bug reports welcome, PRs not accepted.

The Problem

OKR sounds simple until you try it in public sector. Your tildelingsbrev has 47 requirements and someone asks you to turn it into "3-5 inspiring Objectives." Teams write Key Results that are just task lists. Tertial cycles don't match the quarterly model from Google. And when Riksrevisjonen asks for documentation, nobody can trace which OKR delivered which mandate requirement.

Most OKR resources assume you're a startup. You're not. You have political steering, budget cycles tied to Stortinget, and mid-cycle priority changes from a minister who read something in Aftenposten.

This plugin gives you an OKR expert that knows Norwegian public sector governance, learns your organization's context, and works alongside you through the entire OKR process — from translating your tildelingsbrev into OKR candidates, through iterative quality improvement, to check-in meetings and cycle reviews.

How It Works: Onboarding First

The plugin starts by learning your context. This is the most important step — it's what transforms generic OKR advice into guidance that fits your organization.

/okr:oppsett runs an interactive interview that captures:

  • Your organization — which agency, which sector, which ministry
  • Your OKR maturity — first attempt, pilot phase, or scaling across teams
  • Your cycle — tertial or quarterly, current phase, team count
  • Your strategic documents — tildelingsbrev goals, virksomhetsplan priorities
  • Your tools — Linear integration, meeting tools, delivery methodology

This context is saved locally and automatically injected into every conversation. You do it once. After that, the plugin knows who you are, what cycle you're in, and what your strategic goals are.

Bring What You Have

You don't need to start from scratch. The plugin meets you where you are:

Have a tildelingsbrev? The plugin parses it, separates what's actually an OKR candidate from what's a KPI, a compliance requirement, or a reporting routine — and drafts aligned OKR directly:

> /okr:governance

I see from your tildelingsbrev that Samferdselsdepartementet expects:
- Reduce traffic fatalities by 50% by 2030 (vs. 2020) → OKR candidate
- Maintain 98% tunnel availability → KPI, not OKR
- Report quarterly on maintenance spend → Reporting routine

Here are 2 OKR candidates derived from the mandate:

Objective: Drive measurable progress toward Vision Zero on Norwegian roads

  KR1: Reduce fatalities from 95 (2025) to 85 (2026)
       Source: SSB table 08463 | Type: Committed
  KR2: Reduce severe injuries from 650 to 600
       Source: SSB | Type: Committed
  KR3: Complete safety interventions on 100% of high-risk road segments
       Source: Internal action plan | Type: Aspirational

Shall I quality-check these? Or cascade them to team level?

Have existing OKR that need improvement? Paste them in and get scored feedback with specific rewrites:

> /okr:kvalitet

Our current OKR:
Objective: Improve customer service
KR1: Complete 5 customer service training courses
KR2: Answer 90% of calls within 3 minutes

─── Quality Assessment ───

Objective: "Improve customer service" — Score: 4/10
  ✗ Vague — what does "improve" mean?
  ✗ Not inspiring — reads like a task, not a goal
  → Suggested rewrite: "Become the most responsive service unit in the agency"

KR1: "Complete 5 training courses" — Score: 2/10
  ✗ Activity, not outcome — measures what you do, not what changes
  ✗ No connection to customer experience
  → Suggested rewrite: "Increase citizen satisfaction from 3.2 to 4.5/5.0"

KR2: "Answer 90% of calls within 3 minutes" — Score: 6/10
  ✓ Measurable with clear target
  ✗ Missing baseline — what's the current level?
  → Add baseline: "Improve call response rate from [X]% to 90% within 3 minutes"

Overall: 4/10 — rewrite recommended. Shall I draft improved versions?

Starting from a vague idea? The plugin guides you through structured questioning and suggests OKR aligned with your strategic context — because it already knows your tildelingsbrev goals and organizational priorities from onboarding.

The Development Process

OKR writing is iterative. The plugin supports the full cycle:

/okr:skriv          Draft OKR — guided from idea to structured output
      ↓
/okr:kvalitet       Score against rubric, detect antipatterns, suggest rewrites
      ↓
/okr:kaskade        Verify alignment from organization level to team
      ↓
/okr:sporing        Track progress scores (0.0-1.0) during the cycle
      ↓
/okr:møter          Generate check-in agendas with actual OKR status

Each command builds on context from the others. Quality-check an OKR you just wrote. Cascade it down to team level. Track it during the cycle. Generate meeting agendas with real status data.

Quick Start

Add the marketplace:

claude plugin marketplace add https://git.fromaitochitta.com/open/ktg-plugin-marketplace.git

Or enable directly in ~/.claude/settings.json:

{
  "enabledPlugins": {
    "okr@ktg-plugin-marketplace": true
  }
}

Then run /okr:oppsett — it takes 515 minutes and unlocks everything else.

All Commands

Command What it does
/okr:oppsett Onboarding interview — configure org, cycle, strategy, integrations
/okr:skriv Write new OKR — guided from vague idea to scored, aligned output
/okr:kvalitet Score existing OKR, detect 19 antipatterns, suggest rewrites
/okr:kaskade Cascade from organization to team, visualize alignment gaps
/okr:sporing Track progress scores (0.0-1.0), generate check-in reports
/okr:møter Generate agendas for workshops, check-ins, reviews, and 1:1s
/okr:governance Translate tildelingsbrev to OKR, Riksrevisjon-ready documentation
/okr:innføring Plan OKR rollout, handle resistance, assess maturity

Public Sector Governance

Framework What the plugin does
Tildelingsbrev Parse requirements, separate OKR candidates from KPIs and compliance
Riksrevisjonen Generate audit-ready docs with baseline, target, data source, owner
Political steering Handle mid-cycle priority changes with documented rationale
NTP / Stortingsmelding Cascade from national policy down to team-level OKR

Under the Hood

5 specialized agents, 3 context-aware hooks, and a knowledge base of 15 reference documents covering methodology, antipatterns, governance, meeting formats, and sector-specific metrics. The plugin remembers your organization context across sessions via local configuration and automatic context injection.

Linear integration is optional — enable through /okr:oppsett for OKR tracking with score updates.

When Not to Use This

  • Private sector — governance model, examples, and cycle structure are built for Norwegian public sector
  • Individual performance reviews — OKR is a team tool; this plugin explicitly discourages individual OKR
  • Replacing workshops — start with people and post-its, come back with your first draft for quality-checking
  • Project management — OKR sets direction, it doesn't replace your backlog or Gantt chart

Limitations

  • Not tested in a real OKR cycle beyond the author's organization
  • Norwegian public sector context only
  • Linear is the only supported tracking integration

Version Commands Agents License

See CHANGELOG.md for version history. MIT License.