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
|
||||
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.*
|
||||
|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||
|
||||
## 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 |
|
||||
|---------|------|------------|
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue