docs: bring skills and docs in line with the fixed code

Skills ask before using a working copy found in the user's folder and state
its check level first. The drift of the queue models before the shock is
stated in the caveats and the README. README shows how to run the check and
the tests. The drift line names the month a gradual drive begins.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-11-11 15:46:39 +01:00
commit 19858bbda9
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
13 changed files with 314 additions and 113 deletions

View file

@ -8,23 +8,32 @@ Første versjon.
- Fire ferdigheter på norsk: `diagnose` (leddet som binder, tiltakstype og kapasitetsbehov fra egne tall), `forlop`
(stabilitetssjekk og forløp måned for måned), `simuler` (fra «hva om …» til scenariofil, kjøring, tabell og figur)
og `forbedre` (arbeidskopi, modellkart, utvidelser med grensetilfelle og kontroll av hva en endring flytter).
og `forbedre` (arbeidskopi, modellkart, utvidelser med grensetilfelle og kontroll av hva en endring flytter). Finnes
en egen versjon av modellen i brukerens mappe, spør ferdighetene før de bruker den, og sier hva kontrollen sier om
den.
- Modellen bak notatet *Den dynamiske rettsstaten*: `modell/kjerne/` har uendrede kopier av `sim.py`, `diagnose.py`
og `forlop.py` fra notatets repository ved commit 2badc25, låst med sha256 i `modell/kjerne/KILDE.json`.
og `forlop.py` fra notatets repository ved commit 2badc25.
- `modell/kjor.py`: én inngang for alle kommandoene (`diagnose`, `forlop`, `scenario`, `notatet`, `kontroll`,
`miljo`, `arbeidskopi`), bare standardbiblioteket. Den finner en Python med numpy og scipy, og installerer dem bare
i en egen mappe etter `miljo --opprett`.
- `kontroll`: sammenligner kjernen, diagnosen, forløpet og en full kjøring av notatets simulering med fasiten (22
datafiler og utskriftene), og sier om modellen regner bit for bit som notatet, innenfor toleranse eller er endret.
i en egen mappe etter `miljo --opprett`. Feltnavn den ikke kjenner i inndata til diagnosen og forløpet, stopper
regningen med et forslag til riktig navn.
- `kontroll`: måler kjernen og fasiten mot notatets egne sjekksummer, og sammenligner diagnosen, forløpet, en full
kjøring av notatets simulering (22 datafiler og utskriften), utvidelsenes grensetilfeller og scenariokjøreren med
fasiten. Sier om modellen regner bit for bit som notatet, innenfor toleranse eller er endret, og hva som ikke er
kontrollert når numpy eller scipy mangler.
- Scenariokjøreren med scenarioformat på norsk (`docs/scenarioformat.md`): alle fem simulatorene i kjernen,
overstyring av parameterne, beslutningsregler, sjokk, tiltak og sveip over én eller to parametere. Ut: sammendrag,
CSV per kjøring og `resultat.json` med alle parametere, versjoner og sjekksummer.
- 21 scenariofiler som gjenskaper 20 av notatets 22 datafiler (de to siste er analytiske), og fem scenarioer notatet
ikke har figur for.
overstyring av parameterne, beslutningsregler, sjokk, tiltak og sveip over én eller to parametere. Endres en
parameter som bestemmer utgangspunktet, stopper kjøringen, med mindre scenarioet sier om utgangspunktet skal
kalibreres på nytt eller kjøres fra ubalansen (`startlikevekt`). Ut: sammendrag, CSV per kjøring og
`resultat.json` med alle parametere, versjoner og sjekksummer.
- 21 scenariofiler som gjenskaper 20 av notatets 22 datafiler (de to siste er analytiske), og seks scenarioer notatet
ikke har figur for, blant dem en nullinje uten sjokk.
- Utvidelser ved siden av kjernen, med regelen fra notatet om et grensetilfelle som gjenskaper kjernen eksakt.
Gjennomført eksempel: `paadrag_tidsserie` (pådraget følger en tidsserie i stedet for ett varig sjokk). Mal i
`docs/utvidelser.md`.
- `arbeidskopi`: en kopi av modellen brukeren eier og kan endre, også kjernen.
- Dokumentasjon: inndata, scenarioformat, modellkart (ligning → funksjon → parameter), utvidelser og forbehold.
Eksempelfiler: stiliserte tall som gjenskaper avsnitt 9.5, og offentlige norske tall for 2025.
Forbeholdene sier blant annet at utgangspunktet i notatets modeller med kø i domstolen ikke er en eksakt likevekt,
og hvor mye modellen driver uten sjokk. Eksempelfiler: stiliserte tall som gjenskaper avsnitt 9.5, og offentlige
norske tall for 2025.
- `BIDRA.md`: hvordan en forbedring sendes tilbake.