GoogleCloudPlatform / GoogleCloudPlatform/knowledge-catalog

AKB: an independent, platform-scale OKF implementation (+ field-naming & typed-link feedback)

Open
#86 0 comments 1 reaction 0 assignees View on GitHub
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.