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/metode-ipmvp-a.md

@@ -0,0 +1,40 @@
+---
+type: methodology
+title: "IPMVP Option A — Retrofit Isolation, Key Parameter Measurement"
+description: "M&V-metoden for å verifisere besparelsen fra ett isolert tiltak ved å måle nøkkelparameteren (effekt) og estimere resten (driftstimer)."
+methodology: IPMVP
+option: A
+tags: [IPMVP, M&V, EVO, retrofit-isolation]
+timestamp: 2026-06-29
+---
+
+# M&V-metode: IPMVP Option A
+
+**IPMVP** (International Performance Measurement and Verification Protocol) er
+konsensus-rammeverket for å måle og verifisere energibesparelser, eid og vedlikeholdt av
+**EVO** (Efficiency Valuation Organization). Kjerneinnsikten som begrunner hele
+lærings-sløyfa står eksplisitt i protokollen [V]:
+
+> *"Savings cannot be directly measured, because savings represent the absence of energy use."*
+
+Besparelse er en **kontrafaktisk** størrelse — det finnes ingen måler for «det som ikke ble
+brukt». Den *beregnes*: `Baseline-energi − Rapporterings-energi ± justeringer` (IPMVP Eq. 1).
+
+## De fire opsjonene (EVO, offisielle navn) [V]
+
+- **Option A — Retrofit Isolation: Key Parameter Measurement.** Måler nøkkelparameteren
+  (typisk effekt) på det berørte utstyret; øvrige parametere (typisk driftstimer) *estimeres*.
+- **Option B — Retrofit Isolation: All Parameter Measurement.** Måler alle relevante parametere.
+- **Option C — Whole Facility.** Besparelse fra byggets hovedmåler, med rutinejustering (vær/produksjon).
+- **Option D — Calibrated Simulation.** Besparelse via simuleringsmodell kalibrert mot måledata.
+
+## Hvorfor Option A for dette tiltaket [V]
+
+EVOs egen tabell bruker nettopp et **lysarmatur-retrofit** som den kanoniske Option A-saken:
+effekt før/etter måles (billig, presist), mens **driftstimer stipuleres** fra byggets
+timeplan. Det gjør Option A enklest og billigst for ett isolert tiltak.
+
+**Kritisk for lærings-overflaten:** parameteren Option A tillater å *estimere* — driftstimer
+— er nøyaktig der realiseringsgapet oppstår. Den stipulerte timeplanen treffer sjelden den
+faktiske, metrede brenntiden. Se [verdict-led-fro.md](verdict-led-fro.md) og
+[kilder-realiseringsgap.md](kilder-realiseringsgap.md).