Lore: Repurposing Git Commit Messages as a Structured Knowledge Protocol for AI Coding Agents

この論文は、AI コーディングエージェントがコードの差分だけでなく意思決定の背景(制約や却下された代替案など)を保持できるよう、Git のネイティブ機能であるトレーラーを活用してコミットメッセージを構造化された意思決定記録に変換する軽量プロトコル「Lore」を提案するものです。

Ivan Stetsenko

公開日 2026-03-17
📖 1 分で読めます☕ さくっと読める

Each language version is independently generated for its own context, not a direct translation.

この論文は、**「AI がプログラミングをする時代において、なぜ過去の『理由』が失われてしまうのか」という深刻な問題と、それを解決する「とてもシンプルで賢い方法」**について書かれています。

タイトルは『Lore(ロア)』。これは「伝説」や「口承の知恵」という意味ですが、ここでは**「コードの背後にある『なぜ』を記録する新しいルール」**として使われています。

以下に、難しい専門用語を排除し、身近な例え話を使って解説します。


🕵️‍♂️ 問題:「影」が積み重なる悲劇

(Decision Shadow:決定の影)

Imagine(想像してください):
あなたが料理を作っているとき、レシピ(コード)には「卵を 3 個入れる」と書かれています。でも、**「なぜ 3 個なのか?」「2 個では甘すぎるから?」「4 個だと崩れちゃうから?」**という「理由」はレシピには書かれていません。

もし、その料理を作った人が「卵は 3 個がベストだ」という理由を口頭でしか言わず、その場を去ってしまったらどうなるでしょう?
次に料理をする人が(あるいは AI が)そのレシピを見ると、「卵を 3 個入れる」という事実しか分かりません。

  • 今の状況: プログラミングの世界でも、コードの変更履歴(Git のコミット)には「何を変えたか(卵を 3 個入れた)」は記録されていますが、「なぜそう変えたのか(2 個では甘すぎるから)」という「理由」は捨てられています。
  • この捨てられた「理由」を著者は「決定の影(Decision Shadow)」と呼びます。
  • 問題点: AI がコードを書く時代になると、AI は「何を変えたか」は読めますが、「なぜそうなのか」という理由が分からないため、間違った判断をしてしまったり、過去に「ダメだと分かった方法」をまた試してしまったりします。

💡 解決策:「レター」を「手紙」にする

(Lore プロトコル)

著者は言います。「特別な新しいシステムを作る必要はありません。すでに持っている『手紙(コミットメッセージ)』の書き方を変えるだけでいいんです!」

今のコミットメッセージは、単なる「荷物のラベル」のようなものです。

「修正:ログイン機能のバグを直しました」
(中身:コードが変わったことだけが書かれている)

Lore(ロア)では、このラベルを「手紙」に変えます。
手紙には、コードの変更内容だけでなく、**「思考の過程」**を記録します。

📝 Lore の手紙の書き方(例え話)

料理のレシピ変更の手紙を想像してください。

件名: 卵を 3 個に増やしました

本文:

  • 制約事項: 卵のサイズは S しか使えない(スーパーで売っていない)。
  • 却下された案:
    • 「卵を 4 個にする」→ 焼きすぎで固くなりすぎる(NG)。
    • 「牛乳を足す」→ 味が薄くなりすぎる(NG)。
  • 指示: 将来、卵のサイズが変わったら、このレシピは再検討が必要。
  • テスト済み: 3 個なら、10 分加熱で完璧に固まることを確認。

このように、**「なぜ 3 個なのか」「他の案はどうだったか」「将来の注意点」**を、コードの変更と一緒に記録するのです。

🛠️ どうやって実現するの?(技術的な話)

実は、これを実現するために新しいサーバーや巨大なデータベースは一切必要ありません

  1. Git の「 trailers(トレーラー)」機能を使う:
    Git(バージョン管理ツール)には、手紙の最後に「宛名」や「署名」を書くような機能(トレーラー)が最初からあります。Lore はこの機能を賢く使います。

    • Constraint: 卵のサイズは S しか使えない
    • Rejected: 4 個は NG
    • Directive: 将来の修正者はここを確認せよ
  2. AI が読むための「辞書」を作る:
    AI がこの手紙を素早く読むために、簡単なコマンドラインツール(CLI)を用意します。

    • 「このファイルの『過去の失敗談(却下された案)』を教えて」
    • 「このコードの『制約条件』は何?」
      と AI が質問すると、Lore ツールが即座に答えを返します。

🌟 なぜこれがすごいのか?

  • インフラ不要: 特別なシステム導入費は 0 円。Git がある場所ならどこでも使えます。
  • AI との相性抜群: AI は「手紙(テキスト)」を読むのが得意です。AI がコードを書くとき、この「手紙」を読んで「あ、過去に 4 個はダメだったんだな」と学習すれば、失敗が減ります。
  • 時間を超えた知恵: 10 年後に誰かが(あるいは別の AI が)そのコードを見ても、「なぜこの変な書き方をしてるのか?」が手紙に書いてあれば、すぐに理解できます。

🚀 まとめ:伝説(ロア)の復活

この論文の核心は、**「コードの変更履歴を、単なる『記録』から『知恵の貯金箱』に変えよう」**という提案です。

  • 今の状態: コードは残るが、知恵(理由)は消える。
  • Lore の提案: コードと一緒に「理由」も手紙として残す。

AI がプログラミングの主力になる未来において、この「手紙(Lore)」が、過去の失敗や知見を未来に繋ぐ**「伝説(ロア)」**となり、より賢く、安全なソフトウェア作りを可能にするでしょう。

まるで、**「過去の職人が、新しい弟子に『なぜこうするのか』をメモ書きで残してくれる」**ようなイメージです。それだけで、徒弟は迷子にならずに済むのです。

このような論文をメールで受け取る

あなたの興味に合わせた毎日または毎週のダイジェスト。Gistまたは技術要約を、あなたの言語で。

Digest を試す →