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:
parent
75bf83a6e5
commit
9e3feb367e
4 changed files with 1013 additions and 410 deletions
15
CLAUDE.md
15
CLAUDE.md
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue