# 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)