session-palace-builder

Session Palace Builder

長時間の会話や複雑なプロジェクト向けに、一時的でセッション固有のメモリパレスを構築します。中断後もコンテキストを保持し、情報を体系的に蓄積できます。

概要

セッションパレスは、次のことを実現する軽量で一時的なメモリ構造です。

• 長時間の会話でコンテキストを保持する
• 決定事項とその理由を記録する
• プロジェクトの成果物を空間的に整理する
• 中断後のコンテキスト復元を可能にする
• 共同での情報収集を支援する

クイックスタート

ビルドコマンド

```bash

ビルドを実行

make build

クリーンアップして再ビルド

make clean && make build ```

テスト

```bash

テストを実行

make test

詳細な出力で実行

make test VERBOSE=1 ```

検証：make testを実行して、プラグインのゲートを通過することを確認してください。

使用する場面

• コンテキストの保持が必要な長時間の会話
• 相互に関連する要素を含む複雑な複数ステップのプロジェクト
• 対話をまたいだ状態管理が必要なワークフロー
• 時間の経過とともに情報を蓄積する共同作業セッション
• 多くの指摘事項があるコードレビューやデバッグのセッション

使用しない場面

• 永続的なナレッジ構造が 必要な場合 — memory-palace-architect を使用してください
• 既存のナレッジを検索する場合
  • knowledge-locator を使用してください
• 永続的なナレッジ構造が 必要な場合 — memory-palace-architect を使用してください
• 既存のナレッジを検索する場合
  • knowledge-locator を使用してください

セッションパレスのテンプレート

テンプレート	目的	主なエリア
作業場	アクティブな開発	作業台、ツール、素材
図書館	調査と分析	書架、閲覧室、アーカイブ
評議会議事堂	意思決定	円卓、証拠の壁、投票ボード
天文台	探索と発見	望遠鏡、星図、記録帳
鍛冶場	実装タスク	金床、冷却棚、完成品

情報カテゴリ

セッションの内容を、次の標準エリアに整理します。

• 会話 - 対話のスレッドと重要なやり取り
• 決定事項 - 理由を伴う選択
• コード - スニペットと技術的な成果物
• 調査 - 調査結果と参考資料
• 要件 - 仕様と制約
• 進捗 - 完了したマイルストーン
• 問題 - 阻害要因と課題
• 次のステップ - 未完了のアクション項目

基本的なワークフロー

1. コンテキストを分析する - セッションの範囲と複雑さを評価する
2. パレスを設計する - テンプレートとレイアウトを選択する
3. 状態を構造化する - 情報を空間的に整理する
4. ナビゲーションを構築する - アクセス用のショートカットを作成する
5. 統合をテストする - コンテキストが保持されることを確認する

セッションのライフサイクル

Create → Populate → Navigate → Export/Archive
   ↑         ↓          ↓
   └─── Checkpoint ←────┘

明瞭さのチェックポイント

セッションパレスは、気づかないうちに劣化します。各Populateステップで曖昧さが加わり、それが表面化するのはExportの時点です。その時には、失われた状態を復元するには手遅れです。MMPO（arXiv:2605.30159、第3節）は、これをサブ軌道の高密度報酬が必要となる事例として捉えています。最終結果だけでなく、遷移ごとに中間品質を確認します。

上記のライフサイクルにある各Checkpoint矢印の時点（およびExport/Archiveの前）に、現在のパレス状態に対してデュアルプローブゲートを実行します。

Skill(memory-palace:memory-clarity-probe)

プローブは、進捗と不足項目の判定、およびRecommendationを含むClarity Assessmentを返します。

推奨事項	チェックポイントでの対応
続行	パレスの状態は明瞭です。セッションを続けてください
メモリを拡張	続行する前に、不足項目プローブで未解決とされた項目をパレスに追加します
再生成	セッションを曖昧な状態として記録します。進捗プローブの回答が確定的でないため、さらに作業を加える前に現在の状態を表す部屋を再構築します

チェックポイントで記録することが重要です。エクスポート時ではありません。曖昧なパレスを早期に検出すれば、部屋を1つ再構築するだけで済みます。エクスポート時に検出すると、セッション全体が損なわれます。

memory-clarity-probeがインストールされていない場合は、2つの確認質問をその場で行います（進捗：何が完了していて、タスクはどのような状態か。不足項目：具体的に何が残っているか）。そのうえで、同じ表に従ってください。

詳細なリソース

• テンプレートの詳細：modules/templates.mdを参照してください
• 状態管理：modules/templates.mdを参照してください
• エクスポートパターン：modules/templates.mdを参照してください

統合

• memory-palace-architect - 重要な概念を永続的な宮殿にエクスポートします
• knowledge-locator - セッションの内容を検索します
• digital-garden-cultivator - セッションから得た知見を庭に植え付けます
• memory-clarity-probe - セッションのチェックポイントで明瞭性を確認するデュアルプローブゲートを実行します

終了条件

• 状態を追加する前に、テンプレートと空間レイアウトを備えたセッション宮殿が作成されている
• デュアルプローブによる明瞭性ゲートが、最後だけでなく、各Checkpointへの遷移時とExport/Archiveの前に実行される
• チェックポイントでExpand memoryまたはRegenerateが返された場合、追加の作業を反映する前に対応する（ギャップ項目を追加するか、現在の状態に合わせて部屋を再構築する）とともに、曖昧なセッションとしてフラグが付けられている
• エクスポートされた概念が、memory-palace-architectを介して永続的な宮殿に往復して取り込まれる