ki-produktivitetsmodell/CLAUDE.md
Kjell Tore Guttormsen 3dc08e990e docs: legg til modell-kontekst.md som kontekstfil for KI-verktøy
Modellen v1.0 pakket som vedlegg til en KI-samtale: hele modellteksten
ordrett, med et orienteringslag foran som forteller assistenten hvordan
den skal brukes. Filen er forfattet i kilderepoet og kopiert hit ferdig.

Modellteksten er uendret og utgaven er fortsatt v1.0. Ingen ny tag.

Verifisering:
- sha256 identisk med kilden:
  9e7253fe2d306154477fdff8122e695f5c916ce44927d6c3492a6fbe731d71bf
- modelldelen diffet mot tre-nivaa-modell.md her: nøyaktig én avvikende
  blokk, figuren. Diff-metoden kjent-positiv-validert med en fabrikkert
  endring først (72 linjer utslag).
- navnegaten kjørt uavhengig her: 0 treff, 6 termer + 35 navn, alle tre
  søkeveier kjent-positiv-validert (6/6 og 35/35).
- spor-gaten over alle fire endrede filer, kjent-positiv-validert:
  0 treff i modell-kontekst.md, CHANGELOG.md og README.md. De to i
  CLAUDE.md er eksisterende linjer som definerer gaten selv, ikke nye.
- bredt sporsveip over samme fire filer: ingen id-er, ingen intern
  prosessreferanse. Alle treff er substrengen «ordre» inne i «ordrett».
- ingen em-dash, ingen en-dash, ingen SVG-markup i den nye filen.
- det publiserte modellarket er kontrollert mot kilderepoet og kom fra
  riktig v1.0-fil (c5d93bbfd205419584ff9ee0c3145e63bcc32946f5ce8b0858d231b56824c438).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FQLRLvjCn45RqpDPV35w1X
2026-08-18 23:13:49 +02:00

77 lines
4.1 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.
- 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)