portfolio-optimiser/shared/examples/bygg-energi-mikro/index.md
Kjell Tore Guttormsen cbc7a22c78 docs(shared): bygg-energi mikro-eksempel — OKF-bundle + golden + load-bearing test
Persistent dev-fixture for energieffektivisering (energiledelse/M&V), valgt for
sin lærings-overflate: gapet mellom modellert besparelse (validatoren regner) og
faktisk realisert besparelse i drift (eksperten kjenner) — det ExpeL skal lære.

Ett kontorbygg, ett LED-retrofit-tiltak. OKF-bundle (index/project/hypothesis/
methodology/reference/verdict) bærer kontekst-laget; verdict-led-fro.md koder
realiseringsgraden (RR ≈ 0,82, forankret i National Grid SBS 2010) som ExpeL-frø.

Energi mappet inn i den EKSISTERENDE kost-IR-en uendret (affected = byggets totale
energikostnad, claimed = modellert besparelse ~10 % < 30 %-cap), så validatoren
kjører som-den-er — src/ urørt. golden.json fryser de seeded percentilene; testen
beviser at fixturen er konsumerbar (validerer, ikke Rejection), ikke bare til stede.

Domenetall verifisert mot primærkilder (EVO/IPMVP, DOE/NREL UMP, CPUC, fire
evalueringsstudier); norsk energipris mot SSB Q1 2026. README + shared/README
oppdatert (eksempel finnes, ikke lenger "planned"). Suite 121/4, ruff+mypy rene.

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

41 lines
2.3 KiB
Markdown

---
type: index
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».