Squashed 'shared/' changes from 73136eb..f35a22a

f35a22a fix(skills): eksempelet brøt skillens egen regel — undecided, ikke survived
ff7b9b7 docs(spec): Amendment A1 — sources som flow-sekvens + falsification-reviewer-persona
b2205b9 docs(plan): kø commons-shared-golden-referent Q4/§6.2 — køplassering, ikke utførelse
ba0237d docs(plan): kø commons-spec-amendments (D-A 1/2/4+D-F) — køplassering, ikke utførelse
30e1e71 docs(plan): kø SS11-budsjettfunnet — køplassering, ikke utførelse
38a1178 docs(plan): SS12-underlaget lukket — O-A ratifisert og utført (§9)
0f88324 docs(spec): §12 fører generated-undernøklene `by` og `at` som egne rader (O-A)
e307997 docs(plan): kø SS12-undernøklene — køplassering, ikke utførelse
22048ea docs(spec): «step 0 — explore» som informativ merknad; README lover ikke lenger et manglende eksempel
7495cf6 chore(privacy): fjern de tre private identifikatorene fra publiserte filer
6b39f3b docs(readme): Contents lister alle fem eksempelbundler — veglys + tunnel var usynlige
3362e82 fix(security): sikkerhetskontakt security@, ikke hello@ (D6-konsistens)
fecdb97 docs(release): CHANGELOG + v0.1.0 — første taggede snitt av det publiserte kjernen

git-subtree-dir: shared
git-subtree-split: f35a22a3043ba743b8499743d6f2c9c2bb8a579a
This commit is contained in:
Kjell Tore Guttormsen 2026-09-02 21:16:39 +02:00
commit 74008aebfe
13 changed files with 693 additions and 9 deletions

View file

@ -37,7 +37,23 @@ specifications alone, without reverse-engineering the reference code.
- [`examples/bygg-energi-mikro/`](examples/bygg-energi-mikro/) — the first example knowledge
bundle (OKF / LLM-wiki): one office building, one LED-retrofit measure, with a seed expert
verdict encoding the realization gap and a golden-suite of expected validator outcomes. A small
**dev fixture** for exercising the agentic loop; a realistic full-scale example comes later.
**dev fixture** for exercising the agentic loop; the two full-scale bundles below
([`veglys-fv-soer`](examples/veglys-fv-soer/), [`tunnel-hauglia`](examples/tunnel-hauglia/))
are the realistic ones.
- [`examples/veglys-fv-soer/`](examples/veglys-fv-soer/) — an example knowledge bundle at realistic
scale: a county-road street-lighting portfolio with two candidate measures (LED replacement of
2 500 of 9 500 HPS luminaires, and adaptive control), a seed expert verdict, the IR projection
the deterministic validator reads, and the project's cost baseline. The realization gap is a
parameter error — burn hours overestimated — on a Norwegian evidence base where many
installations have no metering at all. Project layer fictional, literature layer real and cited.
Written in Norwegian.
- [`examples/tunnel-hauglia/`](examples/tunnel-hauglia/) — an example knowledge bundle at realistic
scale, same file layout as the veglys bundle: a two-tube road tunnel with two candidate measures
(3-step to 13-step dimming of the entrance and transition zones, and passive portal screening).
Its realization gap arises in operation rather than in the parameters, so the seed verdict carries
`gap_source: control-tracking-overestimation` where both bygg-energi-mikro and veglys-fv-soer
carry `hours-of-use-overestimation` — a second gap class, so a learning loop exercised here has seen
more than one cause. Project layer fictional, literature layer real and cited. Written in Norwegian.
- [`examples/nav-golden-hierarchy/`](examples/nav-golden-hierarchy/) and
[`examples/nav-golden-escape/`](examples/nav-golden-escape/) — the **nav-golden** fixture class:
`bundle/` in, `expected-read-context.md` out, exercising the navigation contract (method-spec §3