Merge commit '8a86f2ab6d'

shared/README.md

@@ -20,6 +20,15 @@ so the only thing that differs is the agent framework itself.
   bundle (OKF / LLM-wiki): one office building, one LED-retrofit measure, with a seed expert
   verdict encoding the realization gap and a golden-suite of expected validator outcomes. A
   small **dev fixture** for exercising the agentic loop; a realistic full-scale example comes later.
+- [`examples/nav-golden-hierarchy/`](examples/nav-golden-hierarchy/) and
+  [`examples/nav-golden-escape/`](examples/nav-golden-escape/) — the **nav-golden** fixture class:
+  `bundle/` in, `expected-read-context.md` out, exercising the navigation contract (method-spec §3
+  Step 1) with one positive case (hierarchy, dedup, cycle termination, verdict exclusion) and one
+  negative case (`..` and root-relative escapes, so a gate built on them can actually go red). Each
+  case documents itself in its own `README.md`. **Informative listing only** — no normative file
+  refers to this class, and the comparison rule is deliberately not pinned (each case's README
+  leaves a gate free to compare byte-exact or after trailing-whitespace normalization), so these
+  are not ground truth in the sense method-spec §7 uses the word.
 - [`skills/expert-reviewer/`](skills/expert-reviewer/) — the **expert-reviewer persona** as a
   framework-neutral Agent Skill: a `SKILL.md` persona prompt (energy-advisor / M&V role + the
   realization-gap methodology the validator cannot compute) and a canonical