GoogleCloudPlatform / GoogleCloudPlatform/knowledge-catalog
AKB: an independent, platform-scale OKF implementation (+ field-naming & typed-link feedback)
- Dominant language
- TypeScript
- Stars
- 9.2k
- Forks
- 782
- Avg merge
- 6h 36m
- Merged PRs (30d)
- 85
Description
Hi, and thanks for publishing OKF — the "format, not platform" framing and the path-is-identity model resonate strongly with us.
We maintain **[AKB (Agent Knowledge Base)](https://github.com/dnotitia/akb)**, an open-source knowledge platform for AI agents (MCP + REST, Postgres source-of-truth, per-vault git, hybrid search, RBAC). What struck us reading the v0.1 spec is that **AKB independently arrived at OKF's exact core model before the spec existed**: every vault is a per-vault git repo of `.md` files with YAML frontmatter, and **a document's identity is its path** (`tables/users.md` → concept ID `tables/users`).
We've now added a first-class OKF producer + a standalone conformance validator:
- Interop module + CLI: [`backend/app/services/okf.py`](https://github.com/dnotitia/akb/blob/main/backend/app/services/okf.py)
- Positioning + a hand-written conformant sample bundle: [`okf/`](https://github.com/dnotitia/akb/tree/main/okf)
AKB-authored bundles satisfy all three v0.1 **MUST** rules; our exporter reconciles the SHOULD-level field-name differences and synthesizes `index.md` / `log.md` / root `okf_version`. We see OKF and AKB as **complementary** — the same way MCP and OKF are: OKF standardizes *how knowledge is written down*; AKB is a platform that stores, versions, searches, governs, and serves it.
Two pieces of feedback from doing the integration:
1. **Recommended-field aliases.** Existing markdown-knowledge tooling (AKB included) already uses `summary` (≈ `description`) and `created_at`/`updated_at` (≈ `timestamp`). A short, non-normative "common aliases a consumer SHOULD recognize" note would smooth adoption for existing corpora without weakening the single-required-`type` minimalism.
2. **Optional typed relationships.** OKF links assert *that* a relationship exists, with the kind left to surrounding prose. At platform scale we found real value in typed edges (`depends_on` / `implements` / `references`). Could an *optional* convention for link kinds fit OKF's permissive model?
Also: there doesn't appear to be a standalone conformance validator in the repo (validation logic lives in the enrichment agent / tests). If a portable checker would be useful upstream, we're happy to contribute ours. And if you keep an implementations/ecosystem list, we'd be glad to have AKB listed.
Thanks again for the spec.
Contributor guide
Assessment
This issue has not been assessed yet.