"OKF Update: A Few Days In"
Monday, July 13, 2026

A few days after building OKF, here's where the knowledge base stands.

Current State

  • 8 projects now documented (collage and writer were added after the initial post)
  • 122 knowledge nodes across all projects — decisions, lessons, components, risks
  • 100% documentation coverage for profiles, structure, deps, commands, status
  • 4-personality goblin system — each agent has a distinct voice and obsession
  • MCP server at ~/OKF/mcp-server/ — tools for query, search, create, update, link

What Changed

Automation matured. The MCP tools replaced manual file editing. okf_query_nodes for structured queries, okf_create_node with auto-generated IDs, okf_add_edge for typed links between nodes. Maintenance went from "edit files by hand" to "invoke a tool."

Lifecycle management. Every node now has freshness tracking (freshness, verified, expires). The doctor-kb trigger finds stale nodes automatically.

Cross-project insight. The workspace comparison table tracks 8 projects across 7 frameworks, 4 databases, and 6 deployment targets. It catches drift instantly.

What's Next

Automated validation is still on the roadmap — a CI step that flags stale frontmatter and missing files. The skills system also needs deeper integration with project-specific patterns.

The framework works. Eight projects, one consistent structure, zero manual upkeep.

สองสามวันหลังจากสร้าง OKF นี่คือสิ่งที่ knowledge base เป็นอยู่

สถานะปัจจุบัน

  • 8 โปรเจกต์ ที่มี documentation แล้ว (collage และ writer ถูกเพิ่มหลังจากโพสต์แรก)
  • 122 knowledge nodes ข้ามทุกโปรเจกต์ — decisions, lessons, components, risks
  • 100% documentation coverage สำหรับ profiles, structure, deps, commands, status
  • 4-personality goblin system — agent แต่ละตัวมีบุคลิกและความคลั่งไคล้ของตัวเอง
  • MCP server ที่ ~/OKF/mcp-server/ — tools สำหรับ query, search, create, update, link

อะไรเปลี่ยนไป

Automation matured. MCP tools แทนที่การแก้ไฟล์ด้วยมือ okf_query_nodes สำหรับ structured queries, okf_create_node พร้อม auto-generated IDs, okf_add_edge สำหรับ typed links ระหว่าง nodes การ maintenance เปลี่ยนจาก "แก้ไฟล์มือ" เป็น "เรียก tool"

Lifecycle management. ทุก node มี freshness tracking (freshness, verified, expires) แล้ว trigger doctor-kb หา stale nodes ได้อัตโนมัติ

Cross-project insight. ตารางเปรียบเทียบ workspace ติดตาม 8 โปรเจกต์ข้าม 7 frameworks, 4 databases, และ 6 deployment targets จับ drift ได้ทันที

อะไรต่อ

Automated validation ยังอยู่ใน roadmap — CI step ที่ flag stale frontmatter และไฟล์ที่หาย skills system ก็ต้อง deeper integration กับ project-specific patterns

framework ใช้งานได้ แปดโปรเจกต์, โครงสร้างเดียว, zero manual upkeep

← prev
next →