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

@ -31,11 +31,14 @@ Avklar hvilken av tre ting det er. Spør med vanlige ord, og foreslå svaret nå
| Brukeren vil | Det er | Slik gjøres det |
|---|---|---|
| prøve andre verdier for parameterne, en annen styringsregel, beslutningsregel, sjokk eller tiltak | **et scenario**: ingen kode endres | ferdigheten `simuler` |
| legge til noe modellen ikke har (for eksempel et pådrag som varierer over tid, kø i et ledd til, målestøy) | **en utvidelse**: en ny mekanisme ved siden av kjernen, med et grensetilfelle som gjenskaper kjernen eksakt | trinn 2–7 |
| legge til noe modellen ikke har (for eksempel kø i et ledd til, målestøy, forskyvning mellom kategorier) | **en utvidelse**: en ny mekanisme ved siden av kjernen, med et grensetilfelle som gjenskaper kjernen eksakt | trinn 2–7 |
| endre ligningene modellen allerede har (en annen funksjonsform, en annen tilbakekobling) | **en endring i kjernen** | trinn 2–7 |
Mye som ser ut som en endring, er et scenario: alle kjernens parametere kan overstyres i en scenariofil (se
`${CLAUDE_PLUGIN_ROOT}/docs/scenarioformat.md`). Er det et scenario, si det og gå over til ferdigheten `simuler`.
`${CLAUDE_PLUGIN_ROOT}/docs/scenarioformat.md`), og et pådrag som varierer over tid finnes alt som utvidelsen
`paadrag_tidsserie`. Er det et scenario, si det og gå over til ferdigheten `simuler`. Unntaket er beslutningsreglene
for påtale og budsjett (`simulate_endo`) med en annen strøm av saker ved start, for eksempel mer effektivt politi:
den stopper scenariokjøreren, fordi regelen i kjernen bruker notatets startstrøm. Det er en endring i kjernen.
Kan mekanismen stå ved siden av kjernen, anbefal en utvidelse framfor å endre kjernen: notatets resultater ligger da
fast, og grensetilfellet viser at de gjør det.
@ -53,15 +56,18 @@ python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" ar
- På Windows heter tolken `python`. Bruk hele stien.
- Kopien har modellen, eksemplene, fasiten, testene, dokumentasjonen og en `LES-MEG.md`. Den trenger ikke numpy og
scipy for å lages.
- Finnes mappa og er ikke tom, nekter kommandoen (den skriver aldri over noe). Har brukeren en kopi fra før, bruk
den.
- Ferdighetene `diagnose`, `forlop` og `simuler` bruker kopien selv når arbeidsmappa har en `rettsstat-modell/`.
- Finnes mappa og er ikke tom, nekter kommandoen (den skriver aldri over noe). Den nekter også en mappe inne i
pluginen. Har brukeren en kopi fra før, kjør kontrollen på den (trinn 6) og si nivået før du bygger videre.
- Ferdighetene `diagnose`, `forlop` og `simuler` spør om de skal bruke kopien når arbeidsmappa har en
`rettsstat-modell/`, og sier hvilket nivå kontrollen gir den.
- `modell/kontroll.py` i kopien har notatets sjekksummer som faste verdier; det er dem kontrollen måler mot. Endre
den ikke: da sier kontrollen ikke lenger noe om notatet.
**Forskere som bruker git** kan i stedet klone pluginens repository (`https://git.fromaitochitta.com/open/dynamisk-rettsstat.git`),
endre der og starte Claude Code med pluginen fra klonen: `claude --plugin-dir .` i mappa. Da bruker ferdighetene
klonens modell direkte, og endringene kan sendes tilbake med `git format-patch`. Kontrollen vet ikke at en klone er
en arbeidskopi: ved «endret» sier den at pluginens modell skal regne som notatet, og kaller det en feil. For en
endring som er ment, er det en opplysning; si det til brukeren.
klonens modell direkte, og endringene kan sendes tilbake med `git format-patch`. En klone er ikke merket som
arbeidskopi, så ved «endret» sier kontrollen at det er en feil hvis det er pluginen slik den er installert, og en
opplysning hvis modellen er endret med vilje. Si til brukeren hvilket av de to det er.
## 3. Finn stedet i modellen
@ -96,7 +102,7 @@ Få et ja på dette før du skriver kode.
## 5. Gjør endringen
**En utvidelse.** Følg `${CLAUDE_PLUGIN_ROOT}/docs/utvidelser.md`: grensesnittet (`NAVN`, `BESKRIVELSE`,
`PARAMETERE`, `simuler`, `grensetilfelle`, og valgfritt `BRUKER` og `sjekk`), malen mellom `<!-- mal:start -->` og
`PARAMETERE`, `simuler`, `grensetilfelle`, og valgfritt `BRUKER`, `sjekk` og `GJENSKAPER_NOTATET`), malen mellom `<!-- mal:start -->` og
`<!-- mal:slutt -->` og trinnene der. Kort:
- Fila er `rettsstat-modell/modell/utvidelser/<navn>.py`, og `NAVN` er filnavnet uten `.py`.
- Kopier løkka fra simulatoren du bygger på uendret, og legg mekanismen inn slik at den forsvinner i grensetilfellet.
@ -104,6 +110,8 @@ Få et ja på dette før du skriver kode.
- Standardverdiene i `PARAMETERE` bør være grensetilfellet.
- `grensetilfelle()` kjører utvidelsen i grensetilfellet og kjernen med de samme forutsetningene, og returnerer
største absolutte avvik.
- Gjenskaper utvidelsen med standardverdiene en av notatets scenariofiler, oppgi dem i `GJENSKAPER_NOTATET`. Da
sjekker testene grensetilfellet også uavhengig av utvidelsens egen `grensetilfelle()`, mot notatets datafiler.
**En endring i kjernen.** Endre `rettsstat-modell/modell/kjerne/sim.py` (og kopiene i `diagnose.py` og `forlop.py`
når det trengs). Endre bare det hypotesen gjelder.
@ -121,15 +129,22 @@ Kjør kontrollen på kopien etter hver endring:
python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" --modell <hele stien til rettsstat-modell/modell> kontroll
```
- Den fulle kontrollen kjører hele notatets simulering og tar om lag ett til to minutter. Mens du prøver deg fram,
kan du legge til `--rask` (hopper over den fulle kjøringen); kjør den fulle før du sier hva endringen gjør.
- Kontrollen sammenligner med notatets resultater i `fasit/`: kjernens sjekksummer, utskriften fra diagnosen og
forløpet på begge eksempelfilene, de 22 datafilene og utskriften fra `sim.py`, og grensetilfellet i hver
utvidelse.
- Den fulle kontrollen kjører hele notatets simulering og tar et par minutter. Mens du prøver deg fram, kan du legge
til `--rask` (hopper over den fulle kjøringen av `sim.py`); kjør den fulle før du sier hva endringen gjør.
- Kontrollen måler mot notatets egne sjekksummer, som står fast i `modell/kontroll.py`, ikke mot filene i kopien.
Den har seks deler, nummerert slik i utskriften:
1. kjernen (`sim.py`, `diagnose.py`, `forlop.py`) og fasiten (27 filer) mot notatets sjekksummer;
2. diagnosen på begge eksempelfilene mot fasit, tegn for tegn;
3. forløpet på begge eksempelfilene mot fasit;
4. full kjøring av `sim.py`: de 22 datafilene og utskriften mot fasit (ikke med `--rask`);
5. grensetilfellet i hver utvidelse, som skal gi avvik eksakt `0.0`;
6. scenariokjøreren: notatets scenariofiler kjørt gjennom kopiens kjører, mot fasit (13 filer med `--rask`, 14 i
den fulle).
Exit-koder: **0** bit for bit eller innenfor toleranse, **1** endret, **2** feil bruk, **3** numpy eller scipy
mangler. Ved 3 er det som kunne kjøres uten dem, kjørt. Spør: «Kontrollen trenger to vanlige regnebiblioteker for
Python, numpy og scipy. Skal jeg installere dem i en egen mappe for denne pluginen?» Bare hvis svaret er ja:
mangler. Ved 3 er bare kjernen, fasiten og diagnosen kontrollert. Spør: «Kontrollen trenger to vanlige
regnebiblioteker for Python, numpy og scipy. Skal jeg installere dem i en egen mappe for denne pluginen?» Bare hvis
svaret er ja:
```
python3 "${CLAUDE_PLUGIN_ROOT}/modell/kjor.py" --data "${CLAUDE_PLUGIN_DATA}" miljo --opprett
@ -139,22 +154,25 @@ Gjengi det kommandoen sier, og kjør kontrollen på nytt.
**Les dommen for brukeren.** Den står i linja som begynner med «Nivå», nederst:
- **«bit for bit som notatet»**: endringen flytter ingen av notatets resultater. For en utvidelse er det det som skal
skje, og grensetilfellet er eksakt.
skje, og grensetilfellet er eksakt. Står det «(uten full kjøring, --rask)», er `sim.py` ikke kjørt i sin helhet; si
ikke at endringen er kontrollert før den fulle kontrollen er kjørt.
- **«innenfor toleranse»**: hvert tall avviker med høyst én enhet i siste viste siffer, som med andre versjoner av
numpy og scipy. Notatets resultater står.
- **«ingen avvik i det som ble kjørt (…). Ikke kontrollert: …»**: numpy eller scipy mangler. Si hva som ikke er
kontrollert, med kontrollens ord. Det er ikke en dom over endringen.
- **«endret: …»**: noe har flyttet seg. Si det rett ut, og si hva:
- hvilke datafiler som er endret, og største absolutte avvik per kolonne (står i detaljene). Bruk modellkartet,
del (d), til å si hvilken figur eller tabell i notatet hver datafil hører til;
- hvilke datafiler som er endret, og største absolutte avvik per kolonne (står i detaljene, under del 4 og 6).
Bruk modellkartet, del (d), til å si hvilken figur eller tabell i notatet hver datafil hører til;
- hvilke linjer i diagnosen, forløpet og utskriften fra `sim.py` som er endret (detaljene viser dem som «notatet» og
«nå»), med tallene slik de står;
- om kjernen er endret (punkt 1), og om et grensetilfelle ikke lenger er eksakt (punkt 5).
- om kjernen eller fasiten er endret (del 1). Er fasiten endret, sier sammenligningene mot den ingenting om
notatet.
En endret kjerne er en opplysning, ikke en feil: kontrollen sier det selv i en arbeidskopi. Men det skal sies
tydelig, og **brukeren avgjør om endringen var ment**. Var den ment, gå videre. Flytter en utvidelse notatets
resultater, eller er grensetilfellet ikke `0.0`, er noe galt i utvidelsen: finn feilen før du går videre.
Står det «uten full kjøring, --rask» eller «bare det som er kjørt» i nivålinja, gjelder dommen bare en del av
kontrollen. Si det, og si ikke at endringen er kontrollert før den fulle kontrollen er kjørt.
tydelig, og **brukeren avgjør om endringen var ment**. Var den ment, gå videre.
- **En utvidelse som ikke gjenskaper kjernen** (del 5: «… gjenskaper ikke kjernen i grensetilfellet. Det er en feil i
utvidelsen …»): det er en feil, også i en arbeidskopi, og resultatene utvidelsen gir, kan ikke brukes før den er
rettet. Finn feilen før du går videre.
Gjengi tallene fra kontrollen slik de står. Regn ikke ut egne avvik.