高度な Agent Stack

Codex × Claude Code × Hermes：3つのAgentを1つの実務システムにする

AIコーディングツールをすでに使っている人向けの実践ページです。Codexは実装、Claude Codeは設計判断とレビュー、Hermesは記憶・定期実行・監査可能な運用を担当します。

構成から読むワークフローへテンプレートを使う

このガイドで扱うこと

01｜3層アーキテクチャ02｜役割分担03｜共有プロジェクトメモリ04｜ハイブリッド運用例05｜コピペ用テンプレート06｜安全性と検証07｜参考資料
小さなバグ修正だけなら

Codexで狭い差分を作り、テストとdiffレビューで終える。

大きな要件を分解するなら

実装前にClaude CodeまたはHermesでリスクと範囲を整理する。

毎週くり返す作業なら

成功した手順をHermesのskill、cron、handoffに変換する。

01 / Blueprint

正しい考え方：3つのチャットではなく、3層の運用システム

Codex、Claude Code、Cursor、Hermesを全部入れても、毎日同じ文脈を貼り直しているなら効果は半分です。上級者の使い方は、実行・判断・運用を分けることです。

Codex｜実行レイヤー

リポジトリ内での作業に向いています。ファイル読解、コード編集、テスト追加、コマンド実行、PR要約などを担当する実装スペシャリストです。

Claude Code｜判断レイヤー

長い推論、設計トレードオフ、要件分解、対話型コードレビュー、Subagents、Hooks、MCP運用に向いています。シニアレビューアまたはアーキテクトとして使います。

Hermes｜運用レイヤー

永続的な好み、再利用できるskill、Telegram / CLI / API経由の実行、定期チェック、handoff、成功した作業の手順化に向いています。AgentのOSとして使います。

808の結論： CodexはClaude Codeを置き換える必要はありません。Claude CodeもHermesを置き換える必要はありません。安定する型は「Codexが修正、Claude Codeが判断、Hermesが記憶と運用」です。

02 / Division of Labor

役割分担：すべてのAgentに同じ仕事を頼まない

状況小さなバグや機能
Codex直接実装し、テストとlintを実行
Claude Code必要に応じて二次レビュー
Hermes再利用できる学びや検証結果を保存
状況未知の大きなリポジトリ
Codexコードを走査し、入口とリスクを列挙
Claude Codeアーキテクチャと意思決定を分解
Hermesリポジトリ規則をオンボーディング手順に変換
状況長いタスクや複数ブランチ
Codexbranch / worktree内でpatchを作る
Claude Codeタスク分割とdiffレビュー
Hermesスケジュール、追跡、引き継ぎ、通知
状況反復ワークフロー
Codexテンプレート化された実装作業を実行
Claude Codepromptとsubagent設計を改善
HermesHermes skillとして保存
状況リスクのあるデプロイ
Codex変更セットを準備。デフォルトでは本番デプロイしない
Claude Codeリスクとロールバック計画をレビュー
Hermes人間の承認と監査ログを残す

03 / Shared Memory

3つのツールに同じプロジェクト運用マニュアルを読ませる

公式ドキュメントとコミュニティ実践から見える結論は同じです。高度なAgent運用は魔法のpromptではなく、永続的な文脈で動きます。CodexはAGENTS.md、Claude CodeはCLAUDE.md、Hermesはskills・memory・handoffを読みます。

Codex

AGENTS.md

リポジトリ構成、起動コマンド、テスト、完了条件、禁止事項を置きます。ルートのファイルは短くし、詳細はdocsへリンクします。

Claude Code

CLAUDE.md

対話の癖、設計原則、よく使うコマンド、レビュー基準を置きます。Claude Codeはmemory、hooks、subagents、MCPも活用できます。

Hermes

Skills / Memory / Handoff

反復できる手順はskillに、長期的な好みはmemoryに、作業進捗はhandoffに残し、Telegram、CLI、cronから継続できるようにします。

最小限のプロジェクト文脈構成
your-project/
├─ AGENTS.md          # Codex / 汎用coding-agent向けルール
├─ CLAUDE.md          # Claude Codeの対話・設計ルール
├─ docs/agent/
│  ├─ architecture.md # システム構成とデータフロー
│  ├─ testing.md      # test / lint / buildコマンド
│  └─ release.md      # deploy、rollback、人間承認のgate
└─ .hermes/plans/     # 任意：Hermesの計画 / handoff

