ki-produktivitetsmodell/CLAUDE.md
Kjell Tore Guttormsen 250d97a4dc docs: fjern godkjenningssporet fra palett-noten
«Godkjent av operatøren 18.08» er intern prosess-vokabular, som repoets
egen konvensjon forbyr på en publisert flate. Datoen går ikke tapt:
«(målt 2026-08-18)» står allerede i samme setning og bærer den. Selve
fargebegrunnelsen, HSL-målingen, er uendret.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C31r7kvUF6dM2i6HEPkrzH
2026-08-18 21:34:43 +02:00

76 lines
3.9 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
## 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)