feat(shared): S4 — re-introduce shared/ as subtree of portfolio-optimiser-commons

commons (ktg/portfolio-optimiser-commons @ 7d2b46c) is now the source of
truth for the framework-neutral shared core; this repo consumes it via
git subtree (--squash) at the unchanged shared/ path.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AaQCFnfsh3tfq1VfzdJpoi

shared/examples/bygg-energi-mikro/index.md

@@ -0,0 +1,42 @@
+---
+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».