context-retrospective

コンテキストネットワークの振り返り

目的

エージェントとユーザーのやり取りのトランスクリプトを分析し、コンテキストネットワークの保守上のニーズとガイダンスの改善点を特定します。ネットワーク構造とエージェントへの指示の両方を強化するため、実行可能な知見を抽出します。

基本原則

すべてのやり取りから学びます。 各トランスクリプトから、コンテキストの不足、ナビゲーション上の問題、ガイダンスの問題が明らかになります。これらは体系的に解決できます。

---

分析の観点

1. ナレッジギャップの特定

確認する点：

• 既存のコンテキストから回答できなかった質問
• タスク中に見つかり、事前に文書化しておくべきだった情報
• 同じ情報を繰り返し探していた箇所
• 構造、関係性、依存関係についてのエージェントの混乱

質問：

• どのような基礎知識が欠けていましたか？
• 文書化されていなかった関係性はどれですか？
• 履歴、決定事項、制約について、どのようなコンテキストが欠けていましたか？
• どのドメイン境界が不明確でしたか？

出力： 不足している情報ノードと関係性のギャップ

---

2. コンテキスト境界の違反

確認する点：

• コンテキストネットワークの外部に作成された計画ドキュメント
• コンテキスト領域に配置された実装ファイル
• 情報の配置場所についてのエージェントの迷い
• 1つのドキュメント内に混在する関心事

質問：

• エージェントはコンテキストとプロジェクト成果物を区別できていましたか？
• 「計画はコンテキストネットワーク内に留める」というルールは守られていましたか？
• 今後の混乱を防ぐには、どのようなガイダンスが必要ですか？

出力： 境界違反と必要なガイダンスの改善点

---

3. ナビゲーションと情報発見のパターン

確認する点：

• エージェントが情報を見つけた方法（または見つけられなかった方法）
• 情報にアクセスした順序
• 行き止まりや非効率な経路
• 関連付けておくべきだった情報

質問：

• エージェントはどのようなナビゲーション経路をたどりましたか？
• どの情報をより見つけやすくする必要がありますか？
• 欠けていた論理的なつながりは何ですか？
• 効率を高めるには、どのようなハブドキュメントが必要ですか？

出力： ナビゲーションの改善点と不足しているつながり

---

4. タスクとコンテキストの適合性

確認する点：

• タスクのニーズと利用可能なコンテキストの不一致
• 抽象度が適切でない情報
• 詳細すぎる、または大まかすぎるコンテキスト
• 組織上の弱点を示すタスクのパターン

質問：

• タスクに適した抽象度で情報が提供されていましたか？
• コンテキストは意思決定に必要な情報を支えていましたか？
• 情報の構成によって認知負荷が高くなっていませんでしたか？
• この種のタスクを支援するには、どのような再構成が必要ですか？

出力： 抽象度の調整と再構成の必要性

---

5. 関係性のマッピングにおける不備

確認する点：

• 依存関係の理解におけるエージェントの困難
• 変更が他の領域に与える影響についてのコンテキストの不足
• 明確なインターフェース定義の不足
• 明示すべき暗黙の関係性

質問：

• どのような関係性が暗黙のままで、文書化されていませんでしたか？
• タスク中にどの依存関係が見つかりましたか？
• どの影響関係が不明確でしたか？
• 明示的に文書化しておけば役立った箇所はどこですか？

出力： 不足している関係性と文書化の必要性

---

6. ガイダンスの有効性

確認する点：

• ガイダンスが不明確であることを示すエージェントの行動
• 最適なパターンから逸脱したタスクへの取り組み方
• モード切り替えの判断とその妥当性
• 制約に照らしたツールの使用状況

質問：

• エージェントはモードに適したパターンに従っていましたか？
• モード間の移行は効果的に行われましたか？
• どのようなガイダンスが不足している、または不明確でしたか？
• 制約は目的を支えていましたか？

