okr/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Changed

• OKF second-brain spec v0.1 ratifisert (cross-plugin koordinering) — den delte konvensjonen er kanonisert i catalog/docs/okf-second-brain/spec.md (katalog-eid, single source of truth). okr ratifiserer den per handoff §3/§4: okf-check.mjs-semantikken (kun type påkrevd; anbefalte felt → advarsler; okf_version-ekko) står som referansekontrakt (spec §7); okr bruker resource (ikke source); ingen feltgap (profil/config-nøkler bæres som extension keys, spec §5). Innboks-ingestion-planen (docs/innboks-ingestion-veivalg-2026-06.md) bygger nå mot spec-en; delings-scope for en eventuell Stage-3-skill = okr + ms-ai-architect (ikke linkedin-studio). Ingen kode- eller versjonsendring.

[1.6.1] - 2026-06-26

Fixed

• okr-quality-rubrics.md omskrevet til korrekt norsk — den ankrede kvalitetsrubrikken var fullstendig ASCII-strippet (0 å/ø/æ) til tross for at den lastes brukervendt av /okr:kvalitet, kvalitetssjekker-agenten og /okr:freshen-references. Samme tekstkvalitetsklasse som 360-en flagget KRITISK i v1.3.0 — en regresjon innført med selve rubrikk-fila.
• SKILL.md flaggskip-eksempel — strippet norsk i det første konkrete OKR-eksemplet (per år / høyrisiko / spørreundersøkelse / Gjennomføre møter).
• okr-second-brain-search ~-glob — retrieval-instruksjonen brukte literal ~/.claude/okr/org/, som Glob-verktøyet ikke ekspanderer → hjemme-roten (org-identitet) ble stilltiende aldri søkt, mot skillens eget «search both roots»-premiss. Nå eksplisitt absolutt hjemme-sti.
• Uverifisert kb-search-sitat fjernet — okr-second-brain-search hevdet en OKF kb-search-triad som ikke finnes (motsagt av docs/innboks-ingestion-funn-2026-06.md); erstattet med funksjonell Glob/Read/Grep-beskrivelse + discovery-mønsteret.
• Regnefeil i okr-oboard-guide.md — KR1-progresjon viste 52 %; korrekt er 65 % per filens egen formel (start−current)/(start−target).

Notes

• Patch utløst av docs/evaluering-360-2026-06-26.md (360-re-evaluering på v1.6.0): C+ → A−. Systemiske funn (KB-kryssreferanser, «Sist oppdatert»-markører) er bevisst utsatt.

[1.6.0] - 2026-06-26

Added

• okr-second-brain-search-skill — on-demand retrieval over en OKF-kompatibel markdown-wiki (.claude/okr/ prosjekt + ~/.claude/okr/org/ home) via native Glob/Read/Grep, i fri chat OG under /okr:*-kommandoer. Semantisk dekomponering med opptil 3 query-variasjoner; ingen for-injeksjon av alt innhold.
• OKF-frontmatter på alle kontekstfiler — org-profil (type: Organisasjonsprofil) og tre-skrivere (type: Tildelingsbrev/Virksomhetsplan/Overordnede OKR/OKR/Retrospektiv/Status) emitterer ekte OKF-schema (Title-Case type + resource/title/description/tags/timestamp).
• scripts/okf-index.mjs — genererer index.md per nivå (verbatim OKF-format * [title](link) - description) per bundle-rot.
• scripts/okf-check.mjs — validerer at hver konsept-fil bærer type:; rapporterer okf_version per rot.
• scripts/compose-org-profile.mjs — bygger nestet org-profil-YAML med top-level OKF-nøkler før pipe til write-org-profile.mjs.
• lib/frontmatter.mjs — delt frontmatter-parser/skriver; konsoliderer duplisert parse-logikk i begge hooks og fikser comment-leak på usiterte verdier.

Changed

• inject-okr-context.mjs splittet — for-injiserer ikke lenger hele kontekstfil-enumerasjonen; emitterer kjerne-profil + én resolvert peker til index.md (< 512 B, uavhengig av filantall). Retrieval skjer on-demand via skill.
• /okr:analyse leser historikk/ direkte (Glob/Read) etter hook-splitten.
• Begge hooks ruter frontmatter-parsing gjennom delt lib/frontmatter.mjs.

[1.5.0] - 2026-06-26

Added

• /okr:help — full oversikt over alle kommandoer (13), agenter (7) og anbefalt syklusarbeidsflyt.
• /okr:export — eksporter OKR-leveranser (kvalitetsvurdering, gap-matrise, statusrapport, retrospektiv) til print-klar PDF via scripts/export-pdf.py (weasyprint).
• /okr:freshen-references — KB-selvevaluator: scorer de 16 referansefilene mot en ankret dekning-/kvalitet-rubrikk og currency-poller offentlige kilder.
• Ankret kvalitetsrubrikk (references/okr-quality-rubrics.md, 10 dimensjoner × 5 forankrede nivåer) wiret inn i /okr:kvalitet, kvalitetssjekker-agenten og SKILL.md.
• Atomisk org-profil-skriving: scripts/write-org-profile.mjs skriver maskin-global org-identitet til ~/.claude/okr/org/profil.md (temp + renameSync), med circuit-breaker til prosjekt-lokal .claude/okr.local.md ved hjem-skrivefeil. Fullfører hybrid org-kontekst (skrive-sti) startet i 1.4.0.
• Node-test-dekning: nye fixturer for org-profil-skriving, coaching-hookens fase-deteksjon og UserPromptSubmit emne-guard (17 tester totalt, grønn).

