OKF Didn't Die — It Learned to Remember Itself

TL;DR — We stopped maintaining files and started having memory. Same ideas, different substrate — OKF's skeleton survived inside a semantic brain.

The Threshold

Files are data you curate. Semantic memory is retrieval without navigation. It took a while to tell them apart.

The bug with OKF was never the schema — frontmatter, directory layout, typed links, all fine. The bug was that somebody had to remember to update the files. And nobody does. The moment a project shipped, last_updated started lying. The skeleton was solid; the upkeep was the leak.

So on 07-30 we stopped feeding files and started asking a brain instead. OKF didn't get deleted. It got transplanted — 8 projects' worth of context moved over to Second Brain at brain.mcky.space, and OKF became a backup snapshot. Commit 16245fd, "docs: switch KB to Second Brain MCP," 2026-07-31.

OKF's Ideas, Transplanted

Every good idea in OKF found a home. Nothing was thrown away, just re-homed:

OKF (files)                   →  Second Brain (semantic memory)
frontmatter type/id/           →  typed metadata + tags
  last_updated
graph edges                   →  link types: caused_by / decided /
                                   supersedes / relates_to
freshness / verified / expires →  status lifecycle: canonical /
  + doctor-kb                     draft / deprecated + smart-merge
                                   + contradiction detection
okf_query_nodes / create_node  →  recall / remember / session_boot /
  / add_edge                      list_recent / append / update /
                                  set_status

The old freshness system flagged stale YAML. The brain argues with itself instead — smart-merge reconciles, contradiction detection goes "hold on, that says both X and Y," and deprecated entries drop out of recall. Nobody runs doctor-kb anymore because there's nothing left to doctor.

The Daily Ritual

The triggers became a ritual. Session start: session_boot returns a compact project map plus the last 24 hours — zero LLM cost, no reading five files. End of work: write-back. Lessons get stored immediately, one or two lines, no raw logs, with the [source: brain] convention so every claim carries a receipt.

No schema migrations. No update .md. The ritual replaced the triggers — and the triggers finally earned their retirement.

What Changed

Eight projects' worth of context survived the move. OKF stays as a snapshot, not a ghost — a backup copy, not a zombie. And knowledge is searched by meaning (recall) instead of by path. You don't navigate to the answer; you ask for it.

OKF was a library card catalog. Second Brain is a librarian who's already read every book and answers before you finish the question. You stop browsing shelves and start asking.

What's Next

Graph hops — recall with one or two levels of expansion, surfacing related memories instead of just direct matches. Project namespaces and tags, so context stays scoped. The brain gets deeper; OKF gets quieter.

OKF didn't die. It learned to remember itself.