Google Cloudは2026年6月にGoogle Open Knowledge Format OKFの仕様を公開し、開発者コミュニティで議論を巻き起こした。一部の開発チームは、これを自律型AIアーキテクチャのブレイクスルーと位置づけている。一方で、標準的なMarkdownファイルを企業向けにリブランディングしただけだと一蹴する声もある。しかし、どちらの見方もこの仕様の構造的な本質を見落としている。OKFは、AIシステムにおける具体的かつ実用的なボトルネックを解決する。それは、自律型エージェントが膨大なコンテキストの肥大化（コンテキスト・ブロート）を起こさずに利用できるよう、複雑なシステム知識をパッケージ化し、バージョン管理する方法である。
What is the Google Open Knowledge Format OKF?
Google Open Knowledge Format OKFは、ソフトウェアリポジトリや企業ディレクトリがAIエージェントと文脈（コンテキスト）を共有する方法を標準化するために設計された、ベンダーニュートラルなディレクトリ構造である。開発者は、重いベクトルデータベースに依存したり、PDFのマニュアル丸ごとLLMのコンテキストウィンドウに入力したりする代わりに、人間が読めるシンプルなMarkdownファイルのディレクトリを作成する。
OKFバンドル内の各ファイルは、クエリ可能なパラメータを含む標準的なメタデータヘッダーを使用する。
type: system_guideline
title: "Authentication Pipeline Configuration"
description: "How the auth module routes tokens via OAuth2"
resource: "src/auth/pipeline.py"
tags: ["auth", "security", "oauth2"]
timestamp: 2026-06-12T14:30:00ZリンクされたMarkdownドキュメントのフォルダは、Git互換のナレッジグラフとして機能する。ファイルはプレーンテキストであるため、開発者はコードベースと一緒にバージョン管理でき、ドキュメントと実際のコード変更の同期を維持できる。
Why AI Agents Struggle With Raw Documentation
自律型ワークフローを構築するソフトウェアエンジニアは、エージェントがコンテキストの劣化（context decay）に直面していると報告している。コーディングエージェントが複数のサイクルを実行する場合、システムアーキテクチャ、コードのスタイリングルール、APIエンドポイントを繰り返し解析しなければならない。
構造化されたフォーマットがない場合、開発者はすべてのガイドラインをシステムプロンプトに投入してコンテキスト疲弊を引き起こすか、関連性の低いスニペットを抽出するセマンティック検索を実行するかのどちらかになる。
OKFは、ポータブルなメモリフォーマットを確立することでこの問題を解決する。開発者は、標準的な相対リンクを使用してMarkdownファイル間の明示的な関係を定義する。エージェントはOKFエントリを読み込む際、関連リソースへの明確なリンクを参照する。エージェントは必要に応じてナレッジベースを閲覧し、特定のタスクを解決するために必要なファイルのみを読み込む。
The Developer Backlash: “Reinventing the Wiki”
この発表は、RedditやHacker Newsで懐疑的な見方に直面した。多くのエンジニアは、Markdownファイルのプレーンテキストディレクトリは新しいものではないと指摘した。
Hacker Newsのある開発者は、テック業界が本質的にWikiを再発明したに過ぎず、しかもエージェントが読み取るための機能が減少していると指摘した。また、別のシステムアーキテクトは、GoogleがリブランドしたObsidianと全く同じに見えると指摘した。
他の議論では、メンテナンスと持続性に関する懸念が提起された。あるユーザーは、これらのナレッジシステムは最終的にコンテキストの肥大化、古い参照、不一致なエンティティ定義につながると述べた。Googleの製品廃止の歴史を踏まえ、別のコメント投稿者は、数年後に同社がこの仕様を非推奨（ディプリケート）にするのを待つと冗談交じりに語った。
How to Build a Valid OKF Bundle
OKFバンドルは意図的にミニマリストに設計されている。独自のランタイムやプラットフォーム固有のSDKは不要である。開発者は次の3つの基本ルールに従うことで、このフォーマットを手動で実装できる。
- ルートディレクトリ: すべてのドキュメントは、プロジェクトのルートにある専用の
.okf/フォルダ内に存在しなければならない。 - YAMLメタデータ: すべてのMarkdownファイルは、
type、title、resourceの定義を含む有効なYAMLフロントマッターブロックで開始しなければならない。 - リンクされたエンティティ: ドキュメント間の関係は、クリーンなMarkdown相対リンク（例:
[Database Spec](./database-spec.md)）を使用しなければならない。
Google Cloudはこの仕様をサポートする一連のオープンソースツールをリリースした。これには、BigQueryデータベースからOKFファイルを直接生成するエンリッチメントエージェントや、ローカルの.okf/フォルダをインタラクティブなノードベースのHTMLグラフにレンダリングする静的ビジュアライザーが含まれる。
すでにいくつかの独立した開発者ツールがサポートを追加している。オープンソースプロジェクトのプルリクエストでは、メンテナーがOKFのエクスポートおよびインポート機能を実装し、エージェントがコードベースのコンテキストを直接取り込めるようにしている。
Key Takeaways
- 標準化されたエージェントメモリ: Google Open Knowledge Format OKFは、AIエージェント用にプロジェクトの知識をパッケージ化するためのプレーンテキストのMarkdown仕様である。
- Git互換のグラフ: ドキュメントをバージョン管理されたMarkdownファイルとして保存することで、チームは変更を追跡し、エージェントのコンテキストとコードの更新を同期させることができる。
- コンテキスト肥大化の回避: エージェントはリポジトリを閲覧しながら特定のOKFのMarkdownノードを動的に読み込むため、システムプロンプトの過負荷を防ぐことができる。
- コミュニティの懐疑論: 開発者はこのフォーマットをObsidianやWiki構造の基本的なリブランドであると批判しており、その成功は完全に開発者の採用にかかっていると指摘している。
FAQ
What makes Google Open Knowledge Format OKF different from standard markdown?
ファイル自体は標準的なMarkdownであるが、この仕様はYAMLフロントマッターに厳密なメタデータスキーマを定義している。このメタデータにより、AIエージェントはドキュメント間の関係をプログラムでクエリ、フィルタリング、ナビゲートできるようになり、テキストのフォルダをクエリ可能なナレッジグラフに変換する。
Does OKF require Google Cloud tools to run?
不要である。この仕様は完全にベンダーニュートラルである。エージェントにルートの.okf/ディレクトリを指すだけで、任意のAIモデルやエージェントフレームワーク（Claude CodeやカスタムのLangChain構成など）を使用してローカルで利用できる。
How does OKF prevent stale documentation?
OKFファイルはソースコードと並んでGitリポジトリに直接保存されるため、標準のプルリクエストを通じて更新される。開発者はドキュメントの更新を通常のコードレビューの一部として扱うことができ、コードベースの変更に合わせてエージェントへの指示を同期できる。
Can I use OKF for public website SEO?
できない。このフォーマットは、社内の組織ナレッジ、コードベースのコンテキスト、およびエージェントのメモリ向けに設計されている。一部のマーケティングチームが公開サイトに適用しようと試みているが、仕様はエージェントによる直接の利用を目的として設計されており、公開の検索エンジン最適化（SEO）向けではない。
Sources
- Google Cloud Platform Knowledge Catalog Specification: GitHub上のOKF仕様
- Reddit TechSEOコミュニティのディスカッション: Google’s OKF is built for org knowledge
- Reddit RAGコミュニティのディスカッション: Google Quietly Dropped a New Open Standard for AI
