Skip to content

[Docs] OKF (Open Knowledge Format) study; improvements #96-#98 - #10

Merged
codenamev merged 1 commit into
mainfrom
worktree-study-okf-findings
Jul 16, 2026
Merged

[Docs] OKF (Open Knowledge Format) study; improvements #96-#98#10
codenamev merged 1 commit into
mainfrom
worktree-study-okf-findings

Conversation

@codenamev

@codenamev codenamev commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a /study-repo analysis of Google Cloud's Open Knowledge Format (spec v0.1 draft) — a vendor-neutral spec for knowledge as markdown files with YAML frontmatter in directory bundles.

Headline finding: OKF and ClaudeMemory are complementary, not competing. OKF specifies an interchange surface with no engine (no truth maintenance, no queryable provenance, no ranked retrieval); ClaudeMemory is an engine whose only interchange surface is one generated monolith. OKF is what our publish layer could speak — and must never be our store of record.

Changes

  • docs/influence/okf.md — full analysis: spec structure, permissive consumption model, bottom-up index regeneration, augmentation guard (loss-refusing writes), tool-enforced crawl budgets, four-gate reference mint test, comparison table vs ClaudeMemory, prioritized adoption opportunities.
  • docs/improvements.md — new "OKF Study (2026-07-16)" section:
    • #96claude-memory export --format okf — per-fact markdown bundle with provenance-derived citations, generated index.md progressive disclosure, log.md from memory.changes. The lock-in answer.
    • #97 ⭐ Corrective re-prompt errors + loss-refusing guards in memory.store_extraction — error shape: invariant → what to preserve → which tool to re-call. Targets Layer-2 extraction loss (#72). Loss guard starts warn-mode.
    • #98 ⭐ Four-gate reference mint test in the SessionStart distillation prompt — targets the documented reference-junk / distiller-hallucination pattern.
    • Medium items (log.md changelog in the snapshot, sorted-pair naming for symmetric relationships) and Features to Avoid (per-call LLM synthesis, files as store of record, global tool state, CDN-dependent artifacts).

Items were renumbered from #76–#78 to #96–#98 during rebase: the 2026-06-30 and 2026-07-09 re-study cycles on main had already consumed #76–#95.

Docs only — no runtime code changes.

Study of GoogleCloudPlatform/knowledge-catalog okf/ (spec v0.1 draft):
- docs/influence/okf.md — full analysis (format core, augmentation
  guards, tool-enforced crawl budgets, four-gate reference mint test)
- docs/improvements.md — new dated section with three High Priority
  items: #96 OKF export target, #97 corrective re-prompt errors +
  loss-refusing store_extraction guards, #98 four-gate reference mint
  test in the SessionStart prompt (renumbered from #76-#78 after the
  2026-06-30/07-09 re-study cycles consumed #76-#95 on main)
@codenamev
codenamev force-pushed the worktree-study-okf-findings branch from 5e16c6a to fbbe136 Compare July 16, 2026 20:44
@codenamev codenamev changed the title [Docs] OKF (Open Knowledge Format) study; improvements #76-#78 [Docs] OKF (Open Knowledge Format) study; improvements #96-#98 Jul 16, 2026
@codenamev
codenamev merged commit 21b5e81 into main Jul 16, 2026
1 check failed
@codenamev
codenamev deleted the worktree-study-okf-findings branch July 16, 2026 20:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant