Kjell Tore Guttormsen
75bfc9b47d
Handoff catalog/docs/okf-second-brain/handoff-2026-06-29.md §3 (operator relay fra linkedin-studio-sesjonen). okr ratifiserer den delte konvensjonen (spec.md v0.1, katalog-eid single source of truth) etter ground-truth-verifisering: - okf-check.mjs-semantikken bekreftet = referansekontrakt (spec §3/§7): kun type paakrevd (okf-check.mjs:50), anbefalte felt -> warnings (:19,:55), okf_version-ekko uten auto-fetch (:36-41,:85). 91/55 linjer, zero npm-deps. - okr bruker resource (ikke source): alle emittere (okf-check RECOMMENDED, compose-org-profile:59, template:15, second-brain SKILL:56). Eneste source- treff er prosa, ikke felt. - Ingen feltgap: profil/config-noekler baeres som extension keys (spec §5). Adaptert: veivalg-doc + okf-note refererer naa spec-en (redefinerer ikke); premiss-korreksjonene (§2) kanonisert i spec §9. Delings-scope for evt. Stage-3-skill = okr + ms-ai-architect (ikke linkedin-studio). Ingen kode-/ versjonsendring (okr forblir 1.6.1); separat go for selve innboks-byggingen. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012HzGPGJ81k1BkUC6UvgX4Y
126 lines
9.5 KiB
Markdown
126 lines
9.5 KiB
Markdown
# Changelog
|
||
|
||
All notable changes to this project will be documented in this file.
|
||
|
||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||
|
||
## [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)
|