FAQ

HMG のデータはどこに保存されますか？

お使いのマシンの store ディレクトリです。既定は <ユーザーデータディレクトリ>/hmg/stores/default。macOS / Linux では通常 ~/.local/share/hmg/stores/default です。--store <path> で指定するか、hmg doctor --verbose で実際のパスを確認できます。データは既定でローカルに保存されます。

store に含まれるもの：

• 長期記憶
• インデックス
• observation
• ローカルランタイム関連の状態

既定の場所とディレクトリ構造は 設定 を参照。

ローカルデータとプライバシーはどう考えればよいですか？

HMG は既定でローカル優先です：

• 記憶、インデックス、observation はすべてローカルの store に保存されます
• store をどのディレクトリに置くかはあなたが決められます
• store のバックアップ、移行、分離、削除は直接実行できます
• 複数の Agent が同じ store を共有する場合、データの境界はスコープ、ガバナンス状態、ローカルディレクトリで共同決定されます

要点は 2 つだけ：

1. 通常の記憶に secret、token、パスワード、顧客の機密データを書かない。
2. 永続保存が必要な認証情報は hmg secret store を使い、平文を通常の記憶に書かない。

ログインは必要ですか？プランはどう反映されますか？

ログインは必須ではありません。基本的な記憶機能はログインなしで使えます。開発者版の機能とより大きな記憶容量を利用するには：

• まず公式サイトのユーザーセンターでプランをアップグレードし、ローカルで hmg login を実行
• ログインにはネットワークが必要：HMG がリモートサービスでアカウントを検証し、プランを識別して署名を受け取り、ローカルで署名検証が成功するとアンロック
• ログインによるデータ移行やローカル記憶データの変更は一切なし：ローカルの読み書きは常に OS のユーザー名を tenant として使い、アカウント情報はクラウド同期時の身份対応のみ
• ログアウトやアカウント変更は store 設定の関連アカウントフィールドを消去するだけで、ローカルの記憶には影響なし

HMG とチャット履歴の違いは？

チャット履歴は会話の完全な流水帳で、時系列に積み上がり、増えるほど乱れ、検索しにくい。HMG の記憶は将来使う情報——決定、根本原因、制約、好み、検証結果であり、構造化され、検索可能で、訂正可能で、スコープつき。HMG は「何を言ったか覚える」のではなく、「将来役立つものを覚える」ものです。

HMG とベクターデータベースの違いは？

ベクターデータベースは意味類似度検索しかしません。HMG はその上に：

• スコープ（tenant/workspace/repository/branch）によるコンテキスト分離
• マルチルート検索（意味 + キーワード + グラフ関係など）
• 訂正とガバナンス（情報は古くなる。訂正、格下げ、隔離、墓碑化が可能で、監査を保持）
• 構造化クエリ（決定の追跡、リスク一覧、影響面分析、ナレッジグラフ探索）

を提供します。

簡単に言えば：ベクター DB は「保存 + 検索」、HMG は「古くなり、訂正でき、コンテキストつきの記憶システム」です。

記憶を手動で書く必要がありますか？

ほとんどの場合不要です。Agent を接続すると、記憶の書き込みは完全に自律になります：Agent は決定ややり取りの発生時に memorize で増分保存し、タスク終了時に handoff で引き継ぎを書き、情報が古くなると correct で訂正します。手動での書き込みは、プロジェクト規約、安定した好み、長期的な制約など、あなたが能動的に残したい情報に向いています。

Agent が HMG を呼ぶときスコープを渡す必要がありますか？

不要です。渡すべきでもありません。Agent 統合ではスコープは hooks がセッションのディレクトリから機械的に推論して注入します（tenant / workspace / repository / branch の 4 層すべて）。Agent が誤った値を渡しても静かに訂正されます。手動の CLI 利用でのみ --scope を使う可能性があります。詳しくは スコープ を参照。

なぜ一時セッションで保存した記憶がプロジェクトセッションから見えないのですか？

これはスコープ分離の設計結果です。プロジェクトに紐付かない一時セッション（Codex デスクトップの Chats など）は personal/chats/main スコープを共有し、プロジェクトスコープとは相互に分離されます。一時セッションで保存したユーザーの好みがあるプロジェクトでも必要な場合は、そのプロジェクトセッションで再度 memorize してください。

記憶が増え続けて乱れませんか？

HMG は多重のノイズ削減を設計しています：

• 書き込み源头の制御：Agent 統合では長期記憶は memorize / handoff の 2 つの能動チャネルのみで書き込まれ、会話原文やコマンド出力の機械的な捕捉はしない
• 訂正/格下げ/ガバナンス：古い情報は訂正・格下げでき、機密情報はガバナンスできる
• 正確な重複排除：同じ内容は 2 度保存されない
• store hygiene：hmg store hygiene が孤立エッジ/インデックスを掃除
• スコープ分離：異なるプロジェクト/ブランチは互いに汚染しない

ベストプラクティス の書き方と組み合わせれば、記憶は精選された状態を保ちます。

HMG はどんなワークフローに向いていますか？

Agent にコンテキストを継続的に記憶させたいあらゆるワークフローに向きます。代表的には：

• 個人プロジェクトの長期協業
• 複数セッション・複数日にわたるタスクの連続した引き継ぎ
• 複数リポジトリ・複数ブランチの経験の蓄積
• 同じマシン上の複数 Agent による長期記憶の共有

別のパソコンに移行できますか？

できます。方法は 2 つ：

bash

# 1. store ディレクトリを新しいマシンにコピー
# 2. 公式移行コマンド
hmg store migrate --from /old/store --to /new/store --backup --apply

最も簡単なバックアップも store ディレクトリ全体のコピーです。

または hmg export --format json でエクスポートし、新しいマシンでインポート。詳しくは ローカルデータのバックアップまたは移行 を参照。

機密情報はどう扱うべきですか？

• API キー、token、パスワードを通常の記憶に書かない。
• 認証情報を必ず保存する場合は secret vault を使う：hmg secret store <name> <value>。
• 必要なときに明示：hmg secret reveal <name>。
• 書き込み時、HMG は構造化された機密情報（接続文字列、password=xxx、Bearer トークン、秘密鍵ブロック）を自動で秘匿化します。自然言語で書かれた機密内容は自動検出されません。
• 機密情報を誤って通常の記憶に書いた場合は、すぐにガバナンス：hmg govern <atom-id> --action tombstone --destroy-payload --reason "機密情報を誤って書いた"。

関連するガバナンス方法は 機密情報の削除または隔離 を参照。

記憶を削除できますか？

できますが、HMG は監査証跡を残すため、物理削除ではなくガバナンスを推奨します：

bash

# 墓碑化（論理削除、payload の破棄は任意）
hmg govern <atom-id> --action tombstone --destroy-payload --reason "不要になった"

# 隔離（保持するがリコールに出ない）
hmg govern <atom-id> --action quarantine --reason "一時的に使わない"

# 格下げ（もう必要ないかもしれない）
hmg correct <atom-id> --action demote-possible --reason "もはや適用されない"

観察レイヤーは hmg obs forget で削除できます。

すでにたまっている会話履歴や記憶ファイルをインポートできますか？

できます。Agent に「記憶を HMG にインポートして」と話しかけると（hmg-memory-import skill）、会話履歴とホストネイティブの記憶ファイルをスキャンし、長期的な価値のある項目を抽出、プロジェクト / 個人で分類し、確認後に一括書き込みします。詳しくは 既存記憶のインポート を参照。