AI エージェントで仕様修正が反映されない問題の原因と解決（セッション分離設計）

結論

AI エージェントの「修正が無視される問題」は、セッション内コンテキストの慣性が原因であり、セッション分離＋ファイルベース仕様チェーン化によって解決できる。

やりたいこと

問題

同一セッション内で AI エージェントに対して仕様修正や追加指示を行った場合、それが正しく反映されない。

具体的な挙動：

• 修正指示が無視される
• 初回出力の設計を前提に再実装される
• 最新指示より過去コンテキストが優先される

原因

本問題は LLM のコンテキスト保持特性に起因する。

主な構造要因：

• 初期プロンプトの強い優先保持（initial context anchoring）
• 後続指示の上書き耐性の低さ
• セッション内での「一貫性維持バイアス」

結果として、

「修正指示」よりも「初期設計の整合性維持」が優先される状態になる。

解決方法

コンテキスト依存を排除し、設計情報をセッション外に退避する構造へ変更する。

採用構造

• セッション分離によるコンテキスト遮断
• 仕様・設計・実装をファイルベースで引き継ぎ
• 修正系処理は別セッションとして分岐（/fork）

セッション設計

• PlanSession：設計フェーズ
• MainSession：実装フェーズ
• BugFixSession：修正フェーズ
• ResolveSession：統合・解決フェーズ

ハマりポイント

• 同一セッションでの修正は「上書き」ではなく「解釈追加」として扱われる
• AI は最新命令よりも整合性のある過去設計を優先しやすい
• 修正を強制するにはコンテキストの物理分離が必要

補足

本問題は「プロンプトインジェクション」ではなく、

**セッション内部の優先順位バイアス問題（context inertia problem）。

そのため、

• 指示の強さでは解決しない
• 構造（セッション・ファイル分離）でしか制御できない

再発防止設計（運用ルール）

• セッション開始時に
  /rename

で役割固定 - 仕様は必ずファイルで引き継ぐ

• 修正は必ず別セッションへ分離

対象環境

• Unity 6.3 LTS
• Windows 11
• OpenAI Codex v0.0128
• Visual Studio Code 1.109.5

[[20260-05-09-unity-ai-making]]