出力： ガイダンスの改善とルールの明確化

---

振り返りのプロセス

フェーズ 1：準備

1. コンテキストの収集

   • 現在のコンテキストネットワークの状態を読み込む
   • 使用されたエージェントのモードを特定する
   • タスクの種類と複雑さを記録する
   • 該当するルールを確認する

2. ベースライン

   • タスク開始時に利用可能だったコンテキストをマッピングする
   • 有効なガイダンスを特定する
   • 最近のネットワークの変更を記録する
   • 期待された動作と実際の動作を記録する

フェーズ 2：トランスクリプトのレビュー

1. 時系列分析

   • 情報を探すパターンを追跡する
   • コンテキストが選択に影響した判断時点を記録する
   • 苦労した箇所を特定する
   • 実際のナビゲーション経路をマッピングする

2. 重大な事象

   • 混乱や非効率を記録する
   • 境界違反を特定する
   • 情報の「再発見」を記録する
   • より適切なコンテキストが役立った箇所を示す

3. パターン認識

   • 繰り返し発生する情報ニーズ
   • 知識領域における体系的な不足
   • 一貫して発生するナビゲーションの困難
   • コンテキストの効果的な活用

フェーズ 3：ギャップ分析

1. 情報アーキテクチャ

   • ナレッジカバレッジのギャップをマッピングする
   • 抽象化の適切さを評価する
   • 関係性の網羅性を評価する
   • ナビゲーションの有効性を確認する

2. ガイダンスシステム

   • モード固有のガイダンスを分析する
   • 境界ルールの明確さを確認する
   • 指示の完全性を評価する
   • プロンプトのオーバーライドの必要性を評価する

3. 優先順位付け

   • 重大： タスクの失敗または大幅な非効率を引き起こした
   • 高： リアルタイムでの発見が必要だった
   • 中： 効率性を高める可能性がある
   • 低： あると望ましい改善

---

分析テンプレート

ナレッジギャップ

## Gap: [Name]

**Discovery Context:** [When/how revealed]
**Task Impact:** [How it affected completion]
**Information Type:** [Domain/Process/Relationship/Decision criteria]
**Recommended Action:** [Specific node or relationship to add]
**Priority:** [Critical/High/Medium/Low]
**Related Gaps:** [Connected gaps]

ナビゲーションの問題

## Issue: [Name]

**Problem Pattern:** [What difficulty occurred]
**Information Sought:** [What agent wanted]
**Current Path:** [How agent actually found it]
**Optimal Path:** [How it should be discoverable]
**Recommended Improvement:** [Specific changes]
**Affected Tasks:** [What else would benefit]

ガイダンスの評価

## Guidance: [Mode/Rule Area]

**Expected Behavior:** [What guidance should produce]
**Actual Behavior:** [What agent did]
**Deviation Analysis:** [Why different]
**Guidance Clarity:** [Current clarity level]
**Recommended Changes:** [Specific modifications]
**Test Scenarios:** [How to validate]

---

品質指標

完全性

• 情報カバレッジ： コンテキストから回答できる質問の割合
• 関係性の網羅性： 文書化された関係性と発見された関係性の比較
• ナビゲーション効率： ステップ数と最適な経路の比較
• 境界の遵守： 正しいドメイン配置の割合

有効性

• タスク完了の品質： 利用可能なコンテキストでの成功率
• エージェントの確信度： 不確実性を表明する頻度
• コンテキストの活用： 関連するコンテキストが実際に使われた割合
• 発見と参照： 新たな発見と既存情報の利用の比較

進化

• コンテキストネットワークの成長： 新しいノード／関係性の増加率
• ガイダンスの改善： ルールの更新頻度
• パターン認識： 繰り返し見られる改善テーマ
• システムの成熟度： 構造変更の減少

---

よくあるパターンと解決策

