プロジェクトレジャー：AIコーディングエージェントのためのヒューマン・イン・ザ・ループ記憶システム

GitHubプロジェクト「project-ledger」は、AIコーディングエージェントがコードベースについて記憶する内容を人間が管理するためのヒューマン・イン・ザ・ループシステムを提供します。その核心的な課題は、エージェントが何が重要かを判断できないことです。実装上のバグとアーキテクチャ上の欠陥を同じように扱い、何を変更したかではなく、何が重要かを記録します。

仕組み

このシステムには3つの主要な構成要素があります：

• YAML台帳 - 要約、信頼度レベル、タグ、相互参照を含む構造化されたエントリ
• /ledgerスキル - エントリを公開し、Haiku監査人を自動的に起動して客観的にレビューする
• UserPromptSubmitフック - すべてのプロンプトに対してTF-IDF検索を実行し、エージェントが思考を開始する前に一致するエントリを自動的に注入する

このフックは重要です。これがないと、ただYAMLを無意味に書いているだけになります。ソースで指摘されているように：「エージェントは指示されなければ参照ドキュメントを読みません。このフックはすべてのプロンプトで実行され、台帳を検索し、エージェントが思考を開始する前に関連するエントリを注入します。」

実用例

作成者は実際の使用例を説明しています：組み込みプロジェクトの色レンダリング問題を修正して数週間後、「以前にこれを修正したときのことを覚えている？」とエージェントに尋ねました。フックは、低い値での8ビット量子化が色忠実度を損なうという正確なエントリを表示しました。根本原因、閾値、影響を受けるコンポーネントを含みます。

比較とアプローチ

OpenVikingと比較すると、このシステムは手作業を必要としますが、よりシンプルなアーキテクチャを持っています：バックエンドなしで、YAMLファイルとシェルフックだけです。その哲学は、洞察が得にくいプロジェクトでは、何を引き継ぐかを人間が決定すべきだというものです。

このシステムは、AIエージェントがコードベースで操作する際の技術的負債の蓄積を防ぐように設計されています。適切な文脈なしでは、各変更が正しく行うのが難しくなります。