Kjell Tore Guttormsen
03151cfb3b
scenario.py runs all five simulators of the core from a JSON scenario file, with sweeps, and reproduces 20 of the note's data files (14 byte for byte, 6 column-wise). Extensions live outside the core and must reproduce it exactly in a limit case; paadrag_tidsserie is the worked example. arbeidskopi.py gives the user a copy of the model they can change. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
58 lines
4.4 KiB
Markdown
58 lines
4.4 KiB
Markdown
# dynamisk-rettsstat
|
|
|
|
This file is for development sessions in this repo. It is not loaded as plugin context, and `claude plugin validate`
|
|
warns about a `CLAUDE.md` in the plugin root; that warning is expected.
|
|
|
|
## Context
|
|
A Claude plugin (Claude Code and Cowork) that runs the model behind the concept note *Den dynamiske rettsstaten* on the
|
|
user's own numbers: find the binding link in the criminal justice chain (`diagnose`), follow the measure over time
|
|
(`forlop`), run scenarios (`simuler`) and change the model (`forbedre`). Users are Norwegian: people working in the
|
|
justice chain (mostly non-programmers) and researchers. The note and its code live in
|
|
`~/repos/den-dynamiske-rettsstaten` (read-only from here). Open, non-commercial; nothing here is for sale.
|
|
|
|
## Stack
|
|
- Skills only: `skills/<name>/SKILL.md`. No hooks, no MCP servers, no mod, no top-level `bin/` (Cowork refuses a plugin
|
|
with one).
|
|
- `modell/kjor.py`: the single entry point, Python 3.9+ standard library only. Finds a Python with numpy and scipy for
|
|
the commands that need them; installs nothing unless `miljo --opprett` is run.
|
|
- `modell/kjerne/`: `sim.py`, `diagnose.py`, `forlop.py`, unmodified copies from the note's repo, pinned by sha256 in
|
|
`modell/kjerne/KILDE.json`. numpy and scipy pinned in `modell/requirements.txt` (as the note).
|
|
- `fasit/`: reference output (22 data files, printouts) that `kontroll` compares against.
|
|
- `docs/`: `inndata.md`, `modellkart.md`, `forbehold.md` (and later `scenarioformat.md`, `utvidelser.md`), Norwegian.
|
|
- `eksempler/`: `eksempel_domstol.json` (stylized), `norge_2025.json` (public Norwegian figures).
|
|
|
|
## Conventions
|
|
- **Never edit `modell/kjerne/`.** It is synced from the note's repo: copy the three files at a given commit, update
|
|
the commit and sha256 values in `KILDE.json`, rebuild `fasit/` and run `kontroll`. A test fails if a file does not
|
|
match its sha256. No lint on the core. Changes to the model go in `modell/utvidelser/` or in a user's working copy.
|
|
- User-facing text (skills, docs, script messages) is Norwegian bokmål, plain and direct, with the note's terms (ledd,
|
|
skranke, restanse, utnyttelse, saksbehandlingstid, ledet utenom, den koordinerte regelen). Code, comments and this
|
|
file may be English.
|
|
- Facts in docs and skills are read from the code or the note, never from memory. Where they differ, the code wins.
|
|
- The note's core sentence is quoted verbatim: «Innsatsen for å håndheve lover og regler bør løpende stå i forhold til
|
|
hvor mye, og hvor alvorlig, de faktisk brytes.» Short form: «Straffebud og strafferammer ligger fast.»
|
|
- Skill frontmatter has only `name` and `description` (other keys make claude.ai reject an uploaded skill).
|
|
- `${CLAUDE_PLUGIN_ROOT}` and `${CLAUDE_PLUGIN_DATA}` are substituted in skill text, but they are not environment
|
|
variables in Bash. Skills write them literally into the command; `kjor.py` treats an empty `--data` or one containing
|
|
`${` as not given and falls back to `~/.dynamisk-rettsstat`.
|
|
- Skills never invent numbers, show the numbers as understood before computing, divide yearly figures by 12 and say
|
|
so, relay script numbers verbatim, carry the caveats, and never install anything without asking.
|
|
- Exit codes of `kjor.py`: 0 ok, 1 differences found by `kontroll`, 2 input or usage error (a core `sys.exit("...")`
|
|
passes through as 2 with the message unchanged), 3 numpy/scipy missing.
|
|
|
|
## Commands
|
|
- Development environment (versions pinned in `pyproject.toml`, group `dev`): `python3 -m venv .venv && .venv/bin/pip install --group dev`
|
|
- Tests: `.venv/bin/pytest` (fast, about 1.5 min); `.venv/bin/pytest -m treg` runs the note's full simulation (about 2.5 min)
|
|
- Lint and types (the core is excluded in `pyproject.toml`): `.venv/bin/ruff check .` and `.venv/bin/mypy .`
|
|
- Reproduction check against the note: `.venv/bin/python modell/kjor.py kontroll` (full run, about 75 s) or
|
|
`.venv/bin/python modell/kjor.py kontroll --rask`
|
|
- Try the skills' commands: `python3 modell/kjor.py diagnose eksempler/eksempel_domstol.json`,
|
|
`python3 modell/kjor.py forlop eksempler/eksempel_domstol.json`
|
|
- Validate the plugin: `claude plugin validate .`
|
|
- Load the plugin locally: `claude --plugin-dir .`
|
|
|
|
## Workflow
|
|
- Remote is Forgejo (`git.fromaitochitta.com`), never GitHub. Visibility, catalog entry and the move to `open/` are the
|
|
operator's decisions.
|
|
- `PLAN.md` and `STATE.md` are local working files (gitignored).
|
|
- Conventional Commits. Do not commit working documents.
|