OKF Write Path and Read Path

OKF Write Path and Read Path A workflow diagram generated by Archify. 01 / Agent 02 / Deterministic write boundary 03 / Shared Git repository 04 / Read path Capture Validate and commit Progressive disclosure Raw input · transcript, PR, repo scan · Agent › Capture Raw input transcript, PR, repo scan Agent proposes · structured fields · Agent › Capture · no blind write Agent proposes structured fields no blind write Context window · smallest useful subgraph · Agent › Progressive disclosure · budget = window / 4 Context window smallest useful subgraph budget = window / 4 Capture script · pkc_capture.py · Deterministic write boundary › Validate and commit · deterministic Capture script pkc_capture.py deterministic Schema validate · envelope + links · Deterministic write boundary › Validate and commit · fail-closed Schema validate envelope + links fail-closed Curate hook · regenerates index.md · Shared Git repository › Validate and commit · derived Curate hook regenerates index.md derived knowledge/ on main · one file per concept · Shared Git repository › Validate and commit · source of truth knowledge/ on main one file per concept source of truth Retrieval ladder · index, rg, scan · Read path › Validate and commit · disposable Retrieval ladder index, rg, scan disposable ContextPack · outbound BFS, ranked · Read path › Progressive disclosure · 2 hops, 20 nodes ContextPack outbound BFS, ranked 2 hops, 20 nodes candidate paths frontmatter + links commit edited Markdown ranked subgraph paste or scan proposed concept index.md mtime + size sweep Legend User UI Agent logic Policy Context / trace External system

The agent proposes, scripts commit

  • • An agent never writes concept files by hand
  • • Capture scripts own frontmatter, paths, and identifiers

Catalogs are derived, not authored

  • • Each directory carries an index.md typed Catalog
  • • The post-edit hook regenerates it and runs a light validate

Reading is deliberately lossy

  • • The ladder decides which files get read, never the score
  • • The pack caps hops and nodes, then ranks what survives