Developer Tests Google's Open Knowledge Format on Real API Codebase, Results Surprise
A senior software engineer and tech lead converted the documentation directory of a project called order-api into a conformant Open Knowledge Format (OKF) v0.1 bundle to test whether the format genuinely improves AI agent performance. The experiment involved 25 documents spanning ADRs, evals, skills, runbooks, and reference files, each updated with YAML frontmatter and cross-linked related sections per OKF specification. Two separate AI agent sessions using Claude Code were then run against identical tasks — one using the original repo structure and one using the OKF bundle — to compare behavior. The conversion required only two structural changes per document: standardized metadata headers and a related-links section at the bottom. The engineer noted the outcome differed from expectations, though the full findings are detailed in the accompanying article.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.
Discussion (0)
Log in to join the discussion and vote.
Log in