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:
parent
e662196a75
commit
4d10a38d11
1 changed files with 58 additions and 15 deletions
75
README.md
75
README.md
|
|
@ -1,19 +1,46 @@
|
||||||
# OKR for Public Sector
|
# 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.
|
> **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.*
|
||||||
|
|
||||||

|

|
||||||

|

|
||||||

|

|
||||||

|

|
||||||

|

|
||||||

|

|
||||||

|

|
||||||
|
|
||||||
|
## 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
|
## 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
|
## Getting Started
|
||||||
|
|
||||||
### Install
|
Install first — see [Install](#install) at the top.
|
||||||
|
|
||||||
Add to your Claude Code plugin configuration:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"enabledPlugins": {
|
|
||||||
"okr@ktg-plugin-marketplace": true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### First Conversation
|
### 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 |
|
| Version | Date | Highlights |
|
||||||
|---------|------|------------|
|
|---------|------|------------|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue