reviewing-memory

メモリのレビュー

MCP のショートカット： doctrine MCP サーバーが接続されている場合は、 機械で解析可能な JSON 結果とバックリンクを取得するため、doctrine memory show の代わりに MCP ツール経由で memory_show を使用してください。

安定性ゲートの監査です。影響度の高いメモリを体系的に抽出し、 品質を確認して、それぞれ監査可能な結果を作成します。リリース前、 スキーマ移行前、サブシステムの境界を変更する ADR の作成前、または retrieve が矛盾する結果や信頼度の低い結果を返したときに実行してください。

手順

1. 影響度の高いメモリを抽出します。 doctrine memory validate をコーパス全体に対して実行し （REF は指定しません）、コーパス全体のリンク切れ、古くなった検証、期限切れが近い ドラフトを洗い出します。この出力が監査キューになります。

2. 優先順位を付けます。 影響度に基づいて指摘事項を並べ替えます。

   • スコープ対象のパスがあり、認証以降のコミット変更が多いメモリ （ドリフトのリスク）
   • 認証済み（検証済み）のメモリ — 変化し続ける対象に対する古い認証は、 未認証よりも問題です
   • 高い重大度 × 高い重み — ここで誤ると影響が大きくなります

3. それぞれにチェックリストを適用します。 監査キュー内の各メモリについて、以下を確認します。

   • 出所。 情報源を今も追跡できますか？引用されたコードやドキュメントは 移動しましたか？
   • 鮮度。 認証は最近のものですか？スコープ対象のパスは有用性が失われるほど 変更されていますか？
   • メタデータの効率。 スコープは今も正確ですか？タグは古くなっていませんか？ 有効期間は適切ですか？
   • スコープの正確性。 パス／glob／コマンドのスコープは、今も 適切な範囲をカバーしていますか？
   • 実行可能性。 将来のエージェントは、追加調査なしでこれに基づいて行動できますか？
   • 重複。 このメモリは別のメモリと重複していませんか？統合するか、 後継に置き換えてください。

4. スレッドの整理。 未検証のまま残っているスレッドがないか確認します（memory list --type thread）。それぞれについて、次のように対応します。

   • 今も関連性がある場合は、検証します（doctrine memory verify <REF>）
   • 古くなっている場合は、アーカイブします（doctrine memory status <REF> archived）
   • 新しい知識に置き換えられている場合は、後継を指定して置き換えます（doctrine memory status <REF> superseded --by <SUCCESSOR>）

5. 結果を記録します。 レビューした項目はすべて、以下の終端状態のいずれか1つに 該当する必要があります。

   • verified — 現在のツリーで再認証し、メタデータを更新済み
   • corrected — スコープ、信頼度、または内容を更新して編集済み（doctrine memory edit）
   • superseded — memory status superseded --by を使って後継を指定済み
   • archived — 行動には利用できなくなったものの、履歴として保持
   • promoted — 永続的な成果物（ADR、仕様書、またはドキュメント）に変換し、 メモリからアーカイブ済み

   これらの結果のいずれかを記録せずに、レビューを終えるメモリがあってはなりません。