docs(modell): add specification draft 3 and review log

Draft 3 has 47 equations. Changes follow the pre-read of draft 2
(44 findings), two independent reviews of draft 3 (55 and 22 findings)
and an independent control of the corrections (39 findings). Each
finding was checked by the project before it was corrected; the log
says what was done with each.

Main changes: all parameters in 2025 kroner; explicit cash flows per
solution; the price of compute set per MW sold, so that unsold capacity
is not charged to Norway alone; power plants on the grid are never
credited a surplus (S45); the reading of the Norwegian nuclear cost
range is drawn (S46); dimensioning, build-out and residual value are
specified. Eight proposed clarifications of the pre-registration are
listed in chapter 15 and are not entered there.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-11-12 00:57:41 +01:00
commit 9e3feb367e
Signed by: ktg
SSH key fingerprint: SHA256:JakMjO6FTBBzN0Bhfj9saOoEjaFxlSdYuZQQpM/lF9Q
4 changed files with 1013 additions and 410 deletions

View file

@ -13,11 +13,16 @@ Deliverables mirror `~/repos/den-dynamiske-rettsstaten`: full report with the wh
carousel, Python code, and a Claude plugin (own repo, later).
## Stack
- `kilder/`: the source bank, one Markdown file per area. Every model parameter must trace to an entry here.
- `kilder/`: the source bank, one Markdown file per area (01–12 first round, 13–21 targeted second round).
Every model parameter must trace to an entry here.
- `FORHANDSREGISTRERING.md`: the approved direction and pre-registered criteria (M1–M7). Committed.
- `modell/spesifikasjon.md`: the model specification (equations S1–S32, parameter candidates with source-bank
references). `modell/fagfellevurdering-utkast-1.md`: review findings on draft 1 and what was done.
- `PLAN.md` and `STATE.md`: local working files (gitignored). `private/`: working documents, never committed.
- `modell/spesifikasjon.md`: the model specification (equations S1–S44). `modell/parametere.json`: the frozen
parameters (value, range, distribution, source entries); its checksum is recorded in the pre-registration.
The table in chapter 14 of the specification is generated from that file.
`modell/fagfellevurdering-*.md`: review findings per draft and what was done.
- `PLAN.md` and `STATE.md`: local working files (gitignored). `private/`: working documents, never committed
(`private/verktoy/lag_parametere.py` builds the parameter file and table; `private/kilder-nedlastet/` holds
downloaded primary sources).
- No code yet. Python (numpy/scipy pinned, pytest, ruff `ALL`, mypy strict) is set up in the implementation part.
## Conventions
@ -30,6 +35,8 @@ carousel, Python code, and a Claude plugin (own repo, later).
- **Pre-registration:** the criteria in `FORHANDSREGISTRERING.md` are approved by the operator and fixed before
anything is computed. Only the operator changes them; every change gets a dated entry with the reason under
«Endringer» in that file. Parameters are frozen in their own commit before the first result run.
- **Frozen parameters:** `modell/parametere.json` is not edited after the freeze. A change is a deviation: new
commit, new checksum, and a dated entry with the reason under «Endringer» in the pre-registration.
- **Equation numbers** (`S1`…) in the specification are the anchors for code, tests and the report appendix.
Renumbering requires updating all three.
- **Neutrality:** vendors and companies are data sources, cited neutrally, never recommended. Nothing here