ki-produktivitetsmodell/CLAUDE.md
Kjell Tore Guttormsen aab3d04877 feat: foerste publiserte utgave av modellen, v0.13
Publiseringsrepo for «Tre nivaa av organisatorisk produktivitet med KI».
Opprettet paa operatoerens arbeidsordre 18.08.2026.

Modellen redigeres i kilderepoet og kopieres hit som ferdig utgave.
Kilderepoet er privat, uten remote, og skal aldri pushes: det inneholder
simuleringer og tilbakemeldinger som navngir virkelige personer, og
git-historikken beholder dem selv om filene slettes.

Lisens: CC BY 4.0, hentet fra creativecommons.org sin legalcode.txt og
ikke skrevet fra hukommelsen. Kontrollert: 3 treff paa «Attribution 4.0
International», 0 treff paa ShareAlike, NonCommercial og NoDerivatives.

Kontroller kjoert foer denne committen, hver med kjent-positiv validering
av spoerringen foerst:
- Navnelekkasje: 13 kandidat-egennavn hentet ut av de fem sensitive
  filene i kilderepoet, 0 av dem finnes i det som publiseres her.
- Interne spor: 0 treff paa «operatoer», «annotering», docs/-lenker og
  etatsnavn, i baade modellen, arket og README.
- Em-dash: 0 i alle flater, ogsaa i PDF-teksten.
- PDF: 6 sider, tre enige tellere, tellerne validert mot tre PDF-er med
  kjent sidetall foerst. Liggende A4 bekreftet.
- Figuren er byte-identisk i modellen og i arket.

STATE.md er gitignored fordi remoten er offentlig.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aNwyGgZNxiQ7E3VrTZX8t
2026-08-18 09:56:48 +02:00

73 lines
3.4 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`
## 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` og gråtoner. Ingen andre farger.
- `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:///Users/ktg/repos/ki-produktivitetsmodell/tre-nivaa-modell.md)
- [Modellarket](file:///Users/ktg/repos/ki-produktivitetsmodell/modellark.html)