docs(okr): README-foersteskjerm mot repo-standarden, 0 ERROR

Gaten (repo-standard 0.1.1, klasse `plugin`) fant 6 ERROR. Alle rettet:

- README-DESC: aapningslinjen var en markedsfoeringsblurb som ikke matchet
  noen annen flate. Erstattet med den kanoniske beskrivelsen, som na er
  identisk i forge, katalog, plugin.json og README - det eneste stedet en
  maskin kan sjekke at de fire er enige.
- INSTALL-NO-MARKETPLACE + INSTALL-NO-CLI: install-blokka var kun et
  `enabledPlugins`-JSON. En agent som far "installer denne" griper etter
  CLI-en og fant ingenting. Lagt til `marketplace add` + `plugin install`
  (https-formen; `marketplace add` avviser ssh:// med "Invalid git URL"),
  med JSON-formen beholdt som andre vei.
- HEADING-LEVEL: `### Install` under Getting Started -> `## Install` paa
  foersteskjermen. Fast toppnivaa-overskrift er det lesere og agenter
  skanner etter.
- HEADING-MISSING: nye `## Non-goals` (fem punkter, avledet av det koden
  faktisk gjoer: ikke sporingssystem, gjoer ikke virksomhetens
  vurderinger, avgjoer ikke arkivering, ikke flerbruker) og `## Changelog`
  (`## Version History` omdoept, med CHANGELOG-lenka loeftet foerst).

Utenom gate-funnene, samme flate:
- Doed lenke `../../README.md#ai-generated-code-disclosure` fjernet.
  Stien peker utenfor polyrepoet (`~/repos/README.md` finnes ikke) og
  ankeret finnes ingen steder. Foelger repo-standard/repo-mailbox: behold
  opplysningen, dropp lenka. Ryddet ogsaa gatens eneste SKIP.
- Badge-tellinger rettet mot disken: commands 14 -> 16, references
  17 -> 19 (agents 7 og hooks 3 stemte).

Staaende WARN, begge med vilje:
- LINK-INTERNAL-MISSING i tests/fixtures/okf-realistic/historikk/index.md
  er selve testdataen; dangling-lenka verifiseres av
  tests/syklus-rapport.test.mjs:239.
- README-H1 (`# OKR for Public Sector` vs `# okr`) er en navnebeslutning
  som tilhoerer operatoeren; skillen sier eksplisitt at gaten ikke avgjoer
  den.

Gaten: 6 ERROR -> 0 ERROR, 0 SKIP, 11 checks passed. Suite 314/314.
This commit is contained in:
Kjell Tore Guttormsen 2026-08-03 21:53:13 +02:00
commit 4d10a38d11

View file

@ -1,19 +1,46 @@
# OKR for Public Sector
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.
> Turn strategy into measurable goals. An AI coach that learns your organization, tracks progress across cycles, and guides you from first OKR to organizational mastery.
Turning a strategy document into goals teams actually work toward is the hard
part, and it is where most adoptions stall. This plugin is an AI coach for that
translation, built for the vocabulary the work already happens in: tertial
cycles, tildelingsbrev, mål- og resultatstyring, and the governance chain from
Stortingsmelding down to team OKR.
> **Solo-maintained, fork-and-own.** This plugin is a starting point, not a vendor product. Issues are welcome as signals; pull requests are not accepted. See [GOVERNANCE.md](GOVERNANCE.md) for the full model and what upstream provides.
*AI-generated: all code produced by Claude Code through dialog-driven development. [Full disclosure →](../../README.md#ai-generated-code-disclosure)*
*AI-generated: all code produced by Claude Code through dialog-driven development.*
![Version](https://img.shields.io/badge/version-1.8.2-blue)
![Platform](https://img.shields.io/badge/platform-Claude_Code_Plugin-purple)
![Agents](https://img.shields.io/badge/agents-7-orange)
![Commands](https://img.shields.io/badge/commands-14-blue)
![Commands](https://img.shields.io/badge/commands-16-blue)
![Hooks](https://img.shields.io/badge/hooks-3-green)
![References](https://img.shields.io/badge/references-17-yellow)
![References](https://img.shields.io/badge/references-19-yellow)
![License](https://img.shields.io/badge/license-MIT-lightgrey)
## Install
Use the `https://` form. The forge UI's clone button hands out an `ssh://` URL,
and `marketplace add` answers it with `Invalid git URL` — a message that never
mentions the protocol.
```bash
claude plugin marketplace add https://git.fromaitochitta.com/open/ktg-plugin-marketplace.git
claude plugin install okr@ktg-plugin-marketplace
```
Or enable it directly in `~/.claude/settings.json` — a working second path, not
a replacement for the two commands above:
```json
{ "enabledPlugins": { "okr@ktg-plugin-marketplace": true } }
```
Binary inbox formats (`docx`/`pdf`/`eml`) additionally need
`npm install --ignore-scripts` in the plugin directory; `txt`/`md` ingestion and
every other command run dependency-free.
---
## Why This Exists
@ -173,19 +200,33 @@ It does **not** own confidence, nor the assessment fields it reserves — the pe
---
## Non-goals
Things this plugin deliberately does not do, so you can tell early whether it fits:
- **It is not an OKR tracking system.** There is no database, no server and no
web UI. All state is Markdown files under `.claude/okr/` in your own project,
plus a machine-global org profile in `~/.claude/okr/org/`. Linear is the only
tracking integration, and it is optional.
- **It does not make the organization's assessments.** `/okr:rapport` owns the
arithmetic and the formatting invariants; the per-Objective evaluation of goal
attainment and the mapping to the letter of allocation's governance parameters
are left as marked placeholders. Confidence is a judgement, never derived from
score.
- **It does not decide archiving, and never deletes.** `/okr:arkivklar` produces
an assessment basis against bevaringsforskrifta — what should be *considered*
for transfer to the case/archive system. It is read-only by tool list.
- **It is not a multi-user collaboration tool.** One operator, local files, no
accounts, no shared state.
- **It does not replace the methodology literature.** The knowledge base is a
sourced working reference, not a substitute for Doerr, Wodtke or DFØ's own
guidance.
---
## Getting Started
### Install
Add to your Claude Code plugin configuration:
```json
{
"enabledPlugins": {
"okr@ktg-plugin-marketplace": true
}
}
```
Install first — see [Install](#install) at the top.
### First Conversation
@ -355,7 +396,9 @@ The plugin core is zero-dependency (`node:` builtins only). The inbox-ingestion
---
## Version History
## Changelog
Full detail in [CHANGELOG.md](CHANGELOG.md). Highlights:
| Version | Date | Highlights |
|---------|------|------------|