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.