パターン	解決策
同じ情報を繰り返し探す	ハブドキュメントを作成し、リンクを改善する
ファイルの配置に関する混乱	例を使って境界ガイダンスを強化する
タスクのコンテキストが分散している	タスク固有のエントリーポイントを作成する
コンテキストを確認せずに判断する	「実行前に確認する」ガイダンスを強化する
情報の抽象度が適切でない	段階的な開示ができる複数レイヤーのノードを作成する

---

実装の優先順位

フェーズ 1：重要な基盤

• 境界違反を修正する
• 不足している基礎知識を追加する
• 壊れた関係性を修復する

フェーズ 2：ナビゲーションの強化

• 見つけやすさを改善する
• ハブドキュメントを作成する
• ドメイン間のつながりを強化する

フェーズ 3：ガイダンスの改善

• モード固有の指示を更新する
• 曖昧なルールを明確にする
• よくあるタスク向けのプロンプトを強化する

フェーズ 4：最適化

• 抽象度を微調整する
• 発見されたワークフローに合わせて最適化する
• メタデータシステムを強化する

---

アンチパターン

1. 責任の押し付け合い

パターン： やり取りの失敗をコンテキストの不足ではなく、エージェントの能力のせいにする。「エージェントは知っているべきだった……」 失敗する理由： エージェントはコンテキストに基づいて動作します。コンテキストが不完全であれば、能力の高いエージェントでも失敗します。エージェントを非難すると、システム全体の改善が妨げられます。 対処法： まずコンテキストの不足を疑います。「なぜエージェントは推測できなかったのか？」ではなく、「どの情報があればこれを防げたか？」と問いかけます。

2. 完全性の錯覚

パターン： コンテキストネットワークですべてを把握できると思い込むこと。あらゆる失敗を防ごうとして、情報を次々に追加します。 失敗する理由： コンテキストネットワークは際限なく拡大します。情報の検索が不可能になり、シグナル対ノイズ比が低下します。メンテナンスも持続不可能になります。 対処法： 影響の大きいギャップに焦点を当てます。実際に失敗の原因となったものを優先します。新しい情報を追加するのと同じくらい積極的に、古くなった情報を削除します。

3. 表面的な修正

パターン： パターンを特定せずに、個別の問題だけを修正すること。情報が欠けていた理由を問わず、欠けていた事実を追加します。 失敗する理由： 原因ではなく症状に対処しています。同じ種類のギャップが別の場所で発生します。もぐら叩きのようなメンテナンスになります。 対処法： ギャップを種類ごとに分類します。ギャップが「関係性のドキュメントがない」ことであれば、関係性の記録方法を改善します。関係性を1つ追加するだけでは解決しません。

4. 振り返りだけに終始する

パターン： 振り返りを実施しても、変更を一度も実装しないこと。分析麻痺、または行動の回避です。 失敗する理由： 行動につながらない気づきからは改善が生まれません。分析を実装せずに積み上げると、分析に費やした労力が無駄になります。 対処法： すべての振り返りで、実行可能な変更を少なくとも1つ生み出す必要があります。振り返りを終える前に、変更の実装を予定に組み込みます。

5. ガイダンスの過剰

パターン： 失敗のたびにルールや制限を追加すること。コンテキストネットワークが制約のリストになります。 失敗する理由： 過剰なガイダンスは行動を麻痺させます。エージェントは行動を恐れるようになります。ガイダンス同士が矛盾し、誰もルールを読まなくなります。 対処法： ガイダンスを追加する前に、削除することを検討します。複雑にする前に、シンプルにします。ルールを増やすよりも、境界を明確にするほうが効果的かどうかを試します。

統合ポイント

入力：

• 重要なエージェントとのやり取りの後
• タスクの失敗や非効率があった後
• コンテキストネットワークのメンテナンス中

出力：

• コンテキストネットワークの更新へ
• ガイダンス／指示の改善へ

補完関係：

• Context Networks フレームワーク
• エージェントモードの設定