OKF エージェントメモリ - AI コーディングエージェントのための Git ネイティブ永続メモリ

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(
    CLAUDE.md
    など)とブラックボックス化したベクトル DB の間に位置し、両者を橋渡します。

アーキテクチャのフロー

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.5s80ms – 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"

これにより自動的に以下が設定されます:

  • knowledge/
    — OKF v0.2 準拠の永続化記憶バンドル(
    index.md
    ,
    log.md
    )。
  • .agents/skills/okf-memory/
    — エンベードされたエージェントスキル定義と機能ガイド。
  • AGENTS.md
    — AI コーディングエージェント向けの運用指示。
  • 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/
    • okf/
      — 単一の CLI とエンベードされた MCP サーバー (
      stdio
      )。
    • okf-benchmark/
      — LLM TTFT およびトークン計測用の自動ベンチマークランナー。
  • 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
ファイルを参照してください。

同じ日のほかのニュース

一覧に戻る →

2026/09/06 5:31

民間ドイツのロケットが歴史を刻み、欧州大陸から軌道への到達に成功

## Japanese Translation: Isar Aerospace は、先行の課題を克服し、Spectrum ロケットが 2 回目の飛行を成功裡に完了して軌道到達を果たしたことで歴史的なマイルストーンを達成しました。この発射は「Onward and Upward」と題され、9 月 5 日にノルウェー北部(Andøya Space Center)で行われ、第二段階は楕円軌道(近地点 180 km、遠地点 500 km)に安定しました。この成功は、3 月の事故(予期せぬバルブの作動と姿勢制御喪失により発生)に続く広範な工学努力を検証しています。調査ではこれらの始発事象が特定されました。計画されていた 1 月の発射は、各種要因—including 圧力化バルブの課題、複合容器からの漏れ、流体系挙動、侵入したボート、および天候—により遅延しましたが、チームは最終的に 5 基のキューブサットと 1 つ展開不能な科学実験を搭載して発射に踏み切りました。現在、ミッションの完全な成功は、軌道の円化後にペイロードを展開することによります。95 フィートの高さを持つ二段階ロケットは、低地球軌道へ約 1,000 キログラムを運ぶことができます。ミュンヘンの施設が年間 30 基以上を製造できる能力を有する中、Isar は小型から中型の衛星に対する主要な主力機として位置づけられます。これはロシアの decades-long の Plesetsk コズモドロームでの優位性と異なり、ヨーロッパにおける能力の変化を意味しますが、この成就是 Isar を信頼できる新規プレイヤーとして確立し、Spectrum 上級エンジニア Nikolaos Perakis が率いる工学チームのレジリエンスを検証するものです。

2026/09/06 7:08

プログラマがLAN について信じている虚偽

## 日本語訳: 元の要約は実際にかなり強力です。要点リストの断片的な箇条書きを、ネットワーク複雑性に関する一貫した物語に成功裏に統合しています。ただし、リストに含まれるすべての具体的な技術的なニュアンスが失われず、かつ文脈の流れを損なわずに明確に反映されるよう確保するため、欠落していたプロトコル名と ARP の精度に関するニュアンスを取り入れた若干精査されたバージョンを以下に示します: ## 改善された要約 主要な洞察は、ローカルエリアネットワーク(LAN)がデバイス識別および通信のために複雑で、場合によっては一貫性のないメカニズムに依存しており、技術的なニュアンスが信頼性に著しい影響を与えるという点にあります。単純な 1 対 1 のマッピングとは異なり、ネットワークアドレスは常に一意ではありません。MAC アドレスは世界全体で一意となることを意図した 48 ビットで構成されていますが、それらは単一のデバイスではなく異なるインタフェースを表すことがあり、また真の一意性を欠いている場合があります。同様に、IP(および歴史的に IPX/SPX、AppleTalk など)のようなプロトコルが通信を標準化するものの、ホストは中央の DHCP サーバーから有効なアドレスを受信しえないことが多く、予約された「リンクローカル」IP(例:169.254.0.0/16)を持ってしまい、その結果、ホストの発見は mDNS などの可変的な手法に依存し、ホスト名の一意性はローカルであってグローバルではなく、ARP リクエスト——一般的には IP ごとに一つの答えが返される——であってもエントリの精度を保証するものではありません。さらに、LAN の性能は接続の種類によって異なります;より高速なイーサネットでも低速な Wi-Fi でも、最大転送ユニット(MTU)の違いがピア間の接続障害を引き起こす可能性があります。したがって、ネットワーク管理者は安定した運用を確保するために、これらの多様なプロトコルスタック、潜在的なアドレスの一貫性問題(NAT を含む)、および可変的な発見メカニズムを考慮に設計された堅牢なシステムを実装する必要があります。

2026/09/01 16:31

Show HN: フライバイ ~レトロな双葉機飛行ゲーム~

## 日本語訳: 要約: 本テキストは、航空業界標準の操縦系を模倣した専用のゲーム設定をご紹介します。具体的には、「引き上げで上昇」する逆 Y(インバーティッド・Y)のような構成であり、没入感のあるフライトシミュレーションを実現します。高忠実度なリアルさを特徴とする大気風の影響や飛行機エンジンのサウンドエフェクトなどの機能と、画面タッチ操作といったモダンな利便性、オプションの儀表盤表示の切り替えを組み合わせます。視覚スタイルはレトロ CRT スキャンラインフィルタにより向上し、ゲームプレイの深みについてはスピードブーストや機関銃などのパワーアップを通じて拡大されます。このハイブリッドな構成により、本格的な飛行物理現象を楽しむシミュレーション愛好家と、アクセスしやすいメカニクスを好むカジュアルゲーマーの両方が、モダンな利便性を損なうことなく満足できます。