Hermes Prime

Bash のインターフェースはカードのスナップショットをプロジェクトの CLAUDE.md に保存し、読み取り専用の MCP インターフェースは同じカードを stdio 経由で返します。この仕組みによって規約を利用できるようになりますが、モデルが規約に従うことを保証したり、逸脱を防いだりするものではありません。

これは小規模な転送手段であり、強制レイヤーではありません。Hermes Labs が自ら使用している規約カードを提供しています。フォークするか、HERMES_SESSION_INIT_FRAGMENT=/path/to/custom.md で別のフラグメントを選択してください。

1 つのフラグメントを 2 つのインターフェースで共有します。CLAUDE.md ベースのワークフロー向けの 4 つのサブコマンドを備えた Bash ツールと、CLAUDE.md を変更しない Claude Code ネイティブの MCP サーバーです。どちらのインターフェースもモデルやネットワークサービスを呼び出しません。Bash の方式ではグローバル設定を変更せず、MCP の登録にはユーザーが選択したスコープを使用します。

課題

セッション間で規約が見えるコンテキストから抜け落ちることがあります。バージョン管理されたカードがあれば、新しいセッションは散在するメモから規約を再構成する必要なく、具体的な成果物を読めます。

規律に関するルールは通常、ハンドブックのドキュメント、フィードバックファイル、セッション終了時の振り返りなどに分散しています。新しいセッションが読むことのない場所です。hermes-prime はそれらを、オーケストレーターが開く自己完結型の単一カードにまとめます。

特長

多くの「エージェントのセットアップ」ツールは、（a）コピー＆ペーストする巨大なプロンプトファイルを提供するか、（b）必要かどうかにかかわらず毎回のセッションで実行されるグローバルフックをインストールします。hermes-prime はプロジェクト単位で、マーカーを基準とし、冪等です。編集されていない挿入済みサフィックスはバイト単位で元に戻せます。編集されたブロックには、文書化されたマーカー／バックアップのフォールバックを使用します。

フラグメントはスナップショットであり、動的な参照ではありません。更新するには再挿入してください。マーカー（``）を使えば、挿入した内容をバイト単位で完全に元に戻せます。

2 つのインターフェース

インターフェース	対象	仕組み
MCP サーバー（Claude Code に推奨）	Claude Code ユーザー	ネイティブの MCP ツール — get_conventions／list_scopes。CLAUDE.md の変更もスナップショットもありません。詳細は mcp-server/ をご覧ください。
Bash バイナリ（CLAUDE.md の代替手段）	プロジェクトの CLAUDE.md を明示的に読み込む Claude Code およびその他のワークフロー	フラグメントをマーカー間に挿入します。スナップショット方式のため、更新するには再挿入してください。その他のエージェント指示形式は含まれていません。

どちらも同じ CLAUDE-fragment.md を共有します。それぞれ独立したインターフェースなので、エージェントに適したほうを選んでください。

MCP サーバー（Claude Code ネイティブ）

claude mcp add --scope local hermes-prime -- python3 "$PWD/mcp-server/hermes_prime_mcp.py"

このコマンドはリポジトリのルートから実行してください。ローカルスコープを指定すると、現在のプロジェクトでサーバーが読み込まれます。2026-09-11 に Claude Code 2.1.268 で最後に検証されており、claude mcp list ではサーバーが Connected と表示されます。サーバーの initialize レスポンスには短い指示文字列が含まれており、Claude Code がモデルに提示するため、新しいセッションは get_conventions を呼び出す必要があると認識できます。同じコマンドを複数のプロジェクトにまたがって自分のセッションで利用する場合に限り、--scope user を使用してください。その後、選択したスコープの対象となるセッションから get_conventions を呼び出します。標準ライブラリのみを使用し、サードパーティのランタイム依存関係はありません。登録と削除の詳細な手順、パッケージ版の pip install hermes-prime-mcp コンソールスクリプトの方法、および server.json の MCP Registry マニフェストについては、mcp-server/README.md に記載されています。

インストール（Bash バイナリ）

git clone https://github.com/hermes-labs-ai/hermes-prime.git
cd hermes-prime
ln -s "$PWD/bin/hermes-session-init" /usr/local/bin/hermes-session-init
hermes-session-init --check

または ~/bin/ にシンボリックリンクを作成してください。パッケージのインストールは不要です。Bash スクリプト 1 つと Markdown フラグメント 1 つで構成されています。

クイックスタート

# Require the fragment; report optional companion tools as information
hermes-session-init --check

# Print the fragment to stdout (pipe-friendly)
hermes-session-init --print

# Inject the fragment into a project's CLAUDE.md (idempotent, backs up existing)
hermes-session-init --inject ~/Documents/projects/some-project

# Remove the fragment cleanly (anchored on the marker)
hermes-session-init --uninject ~/Documents/projects/some-project

機能

サブコマンド	動作	終了コード
--check	フラグメントファイルのみを必須とします。hermes-ground、hermes-rubric-blinded、ハンドブックは任意の参考資料として案内します。	フラグメントがある場合は0／ない場合は1
--print	CLAUDE フラグメントを標準出力に出力します。--append-system-prompt にパイプで渡したり、内容を確認したりする際に便利です。	0
--inject <project>	フラグメントをマーカーで囲んで<project>/CLAUDE.mdに追記します。既存のCLAUDE.mdはCLAUDE.md.bak.<timestamp>にバックアップします。冪等性があり、再実行しても何も変更されません。	0
--uninject <project>	--injectで追加した正確な末尾部分を削除し、既存の内容をバイト単位で復元するか、インジェクションによって作成されたCLAUDE.mdを削除します。編集されたブロックについては、行を保持したままマーカーを削除します。マーカーが残っていない場合は、最新のバックアップにフォールバックします。	成功時は0／見つからない場合は1

