From 3c017ac7d941bbace57e95b6d77a33f897e7d57b Mon Sep 17 00:00:00 2001 From: Kjell Tore Guttormsen Date: Mon, 20 Jul 2026 09:28:40 +0200 Subject: [PATCH] =?UTF-8?q?docs(ms-ai-architect):=20S-OKF=20trinn=20D-revi?= =?UTF-8?q?ew=20=E2=80=94=20krav=207=20(delvis=20bundle=20=3D=20gyldig=20t?= =?UTF-8?q?ilstand,=20check=20m=C3=A5=20skille=20ufullstendig=20fra=20ugyl?= =?UTF-8?q?dig),=20krav=205=20trukket=20(F1-d=C3=B8r-B-premisset=20falt=20?= =?UTF-8?q?da=20d=C3=B8rene=20ble=20komposisjoner),=20index-semantikk=20av?= =?UTF-8?q?klart=20som=20kontraktsforpliktelse=20ikke=20retrieval=20[skip-?= =?UTF-8?q?docs]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/okf-second-brain-brief-2026-06.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/okf-second-brain-brief-2026-06.md b/docs/okf-second-brain-brief-2026-06.md index 064125a..a01ac20 100644 --- a/docs/okf-second-brain-brief-2026-06.md +++ b/docs/okf-second-brain-brief-2026-06.md @@ -105,8 +105,11 @@ Second brain-filene fødes av et **onboarding-intervju** (LLM → `Write`), ikke 2. **`okf index` som bibliotekfunksjon, ikke bare CLI.** Vi må regenerere `index.md` per nivå fra en in-process hook (onboarding-agent skriver én fil → indeks oppdateres i samme operasjon), uten å shelle ut. 3. **`okf check` med maskinlesbar exit + funn-struktur.** Vi har allerede create-guard-mønsteret (`validate-kb-file.mjs`, exit≠0 = stopp) og vil speile det for OKF-flaten. 4. **Guard-hook ved persist, ikke i biblioteket.** `free-context.md` er den ene slotten der brukeren limer inn vilkårlig eksternt innhold — der må `llm-ingestion-guard` kalles på kallstedet. Vi leser IKKE «security is delegated» som «trygt by default» (jf. v0.3.1-presiseringen). -5. **Fritekst-kravet (F1) gjelder oss, men via dør B — ikke dør A.** Om `free-context.md`-inntak skal formaliseres, er innboks-mønsteret (split → frontmatter → write) riktig form, ikke en connector. +5. ~~**Fritekst-kravet (F1) gjelder oss, men via dør B — ikke dør A.**~~ **Trukket 2026-07-20 (trinn D-review).** Premisset var at dørene er monolitter; når de blir komposisjoner over offentlige primitiver, forsvinner det. Vi har ingen preferanse for hvordan F1 løses, så lenge writeren ikke låses bak connector-laget (krav 1). 6. **Vendring, ikke npm** — zero-dep ESM som kan sjekkes inn under `scripts/`, konsistent med at pluginen distribueres offentlig og må kjøre uten install-steg. +7. **Delvis bundle er en normaltilstand, ikke en feiltilstand** (nytt, trinn D-review 2026-07-20). Onboarding er resumbar på tvers av økter — `agents/onboarding-agent.md` gjenopptar fra første fil uten `completed: true`, og sesjonshooken rapporterer «Onboarding 3/6» som gyldig tilstand (`hooks/scripts/session-start-context.mjs:158-161`). `check` må derfor skille **ufullstendig-men-gyldig** fra **ugyldig**, og `index` må være kallbar etter hver enkeltfil-skriving uten å feile på at resten mangler. Speiler vi `check` inn i create-guard-mønsteret (krav 3) og den feiler midt i et intervju, blokkerer vi vår egen onboarding. + +**Index-semantikk (avklart trinn D-review):** vi legger ikke til et fjerde uforenlig krav. Ingen konsument leser en indeks — alle 12 agenter leser navngitte filer direkte via absolutt sti. Indeksen er for oss en kontrakts-/oppdagelsesforpliktelse (markøren `okf_version`), ikke en retrieval-mekanisme; bibliotekets default holder. ### Aldri hit (punkt (c)) - **De 389 skill-reference-filene.** Stående operatør-direktiv (§ «Scope-grense»); native Claude Code-mekanisme dekker allerede OKFs list/search/read.