Hermes Agent Wiki 非公式・日本語wiki

どのファイルが何をするのか

目次

「エージェントに伝えたのに忘れられた」「エージェントの頭脳はどのファイル？」「SOUL.md を書き換えたのに、名前を覚えてくれないのはなぜ？」——こうした疑問はどれも同じところに行き着きます。Hermes Agent はいくつかのマークダウンファイルによって形づくられていて、それぞれ役割が違うのです。このページでは、それらを一箇所にまとめて見取り図にします。個々の詳しい話は 永続メモリ、パーソナリティと SOUL.md、コンテキストファイル をたどってください。

全体の対応表

ファイル 何が入るか 誰が書くか いつエージェントの目に入るか どこに置かれるか
SOUL.md エージェントの中心的な人格——性格、口調、話し方、文体として避けたいこと あなた。ファイルが無ければ Hermes が出発点となる雛形を自動で用意します。既にあるファイルが上書きされることはありません セッション開始時、システムプロンプトの1枠目 ~/.hermes/SOUL.md（ホームを変えている場合は $HERMES_HOME/SOUL.md）。作業ディレクトリには置かれません
USER.md 利用者のプロフィール——名前、役割、好み、話し方、期待していること エージェントが memory ツールで書きます（保存に write_approval の確認を挟むことも、hermes journey edit で項目を直すこともできます） セッション開始時に固定されたスナップショットとしてシステムプロンプトへ差し込まれます ~/.hermes/memories/
MEMORY.md エージェント自身の覚え書き——環境まわりの事実、プロジェクトの決まりごと、ツールの癖、学んだこと エージェントが memory ツールで書きます（確認や編集の方法は USER.md と同じ） セッション開始時に固定されたスナップショットとしてシステムプロンプトへ差し込まれます ~/.hermes/memories/
AGENTS.md プロジェクトの指示・決まりごと・構成——コマンド、ポート、パス、そのリポジトリ固有の進め方 あなた（またはそのプロジェクトを書いた人） 起動時に作業ディレクトリから読み込まれてシステムプロンプトに入ります。下位ディレクトリに置かれたものは、エージェントがそこへ移動するにつれて順次見つかります プロジェクトの作業ディレクトリとその下位ディレクトリ
.hermes.md / HERMES.md プロジェクトの指示。AGENTS.md と同じ役割ですが Hermes 専用で、優先度が最も高いもの あなた 起動時にシステムプロンプトへ読み込まれます（最初に見つかったものが AGENTS.md より優先されます） 自分のプロジェクト。探索は git のルートまでさかのぼります

覚えやすい言い方をすると、こうなります。

  • SOUL.md はエージェントが*何者か*。どこへ行っても付いてきてほしいことは、ここに書きます。
  • USER.md は*あなた*が何者か。エージェントがあなたのために書き足していきます。
  • MEMORY.md はエージェントが*学んだこと*。これもエージェント自身が育てます。
  • AGENTS.md（または .hermes.md）は*プロジェクト*が必要とすること。プロジェクトに属する内容は、ここに書きます。

「さっき言ったことを、なぜ忘れるのか」

メモリ（MEMORY.md と USER.md）は、セッション開始時に一度だけ切り取られた固定のスナップショットとしてシステムプロンプトへ差し込まれます。セッションの途中でエージェントが何かを保存すると、その変更はすぐディスクへ書かれますが、システムプロンプトに現れるのは次のセッションからです。これは意図した設計で、LLM の接頭辞キャッシュを保って性能を上げるためです。ツールの応答は常に最新の状態を返すので、失われるものはありません。新しいセッションを始めれば、更新されたメモリがそこにあります。詳しくは メモリがシステムプロンプトに現れるしくみ を参照してください。

よくある取り違え

「自分に関する事実を SOUL.md に書いたのに、USER.md が空のままだった」

SOUL.md と USER.md は別々の仕組みで、互いに中身を渡し合うことはありません。SOUL.md はあなたが直接書き換える人格のファイルで、口調と人格を形づくり、その内容はプロンプトの1枠目にそのまま差し込まれます。USER.md は永続メモリの一部で、エージェントが memory ツールを通じて書きます。自分に関する事実を USER.md に入れたいなら、エージェントに伝えてください（「簡潔な回答が好みだと覚えておいて」など）。そうすれば保存されます。SOUL.md を書き換えてもメモリは埋まりませんし、メモリの項目が人格を変えることもありません。SOUL.md は長く保ちたい声色や人格の指針に使い、好みやプロフィールの事実はメモリに任せましょう。SOUL.md には何を書くべきか と 2つの保存先 も参照してください。

「セッションの途中で名前を伝えたのに、聞いていないかのように振る舞う」

エージェントが名前をメモリに保存したのなら、その保存自体は成功しています。memory ツールの応答か hermes journey list で確かめられます。起きているのは、先ほどの固定スナップショットの話です。システムプロンプトはセッションの途中で更新されないため、*差し込まれた*メモリの塊はセッション開始時のままなのです。伝えた内容は会話の中に残っているので、そのセッション中もエージェントは使えますし、保存された項目は次のセッションからシステムプロンプトに入ります。同じことは、セッションが動いている最中に SOUL.md や AGENTS.md を書き換えた場合にも当てはまります。文脈はセッション開始時に組み立てられるので、変更を反映させたいならセッションを開き直してください。