注：hermes-groundは、Hermes Labs内部のグラウンディングツールです。一般公開されていません。この規約は、ツールが呼び出すオーケストレーターの動作を説明するものです。

インジェクションされる内容

次の内容を含む短いMarkdownブロックです。

1. グラウンディングのトリガー — 外部の事実確認のために、オーケストレーターがhermes-groundを呼び出すべき7つの条件。
2. 自己完結型の規約 — キャリブレーション、ルーブリックのパススルー、グラウンディング、名前の扱いに関する規律。
3. ツールマップ — 機能別のカテゴリ、Hermes Labsによる実装、手動での代替手段。
4. セッション中に最も忘れられやすいルール — パスにファイルが存在するまでは、名詞句のラベルを付けないこと。

全文はCLAUDE-fragment.mdを参照してください。このフラグメントが規約そのものです。

予備評価

正直な評価3件をevals/に用意しています。

• E1 — 規約想起テスト： フラグメントをインジェクションした新しいclaude --printセッションが、インジェクションしていないセッションと比べて、hermes-groundを外部グラウンディングツールとして正しく識別できるかを確認します。
• E2 — 冪等性ストレステスト： 5回連続でインジェクションし、サイズの増加が2文字以下であることを検証します。
• E3 — アンインジェクション往復テスト： インジェクション → アンインジェクションの後、前後の生データのハッシュが同一であることを確認します。

実行方法：bash evals/preliminary-bootstrap-eval.sh。プロトコルはevals/EVAL-PROTOCOL.mdを参照してください。実行トランスクリプトはevals/runs/にあります。帰無結果は、既定の規約に従い、編集せずに公開しています。

他のHermes Labsツールとの関係

hermes-primeは、Hermes Labsのオープンソースツール群における規約の提供手段の一つです。関連ツールを置き換えるものではなく、それらが呼び出されることを保証するものでもありません。

• hermes-rubric — エビデンスを優先したスコアリングです。「出荷可能な成果物はすべてBLINDedルーブリックを通過する」という規約が対象とするツールです。
• hermes-blind — 別途呼び出して使用する、複数ターンのリカバリー用スキャフォールドです。

ステータス

ソースバージョン0.2.1-alpha.1 — 未リリースのアルファ候補です。 公開済みの0.2.1-alpha.1タグもGitHubリリースもなく、このブランチはそれらの作成を許可していません。

MCPの配布物は別の提供形態で、こちらは公開済みです。hermes-prime-mcp 0.2.1a2はPyPIで公開されており、MCP Registryの掲載情報 io.github.hermes-labs-ai/hermes-prime 0.2.1-alpha.1はactiveです（いずれも 2026-09-18に確認）。チェックアウトなしで、現在uvx --from hermes-prime-mcp hermes-prime-mcpを実行できます。上記の「未リリース」はリポジトリを指し、パッケージを指すものではありません。

メカニズムのテストスイートには、Bashアサーションが11件、MCPテストが13件含まれています。E1は、実施者が行う3問の対照・処置条件の観察を1回行うものです。これは規約の想起に関する予備的なエビデンスであり、ツールが逸脱を防いだり、後続タスクのパフォーマンスを改善したりすることを示すエビデンスではありません。

より大規模な一連のテストでE1が帰無結果となった場合は、その結果を取り繕わずに公開します。これは、他のHermes Labsのオープンソースツールと同じ既定の規約です。

ローカルメカニズムゲート

プッシュまたはリリースを依頼する前に、ローカルメカニズムゲートを実行してください。

./scripts/local-ci.sh

このゲートでは、ShellCheck、11 件のアサーションを含む Bash テストスイート、13 件のテストを含む MCP テストスイート、フラグメントのサイズとマーカーのチェックを実行します。ホスト型ワークフロー（.github/workflows/ci.yml）では、macOS と Ubuntu 上で同じテストスイートを実行します。終了コード 0 が示すのは、現在のツリーで、名前が挙げられたチェックが実行されたということだけです。プッシュ、リリース、公開の承認を意味するものではありません。

ライセンス

MIT。LICENSE を参照してください。

---

Hermes Labs が開発しました。

Hermes Labs について

Hermes Labs は、自律システムの信頼性レイヤーを構築するエージェント型インフラストラクチャ企業です。このリポジトリは、そのポートフォリオにおける小さなメカニズムの 1 つです。ここでの主張は、上記のチェックで動作が確認された範囲に限られます。

エンタープライズ導入および AI 信頼性に関するご相談： [email protected] · hermes-labs.ai

名称について。Hermes Labs は、ギリシャ神話の伝令神ヘルメスにちなんで名付けられました。ヘルメスは、コミュニケーションと解釈の守護神であり、世界と世界の間で意味を運ぶ使者です。この仕事とのつながりは、ヘルメスに由来する解釈理論である解釈学にあります。言語を基盤とするエージェント型インフラストラクチャ企業にとって、哲学的なよりどころとなるものです。NousResearch の Hermes LLM シリーズや hermes-agent フレームワークとは関係ありません。企業も取り組みも異なります。

創業者：Rolando（Roli）Bosch。 サイト：hermes-labs.ai 引用：Bosch, R.（2026）。Hermes Labs：本番環境のエージェントおよび LLM アプリケーション向け AI 信頼性エンジニアリング。https://hermes-labs.ai