Changed

• Metrics-library utvidet med verifiserte kryss-sektor offentlig-metrikker (EGDI m.fl., kildebelagt; udokumentert eForvaltningsindeks fjernet).
• Coaching-hook fikk en klokke-seam for testbar fase-deteksjon (early/mid/late).
• UserPromptSubmit emne-guard: injiserer kun OKR-kontekst på relevante prompts (tvil → injiser).

[1.4.0] - 2026-06-24

Added

• Fase 1 — Domenedybde og kildeintegritet: tertial-korreksjon (DFØ interim-/årsrapport-regime), OKR posisjonert som lag oppå mål- og resultatstyring (økonomireglementet §4), tillitsreform-seksjon, «målforskyvning» som norsk antipattern, reelle norske offentlig-sektor-referanser (Digdir/Oslo/Ruter/Knowit) med proveniens.
• Fase 2 — UX-koherens og kommando-/agent-modning: Kontekstbevissthet-blokk i /okr:møter (9/10 kommandoer; oppsett bevisst unntatt), /okr:gap vs /okr:governance disambiguert, negative triggere + direkte org-lesing i alle 7 agenter, 6 referansefiler wiret inn ved bruksstedet, template↔onboarding skjema-paritet.
• Hybrid org-kontekst-lesing (lese-sti): inject-okr-context.mjs resolverer prosjekt-lokal .claude/okr.local.md → maskin-global ~/.claude/okr/org/profil.md (mest-spesifikk-vinner; forward-compat, migrasjon kommer i Fase 3). node:test-fixtur for hooken.

Changed

• Metodikk-presisjoner (Intel/Locke-fakta, committed+aspirational ikke snittet sammen), «Kvartalsreview» → «Syklusreview».

[1.3.2] - 2026-06-24

Fixed

• Fjernet loopende Stop-hook (type prompt → enhver output blokkerte stop → re-invoke-loop).

[1.3.1] - 2026-06-23

Fixed

• Fakta- og troverdighetssanering: scoringsterskel harmonisert (0.6–0.7, Google/Doerr), fiktiv eksempeletat merket, find-replace-artefakter rettet, UTF-8/ASCII-korreksjoner, døde lenker fjernet.

[1.3.0] - 2026-04-08

Added

• Command /okr:gap: Automatic gap analysis between tildelingsbrev requirements and current OKR with coverage matrix
• Command /okr:analyse: Cross-cycle analytics with Mermaid trend visualizations (score trends, antipattern frequency, alignment)
• Agent gapanalytiker: Sonnet agent for tildelingsbrev coverage analysis
• Agent trendanalytiker: Sonnet agent for cross-cycle pattern analysis with Mermaid output
• Hook SessionStart: Proactive coaching based on cycle timeline position, at-risk KR detection, and previous cycle learnings
• Hook extension: inject-okr-context.mjs now reports archived cycle count from historikk/

Changed

• Version bumped from 1.1.0 to 1.3.0

[1.0.0] - 2026-04-08

Changed

• Architecture: Commands rewritten as self-contained handlers with embedded domain logic (previously routed to external prompt files)
• Agent models: 4 agents downgraded from opus to sonnet (kvalitetssjekker, kaskadebygger, fremdriftssporer, møtefasilitator); styringsrådgiver remains opus
• State management: Configuration moved from okr.local.md in plugin root to .claude/okr.local.md in project directory
• References consolidated: All reference material now in single references/ directory (15 files)
• Plugin.json: Added license, repository, keywords for marketplace readiness

Added

• Hooks: UserPromptSubmit (context injection), PreCompact (state preservation), Stop (session reminder)
• Agent examples: All 5 agents have <example> blocks in description for better triggering
• Plugin.json metadata: license, repository, keywords fields

Removed

• Prompt pack: 19 standalone prompt files (absorbed into commands and agents)
• Assets directory: Content moved to references/ or deleted
• assets/okr-template-powerpoint.md (described non-existent PPTX)
• assets/start-her.md (prompt pack getting started guide)

Fixed

• CLAUDE.md: Corrected agent model tiers, removed stale file references
• SKILL.md: Removed prompt pack section, updated resource paths
• SECURITY.md: Fixed version table, corrected config file path
• Agent path references: assets/ to references/

[0.5.0] - 2026-02-07

Note

First formal version. Previously unversioned. This plugin has never been used in a real OKR cycle.

What exists today

• 5 intelligent agents
• Linear integration for OKR tracking
• Norwegian public sector context (4-month tertial cycles)
• Based on Google OKR / John Doerr methodology
• CFR (Conversations, Feedback, Recognition) framework
• Examples from transport, roads, and digital services domains
• Cascading support (organization -> division -> team)