AIエージェントを実務で使い続けているエンジニアなら、一度は感じた不満があるはずだ。「昨日教えた内容を、今日またゼロから説明しなければならない」。セッションをまたぐたびにコンテキストを貼り直す作業が日常化している現場は少なくない。この根本的な課題に正面から向き合ったオープンソースプロジェクト「WUPHF」がHacker Newsで216ポイントを獲得し、議論を呼んでいる。

Karpathyのビジョンを、シンプルな技術スタックで実装

WUPHF（GitHub: nex-crm/wuphf）は、複数のAIエージェントが協調して働く「AIオフィス」フレームワークだ。その核心にあるのが、エージェントが読み書きを繰り返すことで文脈が蓄積し続ける知識基盤の仕組みである。

Andrej Karpathyがかねてから言及してきた「LLMネイティブな知識基盤」のビジョン——エージェントが自律的に知識を書き込み・参照し・更新するサイクルを回す——を実装したものだが、注目すべきはその技術スタックの選択にある。

多くの実装がPostgres、pgvector、Neo4j、Kafkaなどの重厚な構成を選択するなか、WUPHFはあえてMarkdown + Gitに立ち返った。

なぜMarkdown+Gitなのか

設計の根底にある思想は「ウィキはランタイムより長く生き続ける」というものだ。

  • Markdown: ツールが変わっても人間が読める。耐久性の高いフォーマット
  • Git: 変更履歴が完全に残る。「誰がいつ何を知ったか」の来歴（プロベナンス）を追跡できる
  • BM25（Bleve）+ SQLite: ベクトル検索なしで、500件・50クエリのベンチマークで再現率85%を達成

ベクトルDBは「特定のクエリクラスで再現率が閾値を下回ったときの事前決定フォールバック」として温存しており、最初から重い技術を持ち込まない設計思想が一貫している。

ノートブック→ウィキへの「昇格フロー」

WUPHFのアーキテクチャで特に興味深いのが昇格フロー（promotion flow）だ。

  • ノートブック: 各エージェントが作業中の観察・仮説・暫定的な結論を書き込む（エージェントごとのプライベート領域）
  • 昇格: 繰り返し使えるプレイブック・検証済みファクト・確定した設定など、「永続する価値がある情報」を正規ウィキへ昇格。バックリンクが自動付与される
  • エンティティファクトログ: team/entities/{kind}-{slug}.facts.jsonl に追記型で蓄積。N件ごとに合成ワーカーがエンティティサマリーを再生成

さらに、コミット履歴には「Pam the Archivist」という専用のgitアイデンティティが使われる。git log を見るだけで「AIエージェントが書いた記録」と「人間が書いた記録」が一目で区別できる。来歴管理として、シンプルながらエレガントなアプローチだ。

毎日実行されるlintクロンが矛盾・陳腐化エントリ・壊れたウィキリンクを検出し、知識ベースの品質を維持する仕組みも備わっている。

実務への影響

「1タスク=1セッション」という前提を超える

現在、多くの現場でAIエージェントを活用する場合「1タスク=1セッション」が暗黙の前提になっている。しかしWUPHFが示すように、エージェントが共有知識基盤を持つことで「前のエージェントが学んだことを次のエージェントが活用する」ループが成立する。これはエージェントの実用性を根本から変えうる変化だ。

軽量スタックからの出発

「AIのバックエンドには高性能ベクトルDBが必要」という思い込みを再考させる実装だ。Markdown + Git + SQLiteという手元にあるツールで出発し、必要になったらベクトル検索を追加するという順序は、多くのプロジェクトで参考になる。

セルフホスト・BYOKの選択肢

WUPHFはMITライセンスのセルフホスト型で「Bring Your Own Keys（BYOK）」方式だ。企業データをクラウドサービスに送らずに運用できるこのアーキテクチャは、セキュリティ要件が厳しい金融・製造・医療分野の日本企業にとって特に重要な選択肢となる。

筆者の見解

AIエージェントを「単発の指示→応答」で使い続ける限り、その能力は半分も引き出せない。エージェントが自律的にループで動き続けるためには、文脈を蓄積できる知識基盤が必要だ——これはごく当たり前の命題に見えるが、実装したシステムはまだ驚くほど少ない。

WUPHFのMarkdown+Gitという選択は一見古風に映るかもしれないが、筆者はむしろこれが本質に近いと見ている。耐久性・可搬性・来歴管理——これらは10年後も価値を保つ性質だ。pgvectorもNeo4jも、5年後に同じ場所にいるかどうかはわからない。シンプルな選択が長期的に強い、というのはソフトウェア設計の普遍的な教訓でもある。

「毎朝コンテキストを貼り直す」という現実から、「前回の続きから始める」世界への移行。その移行を支える知識基盤の設計が、これからのエージェント活用の重要テーマになると確信している。WUPHFはその方向性を示した一つの実装として、追いかける価値がある。

出典: この記事は Show HN: A Karpathy-style LLM wiki your agents maintain (Markdown and Git) の内容をもとに、筆者の見解を加えて独自に執筆したものです。