Kjell Tore Guttormsen
56345d4351
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
42 lines
2.3 KiB
Markdown
42 lines
2.3 KiB
Markdown
---
|
|
type: index
|
|
okf_version: 0.1
|
|
title: "Bygg-energi mikro-eksempel — kontorbygg, LED-retrofit"
|
|
description: "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."
|
|
tags: [energieffektivisering, M&V, IPMVP, mikro-eksempel, fixture]
|
|
timestamp: 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](../../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](verdict-led-fro.md).
|
|
|
|
## Innhold (progressiv disclosure)
|
|
|
|
- [bygg-kontor-nord.md](bygg-kontor-nord.md) — `type: project` — bygget og energibaseline.
|
|
- [tiltak-led-retrofit.md](tiltak-led-retrofit.md) — `type: hypothesis` — kandidat-tiltaket
|
|
(LED-retrofit) med alle parametere for den modellerte besparelsen.
|
|
- [metode-ipmvp-a.md](metode-ipmvp-a.md) — `type: methodology` — M&V-metoden (IPMVP Option A).
|
|
- [kilder-realiseringsgap.md](kilder-realiseringsgap.md) — `type: reference` — verifisert
|
|
litteratur om realiseringsgrad og dets årsaker.
|
|
- [verdict-led-fro.md](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](tiltak-led-retrofit.md) §«Mapping til validatoren».
|