Back to feed
Dev.to
Dev.to
7/21/2026
Converting order-api docs to OKF v0.1: a controlled Claude Code comparison

Converting order-api docs to OKF v0.1: a controlled Claude Code comparison

Original: I Converted the order-api to OKF. Here's What I Found.

Short summary

A senior engineer documents converting an order-api's docs directory into a Google Open Knowledge Format (OKF) v0.1 bundle, then running a controlled comparison: the same Claude Code task against the current repo structure versus the OKF bundle. The article maps ADRs to Decisions, evals to Guardrails, skills to Methodologies, and runbooks to Playbooks, adding YAML frontmatter and cross-linking sections. The experiment reveals unexpected differences in agent behavior between the two configurations.

  • •Converts 25 project docs into OKF v0.1 bundle with typed frontmatter and cross-links
  • •Runs controlled Claude Code experiment comparing OKF bundle vs standard repo structure
  • •Maps ADRs, evals, skills, and runbooks to OKF document types with conformance checks

Generated with AI, which can make mistakes.

#ai-tools#ai-agents#open-source
Read full article at Dev.to

Is this a good recommendation for you?

Comments

Failed to load comments. Please try again.

Explore more

Google Cloud's Open Knowledge Format spec and how it maps to existing AI knowledge-management patterns
Dev.to
The 3-Tier Skill Architecture in Practice
Dev.to
The original title is: "How AI Agent Skills Degrade Under Agent Load — and Three Properties That Prevent It"
Dev.to
The Skill Review: A New Artifact for a New Workflow
Dev.to