0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【アーキテクチャ考察】「更新はAgent」パターンの落とし穴:git blameが全部Agentになる問題と「帰属」の設計

0
Posted at

最近、LLM Agentの運用やシステム設計において、非常にエレガントなパラダイムをよく目にするようになりました。

それは、「判断は人間が、更新はAgentが、計算はスクリプトが行う」というアプローチです。

状態変更のエントリポイントを単一のSub-Agentに集約し、決定論的なロジックはスクリプトに任せ、人間は「判断」の権限だけを握る。ファイルを Single Source of Truth(SSoT)とし、すべてのビューをそこから派生させるアーキテクチャです。

このパラダイムは実に見事です。特に「状態の書き換えは単一のAgentのみが実行する」という Single Writer(単一の書き手) の思想は、構造的に不整合の大部分を排除してくれます。個人開発レベルでは、控えめに言って完璧なDX(Developer Experience)をもたらします。

しかし、筆者のチームでAgent向けの「メモリ層(Memory Layer)」を構築している中で、「更新をAgentに任せる」というアーキテクチャには、ある重大なトレードオフが潜んでいることに気づきました。

書き手が「一つ」に集約された瞬間、ある別のものまで強制的に一つにまとめられてしまいます。
それは「誰が、なぜ、何を書き換えたのか」——すなわち「帰属(Attribution)」です。

⏳ TL;DR

  • 「更新はAgentに」= Single Writer は、システムの一貫性担保において現時点の最適解。
  • しかし書き手が唯一になるため、変更の帰属も単一化され、git blame をしても全行が同じAgentを指すようになる。
  • 「振る舞いの分業(誰が更新するか)」とは直交する軸として、「誰が何を書けるか(権限)」「誰の判断に基づいているか(帰属)」「意味的単位で取り消せるか(ロールバック)」を管理する「メモリガバナンス」の設計が不可欠。
  • 実装のアプローチ: まずは Git Commit Trailer で最小限の実装を行い、マルチActorの複雑なフェーズに入ってから外部ストレージ化を検討する。

Single Writer + Git は個人開発なら「無敵」

Agentを唯一の書き手とし、Gitでファイルを管理する。
こうすれば、変更履歴、Diff、ロールバック機能がほぼゼロコストで手に入ります。

Agentに「ファイル名=タイトル」「Frontmatterの規約」「Statusの遷移ルール」といった十数個の不変条件(Invariant)を守らせるだけで、手動でMarkdownをメンテする際のあの「エントロピーの増大」は綺麗に消え去ります。これは大いに見習うべき設計です。

しかし、Actor(参加者や別Agent)が増え始めると問題が露呈します。
チームでの共有、Agentのスケールアウト、あるいは「3ヶ月後の自分」という名の他人が介入した時です。

課題:書き手が唯一になる =「判断の帰属」が失われる

具体的なシーンを見てみましょう。Single Writerアーキテクチャでは、コミット履歴は往々にして以下のようになります。

$ git log --oneline tasks/items/ClientA_Project/QA.md
a1b2c3d task: update status todo→done
e4f5g6h task: add task QA

# Author はすべて task-manager (Agent) になっている

ここで git blame を実行しても、すべての行のAuthorはAgentです。状態の一貫性は完璧に保たれています。

しかし3ヶ月後、「なぜこのQAタスクはDoneになっているんだ? 誰がクローズを判断したんだっけ?」と経緯を追いたくなった時、履歴は何も語ってくれません。Agentが書き換えたことは分かっても、それが「誰の判断に基づくものか」がブラックボックス化しているのです。

「判断は人間がしている」とプロセス上は定めていても、システム(記録)上では書き込みが行われた瞬間に判断の主体がAgentに上書きされ、「判断者」が消え去ってしまいます。

「判断権を人間が持つ設計」と、「判断の痕跡を残す設計」はイコールではありません。

解決策:「メモリガバナンス(Memory Governance)」という概念

「判断 / 更新 / 計算」という振る舞いの軸に対して、直交するもう一つの次元を定義する必要があります。筆者はこれを「メモリガバナンス」と呼んでいます。

これは「誰がどのような権限で共有状態(Shared State)に書き込めるか」を管理するもので、以下の3つのコンポーネントから成ります。

コンポーネント コアとなる問い
書き込み権限 (Permission) どのActor/Agentが、どのフィールドを変更できるのか?
帰属 (Attribution) 今回の書き換えは、誰の判断とどの指示に基づくものか?
取り消し (Revert) 「意味的な単位」で特定の書き換えだけを正確にロールバックできるか?

