From b27905303c985ab3e537c871d67fb06a48fe3623 Mon Sep 17 00:00:00 2001 From: Kjell Tore Guttormsen Date: Mon, 29 Jun 2026 15:30:14 +0200 Subject: [PATCH] =?UTF-8?q?docs(catalog):=20OKF=20log=20=E2=80=94=20record?= =?UTF-8?q?=20spec-vs-gate=20coverage=20gap=20as=20a=20deferred=20decision?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The shared gate enforces only the `type:` MUST, not §3's okf_version / per-level index.md MUSTs nor §6's index.md-no-frontmatter (inherited faithfully from okr's reference semantics). So "passes the gate" is a necessary-but-partial §3 signal. Surfaced by the portfolio-optimiser bundle (index.md with frontmatter) passing. Deferred to Stage 2 / a spec<->gate reconciliation — not changed now, since tightening would break the proven verdict-parity with okr's checker. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_012GqEHp4uDiivfrAUjw4BdE --- docs/okf-second-brain/log.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/okf-second-brain/log.md b/docs/okf-second-brain/log.md index db0ba55..3c40b88 100644 --- a/docs/okf-second-brain/log.md +++ b/docs/okf-second-brain/log.md @@ -86,6 +86,18 @@ protocol; 🟢 is reserved for the independent gate-verified step (operator veri `second-brain-search`. If a shared skill ever happens (Stage 3), converge naming + home (standalone plugin, spec §11) — **not now** (Stage 2 measurement must justify it first). +## Deferred decisions + +- **Spec §3/§6 vs. the gate's actual coverage.** The shared gate `okf-check.mjs` (faithfully lifted from + okr's reference) fails **only** on a concept file missing `type:`. It does **not** fail on a missing + root `okf_version` (echoed as `MISSING`, not an error), missing per-level `index.md` (§3 MUST), or an + `index.md` that carries frontmatter (§6 says it should not). So **"passes the gate" = "every concept + file has `type:`"** — a necessary but **partial** §3 signal, not full §3/§6 conformance. Surfaced when + portfolio-optimiser's bundle (index.md with frontmatter) passed. **To resolve in Stage 2 / a spec↔gate + reconciliation:** either tighten the gate to enforce more of §3/§6 (costs the proven verdict-parity + with okr's checker) or relax the spec's MUSTs to match what the gate actually enforces. **Not changed + now** — tightening would silently break okr parity. _(linkedin-studio session, 2026-06-29.)_ + ## Change log - **2026-06-29** — Convention **v0.1** authored (`spec.md`) + this log. Seeded from the three per-plugin