04 / Recipes

実際に使える3つのハイブリッド運用

A

Plan → Patch → Review：最も安定する日常開発ループ

Claude CodeまたはHermesで短い計画を作り、Codexにbranch / worktreeで実装させ、最後に成果物ベースでレビューします。小さな機能、バグ修正、ドキュメント更新に向いています。

人間からの指示例
まだファイルを編集しないでください。
1. 先に AGENTS.md / CLAUDE.md / docs/agent/* を読む。
2. 3ステップ以内で計画を出す。
3. 変更予定ファイルと検証方法を列挙する。
4. 実装前に確認を待つ。
B

Claude CodeからCodexを専門ツールとして呼ぶ

コミュニティでは、Codex CLIをMCP経由で公開し、Claude Codeから実装担当として呼び出す使い方があります。これは上級パターンです。コマンド名は変わる可能性があるため、必ず公式ドキュメントと--helpで確認してください。

コミュニティ式の例：実際のversionで確認してください
# 1. Codexをインストールしてログイン
codex

# 2. versionが対応していればMCP serverを起動
codex mcp-server

# 3. Claude Codeに登録
claude mcp add --transport stdio codex -- codex mcp-server

# 4. Claude Code内で確認
/mcp
重要： 本番リポジトリに書き込み権限を与える前に、必ずtoy repoまたはread-onlyタスクで検証してください。
C

Hermesを長期運用レイヤーにする

Claude CodeとCodexは現在のセッション内で強力です。Hermesはセッションをまたぐ運用に強く、memory、cron、Telegram / Discord gateway、skills、handoffを扱えます。日次チェック、PR要約、リリースチェックリスト、issue triageに向いています。

Hermes用ワークフロー設計prompt
このリポジトリのリリース手順をHermes skillにしてください：
- 使うべき条件
- 最初に読むファイル
- 実行する検証コマンド
- 人間承認が必要な操作
- 完了時に残すhandoff / report

05 / Templates

コピペ用テンプレート

最小AGENTS.md

AGENTS.md
# Project Agent Guide

## What this project is
プロダクト、ユーザー、データフローを1文で説明。

## Commands
- Install: `...`
- Dev: `...`
- Test: `...`
- Build: `...`

## Conventions
- 主な言語 / framework
- ファイル配置ルール
- 命名とエラーハンドリング原則

## Definition of Done
- Tests and lint pass
- 人間が読めるsummaryがある
- 大きな変更にはrollback notesがある

## Never do
- secretsを読まない・表示しない
- productionへ直接deployしない
- 破壊的DB変更を実行しない

Claude Codeレビューprompt

review prompt
レビューのみ。ファイルは編集しないでください。
このdiffを以下の観点で確認してください：
1. AGENTS.md / CLAUDE.mdとの整合性
2. security、data-loss、permission、migrationリスク
3. 検証されていない仮定
4. 足りないテスト
指摘は Critical / Major / Minor に分類してください。

Hermes skill trigger

skill description
本番リリースの準備またはレビュー時に使う：
- 現在のgit diffとdeploy configを確認
- tests、build、smoke checksを検証
- 人間承認が必要なgateを特定
- release handoffとrollback notesを作成
明示的な承認なしにdeployしない。

3-Agent handoff

handoff
## Agent Handoff
- Goal:
- In scope / out of scope:
- Files changed:
- Commands actually run:
- Test / build result:
- Risks:
- Human approval needed:
- Next best action:

06 / Guardrails

マルチAgent運用が強くなるほど、硬いガードレールが必要になる

AGENTS.md、CLAUDE.md、promptはあくまで「文章」です。本当の安全性は、環境分離、権限境界、検証gateから生まれます。

おすすめの順番： まず1つのリポジトリでAGENTS.md、計画、test gateを整える。次にClaude Codeレビューを足す。最後にHermesのcron、gateway、skillsで長期運用にする。

07 / Sources

参考資料

このガイドは公開ドキュメントとコミュニティ実践に基づいています。コミュニティ記事はパターン理解に使い、正確なコマンドは必ず各ツールの最新公式ドキュメントと--helpで確認してください。