
2026/09/06 7:15
OKF エージェントメモリ - AI コーディングエージェントのための Git ネイティブ永続メモリ
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
OKF v0.2 は、Git 原生かつドメイン中立なシステムを導入し、プレーンな Markdown ファイル(YAML フロントマター付)を用いて AI エージェントに永続的なプロジェクトメモリを提供し、高価な外部データベースを排除します。依存関係ゼロのスタンドアロン Go バイナリとして構築され、MIT ライセンスで公開されているためベンダー中立性を確保するとともに、チームが標準的な
git diff および git log を用いてメモリの変更を検証できるようにしています。アーキテクチャは仕様(L1)からプロジェクト知識コーパス(L5)に至るまで 5 レイヤーにわたり、メモリ内 BM25 サーチアルゴリズムを用いて 300 マイクロ秒未満のレイテンシと <15 MB の軽量メモリフットプリントを実現します。この効率は従来の Python/Vector DB ランタイムを上回り、API コストを排除することでユーザーに 1,000 クエリあたり最大 $0.50 を節約させます。システムには Cursor や Claude Code などのプラットフォームとの直接連携を可能にする埋め込み型 Model Context Protocol (MCP) サーバーを搭載しており、validate、search、bootstrap などのコマンドを持つ堅牢な CLI も提供します。knowledge/ および .agents/skills/ といったプロジェクト構造の自動セットアップを含み、ベンダーロックインなしにソフトウェア工学、研究、運用において理想的な安全かつ高パフォーマンスなメモリレイヤーを届けています。本文
OKF Agent Memory v0.2:Git ネイティブな AI エージェント向け永続化記憶機能
AI エージェントのコンテキストウィンドウがリセットされる際、アーキテクチャ上の決定事項やドメインに関する知見を失う問題を解決します。本プロジェクトは、標準化されたベンダー非依存の記憶層「OKF Agent Memory」を提供し、リポジトリ直下の
knowledge/ ディレクトリに YAML フロントマターを伴うプレーンな Markdown ファイルとして実装されます。
🌟 概要とアーキテクチャ
基本理念
- 永続化記憶: コンテキストウィンドウの閉鎖による情報損失を防ぎます。
- 標準フォーマット: Google の OKF v0.2 スペックに基づいたオープンな標準を採用します。
- ギャップ埋め: 即興的な Markdown(
など)とブラックボックス化したベクトル DB の間に位置し、両者を橋渡します。CLAUDE.md
アーキテクチャのフロー
flowchart TD L1["1. OKF v0.2 スペック<br/>(規範的な Markdown と YAML フォーマット)"] L2["2. エージェント記憶の慣習<br/>(振る舞いルール:検索、レビュー、信頼性)"] L3["3. エージェントスキル<br/>(LLM プロンプトと運用ワークフロー)"] L4["4. ツールレイヤー: Go ライブラリ & CLI<br/>(決定論的なパース、バリデーション、検索、MCP)"] L5["5. プロジェクト知識コーパス<br/>(knowledge/ OKF バンドル)"] L1 --> L2 L2 --> L3 L3 --> L4 L4 --> L5
⚡ ハイライト機能
- 超高速パフォーマンス: 検索処理が**< 300µs**、グラフ検証が~4ms。メモリ内の BM25 取得とバンドル検証は、VM 起動やネットワーク遅延を必要としません。
- 100% Git ネイティブかつゼロベンダーロックイン: すべてがバージョン管理されたプレーンテキスト形式です。
やgit diff
を用いて記憶を検証・監査できます。外部データベースは一切不要です。git log - API コストなし: ローカル辞書的 BM25 インデックスにより、再帰的なベクトル埋め込み API コストやネットワーク往復遅延を排除します。
- Google OKF v0.2 準拠: 「出所」「信頼階層(生成済み対照して検証済み)」「ライフサイクルメタデータ」を完全にサポートしています。
- コンテキストの肥大化解消: 「PROGRESSIVE DISCLOSURE」(階層的な
とリンクグラフによる)を採用し、エージェントは必要な概念だけをロードします。index.md - 「検索してから記述する」原則: 記述前の既存記憶検証を義務付け、重複や虚偽の乖離を防ぎます。
- ゼロ依存関係の Go ツールチェーン: 単一実行ファイルであり、起動時間が5ms 以下。MCP サーバー (
) が組み込みされています。okf mcp - ドメイン非依存: ソフトウェア工学、コーチング、科学研究などすべての領域に適用可能です。
📊 パフォーマンスベンチマーク
Go で構築された
okf は、高頻度のエージェントツール呼び出しループ用に最適化されています。
| ベンチマーク指標 | Python / ベクトル DB ランタイム (Mem0, Letta) | Deno / Node.js ツール | OKF Agent Memory (Go) |
|---|---|---|---|
| 概念検索遅延 | 150ms – 800ms (埋め込み API + ベクトル DB) | 40ms – 120ms | < 300 µs (マイクロ秒、メモリ内 BM25) |
| 全コーパスパースとグラフ検証 | 200ms – 1.5s | 80ms – 250ms | ~4.0 ms (50+ コンセプト、双方向グラフ) |
| プロセスの冷起動オーバーヘッド | 250ms – 600ms (Python VM 起動) | 80ms – 180ms (V8 / Deno 起動) | < 4 ms (コンパイル済み単一バイナリ) |
| 1,000 クエリあたりの取得コスト | ~$0.10 – $0.50 (埋め込みトークン) | $0.00 | $0.00 (ゼロ API コスト、完全にローカル) |
| メモリーフットプリント (RSS) | ~120 MB – 350 MB | ~60 MB – 140 MB | < 15 MB |
ヒント:独自の LLM でローカルに再現する
Go のみの自動ベンチマークランナーを提供しており、あなたのローカルハードウェア(LM Studio / Ollama)で TTFT の高速化とトークン削減を検証可能です。make benchmark
🚀 クイックスタート
1. ツールのビルド
リポジトリをクローンし、単一の
okf 実行ファイルをコンパイルします。
# bin/okf に単一バイナリを生成します go build -o bin/okf ./cmd/okf
2. ベーシックな CLI コマンド
- Validate: バンドルの適合性、グラフ接続性、記述のドリフトを検証します。
./bin/okf validate knowledge --strict --drift - Search: メモリ内の BM25 スコアリングを使用して概念を検索します。
./bin/okf search "architecture layers" knowledge - Inspect: 概念とその関係性を検査します(JSON 出力可能)。
./bin/okf show architecture/layers knowledge --json - Create: 自動的な帳簿管理付きで新しい概念を作成します。
./bin/okf create decisions/auth-flow knowledge \ --type Decision \ --title "OAuth2 Authorization Flow" \ --desc "Standardized on PKCE for client authentication." - Update: 既存の概念を更新します。
./bin/okf update decisions/auth-flow knowledge \ --desc "Updated OAuth2 PKCE token refresh interval." - Bootstrap Full Stack: ターゲットプロジェクトに完全なエージェント記憶スタックをセットアップします。
./bin/okf bootstrap /path/to/project --name "My Project" - Initialize Bare Bundle: 任意のディレクトリにのみ、基本的な OKF バンドルを初期化します。
./bin/okf init my-project/knowledge
3. プロジェクトへのセットアップ(ワンコマンド)
既存または新規リポジトリに完全な OKF Agent Memory アーキテクチャを構築できます。
./bin/okf bootstrap /path/to/my-project --name "My Service"
これにより自動的に以下が設定されます:
— OKF v0.2 準拠の永続化記憶バンドル(knowledge/
,index.md
)。log.md
— エンベードされたエージェントスキル定義と機能ガイド。.agents/skills/okf-memory/
— AI コーディングエージェント向けの運用指示。AGENTS.md
— 検証 (Makefile
) および検索 (make validate
) のためのタスク。make search q="..."
4. MCP サーバーとしての利用
okf は、stdio を介したネイティブのモデルコンテキストプロトコル (MCP) サーバーを同梱しており、Claude Code や Cursor とシームレスに接続できます。
例:MCP 設定 (
claude_desktop_config.json など):
{ "mcpServers": { "okf-memory": { "command": "/path/to/okf-agent-memory/bin/okf", "args": ["mcp", "/path/to/project/knowledge"] } } }
📂 リポジトリ構造
- benchmarks/ — Progressive Disclosure ベンチマークスイートとハードウェアテストデータ。
- cmd/
— 単一の CLI とエンベードされた MCP サーバー (okf/
)。stdio
— LLM TTFT およびトークン計測用の自動ベンチマークランナー。okf-benchmark/
- docs/ — ガイド、仕様書、リリースプレイブックなど。
,AGENT_TESTING.md
,ALTERNATIVES.md
,CLI.md
など。CONVENTION.md
- examples/ — ドメイン非依存の参照 OKF v0.2 バンドル(書籍、コーチング、ソフトウェア)。
- knowledge/ — プロジェクト固有の OKF v0.2 永続化記憶バンドル。
(ルートインデックス)index.md
(変更ログ)log.md
,architecture/
,convention/
など。roadmap/
- pkg/okf/ — ゼロ依存関係を持つ Go コアライブラリ。
🧪 テストおよび検証
完全なテストスイートを実行し、リポジトリの自己ドキュメント化される知識バンドルを検証します。
go test ./... make validate
📖 追加ドキュメント
- Getting Started Guide: エージェントと人間のためのオンボーディングガイド。
- CLI & MCP Reference: 完全なコマンドラインおよびプロトコルツールの参照。
- Security & Privacy Guidelines: データガバナンス、PII 保護ルール。
- Multi-Agent Testing: テストシナリオ、互換性マトリックス、ベンチマーク。
- Why OKF Agent Memory?: 価値提案および差別化要因の解説。
📄 ライセンス
MIT ライセンス。詳細は
LICENSE ファイルを参照してください。