docs(qa): the four decisions the QA surfaced, with what constrains them

The 20 claims went un-corrected, so they stand as confirmed. What the operator
actually decided were the four choices the QA exposed: hand-built example with
the factory path explicitly deferred, step 5 built and shown live, commons
ordered with a fallback, README after the demo rather than before.

Two measurements are recorded because they bound the order, not because they
are interesting: bundle_context renders every navigated file's full body, and
summary-first reading is not built -- so the full 15-30 measure library would
put 40-90k characters into every hypothesis prompt. The order is size-capped
for that reason and says so.

Also recorded: simulate_learning_loop already takes the bundle directory as a
parameter, so new content plugs into an existing seam. The cost is the scripted
replies, which are written against the LED case.
This commit is contained in:
Kjell Tore Guttormsen 2026-08-06 13:20:52 +02:00
commit 3313e9dcaa

View file

@ -252,3 +252,60 @@ Ikke rammene — de står. Men fire ting planen nå må gjøre som briefen ikke
presentasjon.
4. **Nivå-2-taket (G4)** blir demoens ærlighets-ramme, og README-oppdateringen er en konsekvens som
skal med i planen — eller eksplisitt utsettes.
---
## G. Operatørens svar (2026-08-06) — de fire beslutningene planen bygger på
Påstandene A1C8 ble lagt fram og **ingen ble korrigert** → alle 20 står som bekreftet, slik
dokumentets egen regel sier. Det operatøren derimot avgjorde, var de fire valgene QA-en avdekket:
**O1 (svar på G2) — FERDIGBYGD EKSEMPEL.** Energi-eksemplet bygges for hånd og sjekkes inn i
commons. **Fabrikk-stien (D-G/T0 `okf-toolkit`) er eksplisitt utsatt** og er ute av 13.-august-stien.
Demoen viser fortsatt «last ned → kjør» — men innholdet er kuratert, ikke fabrikkert, og det er dét
som skal sies høyt. Konsekvens: D-Hs demo-sti pkt. 4 er **delvis oppfylt** i denne demoen, og
avviket hører i ærlighets-avsnittet, ikke i en fotnote.
**O2 (svar på C7) — STEG 5 BYGGES OG VISES LIVE.** Ny søm som slipper den mellomliggende
avvisningen ut av `generate_via_llm`, pluss et nytt skriptet avvis-så-korriger-forløp i
simuleringen. Estimert én økt. Begrunnelsen er fristen selv: kravet er ALLE ÅTTE STEG, og et steg
som bare omtales er ikke vist. Testbevis-varianten og den muntlige varianten ble vurdert og valgt bort.
**O3 (svar på E2) — BESTILL NÅ MED FRIST 11. AUGUST, OG PLANLEGG RESERVE.** Bestillingen sendes til
commons i dag via `coord-send`; planen får et fall-tilbake her (kjør demoen på `bygg-energi-mikro`)
som utløses hvis eksemplet ikke er hentbart 11. august. Ingen jobber i commons' repo fra denne taben.
**O4 (svar på G4) — README OPPDATERES ETTER DEMOEN (14.15. august).** Rekkefølgen D-I krever holdes:
beviset først, påstanden etterpå. Planen reserverer tid, men README røres ikke før torsdag.
### Målinger gjort etter beslutningene (grunnlag for bestillingens størrelse)
```
$ uv run python -c "okf.navigate_bundle('shared/examples/bygg-energi-mikro') → bundle_context"
context_files: 4 · chars: 12005 · ≈ 3001 tokens
kilder-realiseringsgap.md (reference) 3519 · bygg-kontor-nord.md (project) 1594
tiltak-led-retrofit.md (hypothesis) 3007 · metode-ipmvp-a.md (methodology) 1759
```
To konsekvenser bestillingen MÅ bære, begge målt og ingen av dem valgfrie:
- **`bundle_context` rendrer HELE brødteksten i hver navigert fil** (`okf.py:206233`), og
**trinnvis sammendrags-lesing (D-F pkt. 6) er ikke bygget.** D-F pkt. 7s fulle ambisjon —
1530 tiltak i ett bibliotek — ville derfor gitt 4090 000 tegn (1022 k tokens) inn i HVER
hypotese-prompt, under harde token-tak. `dimension`-filteret hjelper ikke, siden alt her er
samme dimensjon. Bestillingen må derfor være **størrelses-kappet**, og det fulle biblioteket
forblir den «egne senere innholds-produksjonsjobben» D-F pkt. 7 selv navngir.
- **D-F pkt. 4 løser dette strukturelt:** delt bibliotek *materialiseres inn i hver
prosjekt-bundle*. Flere prosjekter = flere bundles, ikke én stor. Det holder per-kjøring-
konteksten nede OG gir porteføljestien (bølger, budsjett, hovedbok) noe ekte å kjøre på.
**Innplasserings-funn (godt nytt for planen):** `simulate_learning_loop(bundle_dir, …)`
(`simulation.py:183`, kalt `:293`) tar bundle-katalogen som **parameter** og kopierer den til en
arbeidskatalog. Et nytt eksempel plugges altså inn i en eksisterende søm. **Men** de skriptede
svarene er skrevet mot LED-caset, så nytt innhold krever nytt manus — den koblingen er planens
egentlige kostnad ved O1, ikke selve bundle-innlesingen.
### Fortsatt ubesvart (ikke blokkerende — anbefaling gjelder ved taushet)
- Dette dokumentet til den offentlige speilingen? **Anbefaling: nei** (intern analyse).
- Tracking av `.claude/projects/`? **Anbefaling: nei** (uendret fra tidligere økter).