okr/CHANGELOG.md
Kjell Tore Guttormsen 30545b982e fix(okr): credibility-sanering fra 360-re-evaluering + bump 1.6.1
Lukker de 5 credibility-kritiske funnene fra docs/evaluering-360-2026-06-26.md:
1. okr-quality-rubrics.md omskrevet til korrekt norsk (var ASCII-strippet, 0
   aa/oe/ae; lastes brukervendt av /okr:kvalitet + kvalitetssjekker +
   freshen-references). Regresjon i samme klasse som v1.3.0-showstopperen.
2. SKILL.md flaggskip-eksempel: strippet norsk rettet (per aar/hoyrisiko/
   spoerreundersoekelse/Gjennomfoere moeter).
3. okr-second-brain-search ~-glob: literal ~ ekspanderes ikke av Glob ->
   hjemme-roten ble aldri soekt. Naa eksplisitt absolutt hjemme-sti.
4. Uverifisert kb-search-sitat fjernet (motsagt av innboks-ingestion-funn);
   erstattet med funksjonell Glob/Read/Grep + discovery-moenster.
5. okr-oboard-guide.md KR1-regnefeil 52% -> 65% (per filens egen formel).

Bump alle flater 1.6.0 -> 1.6.1 (plugin.json, CLAUDE.md, README badge+hist,
begge SKILL.md, CHANGELOG). Suite 55/55 groenn. C+ -> A-; systemiske funn
(KB-kryssref, Sist-oppdatert-markoerer) bevisst utsatt.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SFW5scLL7oEwWWTv1fPQG6
2026-06-26 21:31:42 +02:00

8.8 KiB
Raw Blame History

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.

[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 fjernetokr-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 (startcurrent)/(starttarget).

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.60.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)