open/portfolio-optimiser
1
0
Fork 0
Code Issues Releases Activity
portfolio-optimiser/shared/examples/bygg-energi-mikro/index.md
Kjell Tore Guttormsen 812db2363e docs(shared): conform bygg-energi-mikro to the shared OKF spec (okf_version 0.1) 
Cross-coordination with the marketplace OKF convention
(ktg-plugin-marketplace/catalog/docs/okf-second-brain/spec.md v0.1). The
bundle already passed the shared acceptance gate; the one spec MUST-gap was the
root index okf_version marker (spec §3). Added it.

Verified: `node catalog/scripts/okf-check.mjs <bundle>` -> okf_version: 0.1,
"OK: valid OKF bundle", exit 0. Bundle-consuming tests green (14).

Scope note (honest): portfolio-optimiser uses OKF for framework per-project
runtime knowledge, NOT the user "second brain" the marketplace convention is
scoped to. Same FORM (now conformant + gate-clean), different SCOPE. Two
recommended `resource` warnings left deliberately (spec §4 sanctions omission;
no canonical URI to assert without fabricating). The index.md frontmatter is a
known deviation from spec §6 (reserved index = no frontmatter) kept for now
because okf.py navigation classifies the index by its type.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MHR8iKxJRxDiDfNw8HZmWE
2026-06-29 14:50:04 +02:00

2.3 KiB
Raw Blame History

type okf_version title description tags timestamp
index 0.1 Bygg-energi mikro-eksempel — kontorbygg, LED-retrofit Minimal OKF-bundle for ett kontorbygg med ett energieffektiviseringstiltak (LED-belysningsretrofit). Utviklings-fixture for den agentiske loopen: kontekst → hypotese → deterministisk validering → ekspert-dom → læring.
energieffektivisering
M&V
IPMVP
mikro-eksempel
fixture
2026-06-29

Bygg-energi mikro-eksempel

En mikro OKF-bundle (Open Knowledge Format): ett kontorbygg, ett kandidat-tiltak. Den er liten med vilje — formålet er rask småskala-testing og validering av den agentiske loopen gjennom hele utviklingsløpet. Et realistisk fullskala-eksempel bygges senere (målbilde §8); dette er forløperen.

Dette er en framework-nøytral artefakt (null kode-avhengighet). Den deles uendret mellom MAF- og Claude-SDK-implementasjonene. Se shared/README.md.

Hvorfor energieffektivisering

Domenet ble valgt for sin lærings-overflate: et reelt, dokumentert gap mellom det en deterministisk validator kan regne (modellert besparelse fra parametere) og det en fagekspert kjenner (faktisk realisert besparelse i drift). Det gapet — realiseringsgraden — er det lærings-sløyfa (ExpeL) skal lære. Se verdict-led-fro.md.

Innhold (progressiv disclosure)

  • bygg-kontor-nord.md — type: project — bygget og energibaseline.
  • tiltak-led-retrofit.md — type: hypothesis — kandidat-tiltaket (LED-retrofit) med alle parametere for den modellerte besparelsen.
  • metode-ipmvp-a.md — type: methodology — M&V-metoden (IPMVP Option A).
  • kilder-realiseringsgap.md — type: reference — verifisert litteratur om realiseringsgrad og dets årsaker.
  • verdict-led-fro.md — type: verdict — frøsatt ekspert-dom som koder realiseringsgapet. ExpeL-frøet loopens steg 1 henter fra.

Hvordan den kjøres i dag

validator-input.json er IR-projeksjonen den eksisterende deterministiske validatoren konsumerer uendret (energitiltaket mappet inn i kost-IR-en); golden.json fryser det forventede utfallet. Se tiltak-led-retrofit.md §«Mapping til validatoren».