現場では「自分のタスクだけ書き戻す」「他人のものはRead-Only」といった運用ルールでカバーされがちですが、これをアーキテクチャのトップレベル設計に組み込む必要があります。

具体的な実装アプローチ

Single Writerの利点を壊さずに、帰属と取り消しの能力を補完するためのステップは以下の通りです。

1. Git Commit Trailer による「帰属」の記録

Agentが書き込む際、元の指示、理由、依頼者をコミットメッセージの Trailer(またはファイルの Frontmatter)に構造化して記録させます。

task: close QA

Instructed-by: human
Reason: Client Aからの口頭通知による受け入れ完了
Trace: daily-2026-07-09

これにより、後から git log --grep="Instructed-by: human" で「人間の判断に基づいてクローズされたタスク」を事後検索できるようになり、判断の主体が履歴に残ります。

2. フィールド単位の権限の明示化

すべてのフィールドに対してAgentに無条件での変更を許可してはいけません。

  • status を done にする ➔ 人間の承認(指示)が必要
  • estimate(見積もり)の更新や依存関係のフォーマット整理 ➔ Agentの独断で実行可能

このように、不変条件の定義と共に、フィールドレベルでの権限(RBACのような概念)を持たせます。

3. 意味的単位(Semantic Unit)でのコミット

「1回の論理的な書き換え」が「1つのコミット」に対応するようにAgentの動作を制御します。
これにより、ファイル全体を単純に revert するのではなく、「あの時の見積もり更新だけをロールバックする」といった意味的単位での取り消しが可能になります。

小〜中規模な運用であれば、Gitの機能とAgentのプロンプト/ツール制御だけで十分に実装可能です。

Gitベースの限界と、外部ストレージ化のタイミング

多くの場合、上記のアプローチで十分ですが、以下の要件が同時に求められるようになると、Gitの枠組みでは限界を迎えます。

  1. 構造化された帰属のクエリ: grepではなく、「先週、Agentが人間の口頭指示に基づいて書き換え、その後また撤回した内容」をSQL等で構造化検索したい場合。
  2. マルチAgent構成: 書き手が単一の task-manager ではなくなり、複数のツール間で統一された書き込み権限を強制したい場合。
  3. 状態のオントロジー化: タスクファイルだけでなく、Agentが参照するナレッジベースや記憶のグラフ構造に対しても同様の帰属・取り消しメカニズムが必要な場合。

筆者のチーム(MemoryLakeプロジェクト)では、このフェーズに直面したため、書き込み権限・帰属・取り消しのメカニズムを共有メモリの「ファーストクラス・シチズン」として扱い、専用のストレージ層で管理するアプローチをとっています。

💡 Tips: すべての書き込みに帰属は不要
フォーマットの整形やビューの再生成といった「決定論的な書き込み」には、帰属情報(依頼者や理由)は不要です。クローズ処理や優先度の変更など、状態を変化させる「判断を伴う書き込み(Judgmental Writes)」に対してのみ、帰属のトラッキングを行うのがベストプラクティスです。

✅ マルチActor拡張前のチェックリスト

Agentシステムを複数人・複数Agentが触る環境へスケールさせる前に、以下の要件を満たしているか確認してみてください。

  • Agentの書き込み(コミット)に「誰の判断に基づくか」の痕跡が残っているか?(git blameがすべてAgentになっていないか)
  • フィールド(またはプロパティ)単位で書き込み権限が明確に定義されているか?
  • 意味的な単位で、特定の書き換えを正確にロールバックできるか?
  • 権限と帰属のルールは、運用カバーではなく明示的な設計として定義されているか?
  • 帰属の記録は「判断を伴う書き込み」にフォーカスし、ノイズを減らせているか?

まとめ

「判断は人間が、更新はAgentが、計算はスクリプトが」という設計は、これからのLLMアプリケーションにおいて非常に強力なパターンです。

だからこそ、「書き手を一つに絞るなら、同じパイプラインの中に『その書き手は誰の判断で動いたのか』という痕跡も残すべきである」という点を強調したいと思います。

判断権を人間の手に残すだけでなく、「判断の痕跡」が永続化されることを担保して初めて、「更新はAgentに」というアーキテクチャは真価を発揮します。
Agentアーキテクチャを設計・運用している皆さんの参考になれば幸いです。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?