ki-produktivitetsmodell/CLAUDE.md
Kjell Tore Guttormsen 68de6fa05f
feat(modell): v1.1, modellrunden september 2026 speilet inn
Speiler modellteksten, kontekstfilen, modellarket og modellark-PDF-en som
v1.1 (2026-09-18). Alle fire er speilet eller ingen: de er verifisert
konsistente med hverandre i kilden, og enhver delmengde er det ikke.

Runden retter to termer som sto ute: KI-forordningen artikkel 25 gjoer
virksomheten til leverandoer, ikke tilbyder, og referansen er presisert til
forordning (EU) 2024/1689 som endret ved forordning (EU) 2026/1744.
Fire poster inn i modellen: kostnadskolonne i forsvarlighetstabellen, en
operasjonalisert arkivrad paa hjemler som er nye siden v1.0, personvernombud
og idriftsetter inn, og tre navngitte utfall paa nivaa 1.
Verifiseringsloggen gaar fra 35 til 48 rader.

Arket baerer runden. PDF-en er ni sider mot aatte; README-ens sidetall rettet.
Geometri og figur uroert.

Gater, hver validert kjent-positivt foerst: sha256 identisk med kilden for
alle fire; navnegate 0 treff over 10 maalinger paa 4 flater (6/6 termer,
35/35 navn, tre kjent-positive veier); versjonssync v1.1 med 0 rester av
v1.0 og 0 av 2026-08-18; em-dash 0 i fem filer mot 14 i kontrollen;
sidetall 9 med tre uavhengige tellere, validert mot den gamle PDF-ens 8;
lisenstype 0 treff i PDF-ens tekstlag og metadata mot 20 i kontrollen;
tilbyder 3 -> 0 og leverandoer 4 -> 8 i PDF-ens tekstlag.

To funn fra gatene er IKKE rettet her, fordi de eies av kilden. De er
bokfoert som invarianter i CLAUDE.md: verifiseringsloggen navngir en intern
arbeidsfil i kilderepoet med sti, og den nye arkgenerasjonen mangler
skjermlaget som ble lagt inn her i 044e0e4.

Ikke pushet. Publisering venter paa operatoeren.

[skip-docs] Doksgaten maaler README-diffens stoerrelse. README var usann paa
noeyaktig ett punkt, sidetallet, og det er rettet. Utgavens dokumentasjon bor
i CHANGELOG.md (24 nye linjer), som gaten ikke teller, og CLAUDE.md har faatt
to nye invarianter fra gate-funnene.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 02:02:03 +02:00

80 lines
5 KiB
Markdown

