Skip to content

Commit fdab941

Browse files
montfortclaude
andauthored
docs(blog): OKF vs StrayMark — "What the open format left to the producer" (EN/es/zh-CN) (#291)
Publishes the dev-blog post on Google's Open Knowledge Format (OKF v0.1) and how it relates to StrayMark, in all three locales (website/blog + i18n/es + i18n/zh-CN). The post's spine is the paradigm difference, not a feature gap: OKF builds cognition *for the agent* (lifting the burden of knowing the system off people, in line with the long-running-autonomous-agent trend); StrayMark builds cognition *for the agent and the human engineer together* (AI-augmented engineering — the human repositioned into judgment/direction, not displaced; Loom as a didactic aid for spatio-temporal location). Non-defensive throughout: convergence as validation, interop over competition. Also refines the experiment-okf analysis docs with the same lens: - Correct the genealogy: StrayMark reached the primitives independently; the Karpathy gist is OKF's lineage, not StrayMark's (removes "DNA"/"siblings"/ "headwater both drink from"/"same intuition under StrayMark"). - Elevate the "who is the knowledge for" axis above the data-vs-governance domain split in 01/02/README. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 336c2a1 commit fdab941

7 files changed

Lines changed: 679 additions & 123 deletions

File tree

experiment-okf/01-okf-vs-straymark-analysis.md

Lines changed: 24 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,15 @@
77

88
OKF and StrayMark share the **same mechanics** — the "LLM-wiki pattern":
99
markdown + YAML frontmatter + a graph of links + an agent that maintains the
10-
corpus — but operate in **orthogonal domains**. OKF describes *the data and
11-
systems agents consume*; StrayMark records *the governance of what agents do*.
12-
Not a frontal competitor; a strong validation of the design bet and a real
10+
corpus — which StrayMark reached **independently** (OKF credits Karpathy; we
11+
didn't get here from him). But they obey **opposite paradigms of AI use**: OKF
12+
builds cognition *for the agent* — lifting the burden of knowing the system off
13+
people, in line with the dominant long-running-autonomous-agent trend — while
14+
StrayMark builds cognition *for the agent and the human engineer together*,
15+
keeping a person oriented and in command. The domains differ too (OKF describes
16+
*the data and systems agents consume*; StrayMark records *the governance of what
17+
agents do*), but that's downstream of the deeper split: **who the knowledge is
18+
for.** Not a frontal competitor; a strong validation of the design bet and a real
1319
interoperability opportunity. The risk is **mindshare capture**, not
1420
replacement.
1521

@@ -46,13 +52,25 @@ Google arrived — independently — at almost every design decision StrayMark m
4652
| Tolerant consumption | broken links are "not-yet-written knowledge", unknown keys preserved | dangling refs kept as first-class `resolved:false` edges |
4753

4854
That Google converged on markdown+frontmatter+graph+agent is the strongest
49-
possible evidence the bet was right. They even cite Karpathy and the "LLM-wiki
50-
pattern" as the genesis — the same intuition under StrayMark.
55+
possible evidence the bet was right — *because the two projects started from
56+
different places.* OKF cites Karpathy and the "LLM-wiki pattern" as its genesis;
57+
StrayMark reached the same intuition on its own, without that lineage. Independent
58+
arrival at the same primitives is what makes the convergence evidence rather than
59+
imitation.
5160

52-
## 4. The decisive difference: domain and intent
61+
## 4. The decisive difference: who the knowledge is for
5362

5463
This is where they stop touching.
5564

65+
The split isn't only domain; it's **who each format's knowledge is ultimately
66+
for.** OKF encodes a system so an *agent* can understand and operate it with as
67+
little human involvement as possible — the autonomous-agent direction the industry
68+
is racing toward. StrayMark encodes how a system was built so a *human engineer*
69+
stays oriented and in command alongside the agent — the "AI-augmented engineering"
70+
position, where the human is repositioned into judgment and direction, not
71+
displaced. One faces the agent; the other faces the agent **and** the human at
72+
once. The domain difference below is a consequence of that, not the root of it:
73+
5674
- **OKF = a semantic / context layer over data.** It encodes *what this table
5775
means, what this metric is, the join paths, the runbook* so an AI agent can
5876
reason over an organization's data estate (BigQuery, Knowledge Catalog). It is

experiment-okf/02-karpathy-llm-wiki-genesis.md

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,15 @@
1-
# The Karpathy gist — genesis of the LLM-wiki pattern, and what it means for StrayMark
1+
# The Karpathy gist — OKF's headwater, and an independent check on StrayMark's bets
22

33
*Prepared 2026-06-17. Source: Andrej Karpathy, gist `442a6bf555914893e9891c11519de94f`
44
(the pattern OKF's announcement explicitly credits as its origin), plus the
55
community replies on that gist.*
66

77
This is the "extra analysis step" requested: the gist is the intellectual
8-
headwater both OKF and StrayMark drink from, and its comment thread already
9-
mapped out the failure modes — several of which StrayMark answers by design.
8+
headwater **OKF's lineage** drinks from — StrayMark reached the same shape
9+
independently, without knowledge of it. What makes the gist worth reading anyway
10+
is its comment thread, which already mapped out the pattern's failure modes —
11+
several of which StrayMark answers by design. That's **corroboration, not
12+
inheritance.**
1013

1114
## 1. The proposal
1215

@@ -32,10 +35,10 @@ rather than auto-resolving). The rationale: humans find wiki upkeep tedious;
3235
it in Vannevar Bush's 1945 Memex — associative trails that finally have a tireless
3336
maintainer.
3437

35-
## 2. Why this is StrayMark's DNA too
38+
## 2. Where StrayMark lands on the same shape — independently
3639

37-
StrayMark is, structurally, an instance of this pattern aimed at one domain —
38-
software governance:
40+
StrayMark independently lands on the same structural shape, aimed at one domain —
41+
software governance. It didn't derive from the pattern; it converges with it:
3942

4043
| Karpathy's pattern | StrayMark |
4144
|---|---|
@@ -47,9 +50,12 @@ software governance:
4750
| Lint (contradictions/stale/orphans/gaps) | `validate`, `charter drift`, follow-ups drift, dangling-ref classification |
4851
| "LLMs don't forget cross-references" | typed frontmatter links resolved by `core::graph` |
4952

50-
So OKF and StrayMark are **siblings, not rivals** — two specializations of the
51-
same parent idea. OKF specializes it for *data context*; StrayMark for
52-
*development governance*.
53+
So OKF and StrayMark are **convergent, not derivative** — two projects that
54+
arrived at the same shape from different starting points (OKF down Karpathy's
55+
lineage, StrayMark on its own) and specialized it differently. And not only for
56+
different domains — *data context* vs *development governance* — but for different
57+
**readers**: OKF builds cognition for the agent; StrayMark builds it for the agent
58+
and the human engineer together.
5359

5460
## 3. The community replies already mapped the failure modes — and StrayMark answers several
5561

@@ -97,10 +103,11 @@ where StrayMark's opinionation earns its keep.
97103

98104
## 4. Takeaways
99105

100-
1. **Convergence at three levels.** The same idea produced (a) Karpathy's
106+
1. **Convergence, not descent.** The same shape recurs across (a) Karpathy's
101107
pattern, (b) Google's OKF spec, (c) community implementations (memwiki), and
102-
(d) StrayMark — independently. The pattern is no longer a differentiator; the
103-
**domain and the opinionation** are.
108+
(d) StrayMark — which reached it independently, with no knowledge of the gist.
109+
The pattern is no longer a differentiator; the **reader it serves** (agent
110+
alone vs agent + human) and the **opinionation** are.
104111
2. **StrayMark answers the gist's hardest critique.** Typed edges that preserve
105112
contradiction (pursultani) are designed-in via `supersedes`/`alternatives`/TDE
106113
— exactly where OKF chose untyped links. This is the sharpest line to draw.

0 commit comments

Comments
 (0)