docs(okr): update to v1.1.0 — badges at top, persistent context features, marketplace listing
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen
parent
3354c73467
commit
7a378cfde9
3 changed files with 82 additions and 33 deletions
18
README.md
18
README.md
|
|
@ -123,20 +123,22 @@ Key commands: `/linkedin:onboarding`, `/linkedin:post`, `/linkedin:quick`, `/lin
|
|||
|
||||
---
|
||||
|
||||
### [OKR for Public Sector](plugins/okr/) `v1.0.0`
|
||||
### [OKR for Public Sector](plugins/okr/) `v1.1.0`
|
||||
|
||||
OKR methodology for Norwegian public sector organizations.
|
||||
Your AI-powered OKR coach for Norwegian public sector — not just methodology, but a partner that learns your organization.
|
||||
|
||||
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. The plugin covers methodology (Doerr), governance (Riksrevisjonen compliance), and facilitation (5 meeting types with complete agendas).
|
||||
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.1 transforms the plugin from a methodology library into a personalized coach with persistent organizational context.
|
||||
|
||||
- **Tildelingsbrev analysis** — Opus-powered agent classifies each requirement as Committed OKR, Aspirational OKR, KPI-only, or ignore, with coverage matrix and gap detection
|
||||
- **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.
|
||||
- **Tildelingsbrev analysis** — Opus-powered agent classifies each requirement as Committed OKR, Aspirational OKR, KPI-only, or ignore. Auto-reads stored documents.
|
||||
- **Antipattern detection** — 19 named failure modes (sandbagging, quarterly theater, goalpost moving, OKR-shaming) across formuleringsfeil, prosessfeil, kulturfeil, strukturfeil, ledelsesfeil
|
||||
- **Cascade visualization** — trace alignment from national policy to team Objectives, surface gaps between levels
|
||||
- **CFR facilitation** — Conversations, Feedback, Recognition methodology where public sector's no-bonus structure becomes an advantage, not a constraint
|
||||
- **Cycle archival** — end-of-cycle workflow generates retrospective with scoring analysis, archives to historikk, and rolls forward to next cycle
|
||||
- **CFR facilitation** — Conversations, Feedback, Recognition methodology where public sector's no-bonus structure becomes an advantage
|
||||
|
||||
Key commands: `/okr:skriv`, `/okr:kvalitet`, `/okr:governance`, `/okr:kaskade`, `/okr:møter`, `/okr:sporing`
|
||||
Key commands: `/okr:oppsett`, `/okr:skriv`, `/okr:kvalitet`, `/okr:governance`, `/okr:kaskade`, `/okr:sporing`
|
||||
|
||||
5 specialized agents · 8 commands · 3 hooks · 15 reference docs
|
||||
5 specialized agents · 8 commands · 3 hooks · 16 reference docs
|
||||
|
||||
→ [Full documentation](plugins/okr/README.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "okr",
|
||||
"version": "1.0.0",
|
||||
"version": "1.1.0",
|
||||
"description": "Expert OKR guidance for Norwegian public sector. Write, review, cascade, track and govern OKR based on Google/Doerr methodology adapted for 4-month tertial cycles.",
|
||||
"author": {
|
||||
"name": "Kjell Tore Guttormsen"
|
||||
|
|
|
|||
|
|
@ -1,9 +1,16 @@
|
|||
# OKR for Public Sector
|
||||
|
||||
> Expert OKR guidance tailored for Norwegian public sector organizations.
|
||||
> Your AI-powered OKR coach for Norwegian public sector — not just a methodology library, but a partner that learns your organization, your challenges, and your current OKRs.
|
||||
|
||||
*Solo project — bug reports welcome, PRs not accepted.*
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## The Problem
|
||||
|
||||
Your organization has a strategy. Turning it into OKR that actually drive change is where it gets hard. Teams write Key Results that are just task lists. "Gjennomføre 5 kurs" is not a result — it's an activity. Tertial cycles don't match the quarterly model from Google. And nobody can trace the line from strategic intent through OKR down to what teams actually deliver.
|
||||
|
|
@ -14,17 +21,50 @@ Most OKR resources assume you're a startup. You're not. You have political steer
|
|||
|
||||
## 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.
|
||||
The plugin starts by learning your context. This is what transforms generic OKR advice into guidance that fits your organization.
|
||||
|
||||
`/okr:oppsett` runs an interactive interview that captures:
|
||||
`/okr:oppsett full` runs a structured 28-question interview across six phases:
|
||||
|
||||
- **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 strategy** — virksomhetsplan, strategic priorities, tildelingsbrev goals
|
||||
- **Your tools** — Linear integration, meeting tools, delivery methodology
|
||||
| Phase | Duration | What the Plugin Learns |
|
||||
|-------|----------|----------------------|
|
||||
| 1. Identity | 2 min | Organization type, ministry, domain, geography, size |
|
||||
| 2. Maturity | 5 min | OKR history, sponsor/champion, salary decoupling, alignment approach |
|
||||
| 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, Linear integration |
|
||||
| 6. Culture | 3 min | Check-in rhythm, psychological safety, known antipatterns, union involvement |
|
||||
|
||||
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 priorities are.
|
||||
Don't have 20 minutes? `/okr:oppsett mvp` asks 6 questions and gets you 80% of the value in under 5 minutes.
|
||||
|
||||
The interview is **interruptible** — quit mid-session and it picks up where you left off next time.
|
||||
|
||||
Everything is saved locally as a persistent organizational profile and automatically injected into every conversation. After onboarding, every command knows who you are, what cycle you're in, and what your strategic priorities are — without you repeating anything.
|
||||
|
||||
### Persistent Context
|
||||
|
||||
The plugin maintains a structured context tree in your project:
|
||||
|
||||
```
|
||||
.claude/
|
||||
okr.local.md # Expanded organizational profile
|
||||
okr/
|
||||
strategisk-kontekst/ # Your strategic documents
|
||||
tildelingsbrev-2026.md # Key mandate goals (stored during onboarding)
|
||||
overordnede-okr.md # Org-level OKR for alignment checking
|
||||
syklus/
|
||||
T1-2026/ # Active cycle
|
||||
okr-digitalt-team.md # Team OKR files
|
||||
status.md # Confidence levels and blockers
|
||||
historikk/ # Archived cycles with retrospectives
|
||||
```
|
||||
|
||||
Place your tildelingsbrev in `strategisk-kontekst/` once, and `/okr:governance` starts gap analysis without asking you to paste anything. Store your org-level OKR, and `/okr:kvalitet` checks team-OKR alignment automatically.
|
||||
|
||||
### 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 kills stretch goals, breeds sandbagging, and undermines the entire methodology. The plugin won't let you ignore this.
|
||||
|
||||
## Bring What You Have
|
||||
|
||||
|
|
@ -130,23 +170,35 @@ Then run `/okr:oppsett` — it takes 5–15 minutes and unlocks everything else.
|
|||
|
||||
| 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` | Analyze tildelingsbrev, ensure Riksrevisjon-ready documentation |
|
||||
| `/okr:innføring` | Plan OKR rollout, handle resistance, assess maturity |
|
||||
| `/okr:oppsett` | Onboarding interview (`full`/`mvp`), profile management (`oppdater`/`vis`), cycle archival (`arkiver`) |
|
||||
| `/okr:skriv` | Write new OKR — guided from vague idea to scored, aligned output. Auto-reads strategic context. |
|
||||
| `/okr:kvalitet` | Score existing OKR, detect 19 antipatterns, check alignment vs. stored org-OKR |
|
||||
| `/okr:kaskade` | Cascade from organization to team. Auto-reads org-OKR for alignment mapping. |
|
||||
| `/okr:sporing` | Track progress (0.0-1.0). Auto-loads OKR from `.claude/okr/syklus/`. |
|
||||
| `/okr:moter` | Generate agendas for workshops, check-ins, reviews, and 1:1s |
|
||||
| `/okr:governance` | Auto-reads stored tildelingsbrev. Gap analysis, Riksrevisjon-ready documentation. |
|
||||
| `/okr:innforing` | Rollout planning adapted to your known maturity level. Union involvement guidance. |
|
||||
|
||||
### End of Cycle
|
||||
|
||||
When a cycle ends, `/okr:oppsett arkiver` handles the full transition:
|
||||
|
||||
1. Collects final scores for all KR
|
||||
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
|
||||
|
||||
## Public Sector Governance
|
||||
|
||||
| Framework | What the plugin does |
|
||||
|-----------|---------------------|
|
||||
| Tildelingsbrev | Parse requirements, separate OKR candidates from KPIs and compliance |
|
||||
| Tildelingsbrev | Parse requirements, separate OKR candidates from KPIs and compliance. Store once, reference automatically. |
|
||||
| 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 |
|
||||
| DFO terminology | Mapping between maal- og resultatstyring and OKR concepts |
|
||||
| Tillitsvalgte | Guidance on union involvement — Hovedavtalen, droftingsplikt, transparent KR |
|
||||
|
||||
## Under the Hood
|
||||
|
||||
|
|
@ -169,9 +221,4 @@ Tracking integration is optional. The plugin has built-in support for Linear, an
|
|||
|
||||
---
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
See [CHANGELOG.md](CHANGELOG.md) for version history. [MIT License](LICENSE).
|
||||
See [CHANGELOG.md](CHANGELOG.md) for version history. [ROADMAP.md](ROADMAP.md) for what's next. [MIT License](LICENSE).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue