ki-produktivitetsmodell/CLAUDE.md

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:

"/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:

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:

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
• Modellarket