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