# ki-produktivitetsmodell
## Kontekst
Publiseringsrepo for dokumentmodellen «Tre nivå av organisatorisk produktivitet med KI». **Dette repoet er offentlig.** Alt som ligger her, er lest av hvem som helst.
Kilderepoet er `~/repos/ki-leadership`, som er **privat, uten remote, og aldri skal pushes** — det inneholder simuleringer og tilbakemeldinger som navngir virkelige personer. Redigering av modellen skjer der. Dette repoet mottar ferdige utgaver.
## Stack
Ren dokumentasjon. Ingen byggekjede, ingen avhengigheter.
- `tre-nivaa-modell.md` — modellen, kanonisk tekst
- `modellark.html` — selvstendig HTML for utskrift. Inline SVG, ingen eksterne filer, ingen base64
- `modellark.pdf` — bygget fra HTML-en med Chrome headless `--print-to-pdf`
- `presentasjon.pdf` — presentasjonen, 21 sider liggende 16:9. Bygget i kilderepoet og kopiert hit ferdig; bygges aldri her
- `modell-kontekst.md` — kontekstfil for KI-verktøy: modellteksten ordrett med et orienteringslag foran, figuren som Mermaid i stedet for SVG. Forfattet i kilderepoet og kopiert hit ferdig; redigeres aldri her
## Konvensjoner
- **Tall-disiplin:** ingen tall uten verifisert kilde, primærkilde leses selv, anslag merkes eksplisitt. Verifiseringsloggen bakerst i modellen er en del av leveransen, ikke et vedlegg.
- **Ingen em-dash** noe sted i modellen eller arket.
- **Ingen navngiving av enkeltvirksomheter som forbilde.** Verktøy og skyplattformer kan navngis som anskaffelsesvirkelighet og klasse-eksempler.
- **Ingen interne arbeidsspor:** ingen referanser til annoteringsrunder, interne arbeidsfiler eller intern prosess-vokabular. Dette er et publisert dokument, ikke en arbeidslogg.
- **Ingen personnavn** utover siterte kilders forfattere.
- Palett i figuren: `#444F55`, `#E27500`, `#D6E0E4` og gråtoner. Ingen andre farger.
- `#D6E0E4` kom inn i v1.0 (plattform- og kompetanselaget). Den er en lysnet tone av `#444F55`, samme fargefamilie: HSL-hue 197° mot 201°, kun lysheten endret fra 30 % til 87 % (målt 2026-08-18). Navngitt eksplisitt, ikke beskrevet som «avledet av», slik at linja fortsatt er grep-bar mot en fremtidig, ubesluttet farge.
- `#f1f3f4`, i bruk siden v0.13, er ikke en ren gråtone (R/G/B ulik med 3), men lest som gråtone her fordi avviket er visuelt neglisjerbart.
- `aria-label` og annen tekst for skjermlesere skrives i vanlig norsk med æøå.
## Kommandoer
Bygg PDF på nytt fra arket:
```bash
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
--headless --disable-gpu --no-pdf-header-footer \
--print-to-pdf=modellark.pdf \
"file://$(pwd)/modellark.html"
```
Kontroller sidetallet med tre uavhengige tellere, og valider dem mot en PDF med kjent sidetall før du stoler på dem:
```bash
pdfinfo modellark.pdf | grep -E '^Pages|^Page size'
python3 -c "from pypdf import PdfReader; print(len(PdfReader('modellark.pdf').pages))"
```
Visuell kontroll av hver side:
```bash
pdftoppm -jpeg -r 90 modellark.pdf side
```
## Arbeidsflyt
- **Ingen redigering av modellteksten her.** Endringer gjøres i kilderepoet og kopieres hit som ferdig utgave. Ellers oppstår to sannheter.
- **En lokal fiks i en speilet fil overlever ikke neste utgave.** Speiling overskriver hele filen, så alt som bare finnes her, forsvinner uten varsel. Blir en speilet fil rettet her likevel, skal rettelsen samme dag tilbake til kilderepoet, ellers tapes den. Målt 2026-09-18: skjermlaget i `modellark.html`, lagt inn her i `044e0e4`, fantes ikke i kilden og forsvant da arket ble speilet på nytt.
- **Før speiling: ta vare på den gamle filen** (`git show HEAD:<fil>`), og bruk den som kjent-positiv kontroll for hver gate du kjører på den nye. En gate uten nevner er ikke en måling.
- Hver publiserte utgave får en git-tag (`v0.13`, `v0.14`, ...) og en linje i `CHANGELOG.md`.
- Før push: kontroller at ingen intern referanse har fulgt med. `grep -ci 'operatør\|annotering' tre-nivaa-modell.md modellark.html` skal gi 0 for begge. Valider spørringen mot et kjent-positivt tilfelle før du stoler på nullen.
- **Samme sveip skal også fange stier inn i kilderepoet.** Kildehenvisninger i verifiseringsloggen kan navngi interne arbeidsfiler som aldri publiseres her. `grep -n 'docs/' tre-nivaa-modell.md modell-kontekst.md` skal gi 0; treff er kilderepoets rettelse, ikke vår.
- `STATE.md` er gitignored her, fordi remoten er offentlig.
## Communication patterns
### Linking to local files
When pointing to local files in responses, always use markdown link syntax with a descriptive name:
- Use `[Human-friendly name](file:///absolute/path)` — never bare `file:///...` URLs or autolinks `<file://...>`.
- Always use absolute paths. Never `~/` or relative paths.
- For multiple files, render as a bullet list of named markdown links.
Why: bare `file://` URLs only render the first as clickable across multiple lines. Named markdown links make each entry independently clickable and look cleaner.
Example:
- [Modellen](file:///absolute/path/to/tre-nivaa-modell.md)
- [Modellarket](file:///absolute/path/to/modellark.html)