PJ09 AI自動経営
Hermes Agent 統合アーキテクチャ — v3.2 Mac mini専用機 (2026-05-20)
アーキテクチャ概要
Mac mini（自動化専用機）
Hermes Agent 24/7 / COO + 7プロファイル / MCP / cron / Telegram Bot
メイン機（Founder）
Claude Code / IDE / ブラウザ
v3.1: Mac mini (M4 Pro / 48GB) を自動化専用機として導入。Hermes Agent + Ollama が 24/7 常駐。メイン機は Founder のワークステーション（Claude Code 手動利用）。2マシン間は SSH / Tailscale / Telegram + Google Drive 同期で連携。
全体構造（2マシンアーキテクチャ）
┌─────────────── Mac mini (M4 Pro / 48GB) ───────────────────────┐
│ │
│ Hermes Agent (24/7 launchd常駐) │
│ │ │
│ COOプロファイル（経営統括・オーケストレーター） │
│ │ │
│ ├── 戦略・企画 ────→ PMプロファイル → PRD / 競合分析 │
│ ├── 集客・発信 ────→ News / Marketing プロファイル │
│ ├── コード開発 ────→ Devプロファイル → Codex CLI → PR │
│ ├── 営業・リード ──→ Salesプロファイル │
│ ├── 課金・コスト ──→ Financeプロファイル → 月次レポート │
│ ├── 異常検知 ─────→ Watchdogプロファイル → アラート │
│ ├── 定型業務 ─────→ cron + スキル │
│ └── 外部連携 ─────→ MCP (Vault-RAG / Slack / Gmail...) │
│ │
│ Claude API / OpenAI API ── Grok障害時フォールバック (従量) │
│ Telegram Bot ─── Founder↔Hermes リモート指示経路 │
└───────────────────────────────────────────────────────────────┘
│ SSH / Tailscale / Telegram / Google Drive同期
┌───────────────── メイン機（Founder WS）──────────────────────┐
│ Claude Code (手動・従量課金) / IDE / ブラウザ / 日常作業 │
│ Vault編集 → Google Drive同期 → Mac mini即反映 │
└───────────────────────────────────────────────────────────────┘
ハードウェア構成
| マシン | 役割 | スペック |
|---|
| Mac mini | 自動化専用機 (Hermes 24/7常駐) | M4 Pro / 48GB RAM / macOS |
| メイン機 | Founder ワークステーション | 現行マシン |
Mac mini 運用方針
- 常時稼働: launchd で Hermes + Ollama を常駐化。スリープ無効
- ヘッドレス運用: 普段 SSH。GUI 操作時のみ VNC 接続
- Telegram Bot 常時起動: 外出先からでも Telegram 経由で Hermes に指示可能
- Google Drive 同期: メイン機と同じ Google アカウントで Drive 同期 → Vault 双方向
- リモートアクセス: SSH (ローカル) / Tailscale (外部ネットワーク)
- X投稿: Playwright MCP (ヘッドレス Chromium) で実行。GUI Chrome 非依存
メイン機の役割
- Claude Code (手動・従量課金) = Founder の個人ツール
- ブラウザ・IDE・日常作業
- Vault 編集 (Google Drive 同期で Mac mini に即反映)
- Mac mini の Hermes には SSH / Telegram で指示
Hermes Agent
2026-05-18 NanoClaw から移行
GitHubNousResearch/hermes-agent (MIT)
Versionv0.14.0 (2026.5.16)
Install~/.hermes/hermes-agent/ / ~/.local/bin/hermes (Mac mini)
LLM (Primary)Grok 4.3 (SuperGrok OAuth — $0)
LLM (Fallback-1)Claude API Sonnet (従量・Grok障害時)
LLM (Fallback-2)OpenAI API GPT-5.4 (従量・Claude障害時)
PlatformCLI + Telegram Bot (ヘッドレス運用の主要インターフェース)
ObsidianOBSIDIAN_VAULT_PATH → Google Drive 同期先パス
自己進化SkillClaw互換ループ + Curator + GEPA
常駐化launchd ~/Library/LaunchAgents/com.hermes.agent.plist
Statusメイン機で稼働 → Mac mini移行待ち
アーキテクチャ詳細
- コアループ: AIAgentクラス1つ (ReAct同期)。CLI/メッセージング/バッチ/IDE全てが同一コアの入口
- 実行先6種: ローカル / Docker / SSH / Modal / Daytona / Singularity (config.yaml切替)
- モデル差替: 3種APIフォーマット翻訳レイヤー → Claude / GPT / Gemini / Ollama
- 90ターン上限: タスクあたり暴走防止。サブエージェントも同一予算枠
メモリ3層構造
Tier 1 — System Prompt
MEMORY.md (2,200字) + USER.md (1,375字)
セッション開始時に注入。80%到達で自動圧縮。変更は次セッションから反映。
Tier 2 — SQLite FTS5
全会話の全文検索 (CLI + メッセージング)
容量無制限。オンデマンド検索 + LLM要約。state.db WALモード。
Tier 3 — External Provider
8種プラグイン対応の外部メモリ
同時アクティブ1つ。ターン前プリフェッチ / レスポンス後シンク / セッション終了時抽出。
SOUL.md (アイデンティティ層)
~/.hermes/SOUL.md = システムプロンプト slot#1 (最優先ロード)- 性格・トーン・絶対やらないことを定義。手書き・静的
- PJ/セッション跨ぎで人格固定。未設定時はデフォルト人格にフォールバック
- プロファイルごとに独立SOUL.md (programmer / researcher / designer等)
スキルシステム
| 機能 | 詳細 |
|---|
| Progressive Disclosure | L0: 名前+説明のみ (~3,000tok) → L1: 本文ロード → L2: 参照ファイル深掘り |
| 自動作成トリガー | 5回以上ツール呼び出し / エラー後の解決 / ユーザー修正 / 非自明ワークフロー |
| skill_manage | create / patch (部分修正・推奨) / edit / delete / write_file / remove_file |
| Skills Hub | 18カテゴリ 687スキル (組込87 + オプション79 + Anthropic16 + LobeHub505) |
| カスタムtap | hermes skills tap add <repo> で任意GitHubリポ追加 |
Curator (スキル自動整理)
- 起動条件: 最終実行から7日経過 + 2h以上idle → バックグラウンドフォーク
- 自動遷移 (LLM不要): 30日未使用 → stale / 90日未使用 → archive
- LLMレビュー (最大8回): keep / patch / consolidate / archive を判断
- 安全策: バンドル・Hubスキル不触 / 自動削除なし / tar.gzスナップショット /
hermes curator pin <skill> でピン留め
GEPA (オフラインスキル最適化)
RepoNousResearch/hermes-agent-self-evolution (MIT)
論文ICLR 2026 Oral採択 (Genetic-Pareto Prompt Evolution)
コスト$2-10/回、GPU不要 (全てAPI呼び出し)
位置づけフルfine-tuning / GRPO前に試す選択肢
パイプライン: スキル読込 → 評価データセット作成 → オプティマイザ → LLM-as-judge → 制約ゲート (100%テスト通過・15KB以内) → PR送信
LLMフォールバック戦略
PrimaryGrok 4.3 (SuperGrok OAuth — $0)
Fallback-1Claude API Sonnet (hermes config set model anthropic/claude-sonnet-4-6)
Fallback-2OpenAI API GPT-5.4 (hermes config set model openai/gpt-5.4)
切替方法Watchdog が Grok 障害を検知 → hermes model で即切替。コード変更不要
禁止プロバイダKimi/Moonshot / z.ai/GLM / MiniMax / Xiaomi MiMo / DeepSeek 等の中国系
Ollama 非採用の理由 (v3.2): Mac mini 48GB の主要用途だったローカル推論は不要。Grok 障害時は Claude API / OpenAI API（承認済みプロバイダ）でフォールバック可能。Ollama 廃止により Mac mini の RAM 要件が緩和され、M4/16GB〜24GB 構成も検討可能。
Agent Organization
hermes profile create <name> --clone で独立インスタンス (config/メモリ/スキル/SOUL.md各自独立)- Telegram Bot: プロファイルごとに別Botトークン必須 (1トークン=1接続制限)
- Founder = CEO。COOプロファイルが AI 側の経営統括として全プロファイルをオーケストレーション
組織構造
Founder (CEO)
|
Hermes Agent
|
COOプロファイル（経営統括）
+----+----+----+----+----+----+----+
v v v v v v v v
*PM Mkt News Dev Sales Fin WD
戦略 <-- 実行層 ---------> 管理 監視
|
Codex CLI (コード生成)
| プロファイル | Tier | SOUL.md / スキル | 担当 |
|---|
| coo | 統括 | ~/.hermes/profiles/coo/SOUL.md | 全体統括オーケストレーター（旧CEO Agent） |
| pm | 戦略 | ~/.hermes/profiles/pm/ | PJ横断プロダクト戦略・PRD・競合分析 |
| marketing | 実行 | ~/.hermes/profiles/marketing/ | PJ05(X短文) + PJ06(Articles) |
| news | 実行 | ~/.hermes/profiles/news/ | PJ07(AIニュース) + PJ08(朝刊) |
| dev | 実行 | ~/.hermes/profiles/dev/ | DevSymphony統括 → Codex CLI委任 |
| sales | 実行 | ~/.hermes/profiles/sales/ | リード・DM・クロージング (Phase 1以降) |
| finance | 管理 | ~/.hermes/profiles/finance/ | X API / Stripe 課金追跡・月次コストレポート |
| watchdog | 監視 | ~/.hermes/profiles/watchdog/ | cron異常検知・パイプライン死活・SLAアラート |
PJ34バックポート (2026-05-20): finance・watchdog はPJ34 Agent設計から概念移植。Production-Fast/Deep・CS は顧客向けのためPJ09対象外。
パイプライン
| パイプライン | フロー | ツール |
|---|
| Product | PM → Dev → Codex CLI → PR | Codex CLI |
| Content | News → Marketing | スキル + MCP |
| DevOps | Dev → Codex CLI → PR | Codex CLI |
| Launch | PM → Marketing + Sales | スキル + MCP |
| Monitoring | Watchdog → COO → 対象プロファイル | cron + Slack MCP |
| Finance | Finance → COO (月次レポート) | Stripe API + MCP |
承認ゲート
PJ34設計バックポート (2026-05-20)
| 操作カテゴリ | ルール |
|---|
| 外部送信 (メール・X投稿・DM) | ドラフト作成まで自律可。送信はFounder承認必須 |
| 金銭操作 (API課金・Stripe) | 閲覧は自律可。作成・変更はFounder承認必須。返金はFounder手動のみ |
| デプロイ・インフラ | Founder承認必須 |
| ハンドオフ | COOが判断。ハンドオフ先は承認ゲートを継承 (PJ34 run_mode伝播ルール準拠) |
週次改善ループ
PJ34 weekly-improve 移植
- Hermes cron: 毎週日曜 → COOが GEPA 実行 → スキル改善提案 → Founder承認で適用
- 実装予定: PJ34の
scripts/weekly-improve.ts のロジックを Hermes スキルとして再実装 (Phase 5)
cronスケジューラ (組み込み)
- ゲートウェイデーモン 60秒間隔チェック → 期限到達ジョブを独立セッションで実行
- 自然言語 → cron式自動変換 / ワンショット遅延 / 定期インターバル / 標準cron式
context_from フラグで前cronの出力を次cronの入力にチェーン可--skill フラグでスキル添付実行- 保存:
~/.hermes/cron/jobs.json / 出力: ~/.hermes/cron/output/
MCP接続 (外部ツール統合)
- Native MCP Client:
hermes mcp add で MCP サーバーを追加。起動時に自動接続・ツール検出・全プロファイルで利用可能
- 設定:
~/.hermes/config.yaml の mcp_servers キー
- 対応形式: stdio (npx/uvx) / HTTP / StreamableHTTP
- 実行場所: 全て Mac mini 上で起動。メイン機の MCP は使用しない
| MCP サーバー | 用途 | 主な利用プロファイル |
|---|
| vault-rag | Obsidian Vault セマンティック検索 | COO / PM |
| Slack | チャンネル読み書き | Marketing / News |
| Gmail | メール検索・ドラフト | Sales / COO |
| Calendar | スケジュール管理 | COO / PM |
| Notion | 外部公開ページ管理 | PM / Marketing |
| Google Drive | ファイル検索・読み書き | 全プロファイル |
| Playwright | ヘッドレス Chromium (X投稿・Web操作) | Marketing / Dev / Sales |
コスト予算 (6/15〜)
| 項目 | 月額 | 備考 |
|---|
| Hermes Agent (LLM) | $0 | SuperGrok OAuth |
| Codex CLI (DevSymphony) | $0 | ChatGPT Plus Rate Limit制 |
| Claude API (Fallback-1) | 従量 | Grok障害時のみ発生。通常$0 |
| GEPA最適化 (任意) | $2-10/回 | オフライン・スキル最適化時のみ |
| X API PPU | ~$20 | |
| Mac mini 電気代 | ~¥500-1,000 | M4 Pro 常時稼働 (実測待ち) |
| 固定費合計 | ~$20 + ¥1,000 | 自動化パイプライン全体 |
| Claude Code (任意) | 従量 | メイン機でFounder手動利用。アーキテクチャ外 |
| Mac mini 本体 (初期) | ¥298,800〜 | M4 Pro / 48GB (一括) |
v3.2 コスト構造: Hermes ($0 Grok) + Codex CLI ($0 ChatGPT Plus) で LLM 費用ゼロ。フォールバック時のみ Claude API / OpenAI API 従量発生。Mac mini 専用機の電気代 (~¥1,000/月) のみ固定追加。
Phase計画
| Phase | 内容 | 状態 |
|---|
1 | NanoClaw セットアップ + Slack PoC | Hermes移行 |
| 1' | Hermes Agent セットアップ + CLI/Telegram PoC (メイン機) | 完了 (2026-05-18) |
| 2 | Mac mini セットアップ (OS初期設定・SSH・Google Drive同期・Tailscale) | 未着手 |
| 3 | Hermes移植 (hermes-migrate.sh・config移行・SuperGrok OAuth再認証) | 未着手 |
| 4 | Claude API / OpenAI API フォールバック設定 (config.yaml fallback_providers) | 未着手 |
| 5 | MCP サーバー接続 (vault-rag / Slack / Gmail / Calendar / Playwright) | 未着手 |
| 6 | Telegram Bot 設定 (Mac mini常駐・Founder↔Hermes リモート経路) | 未着手 |
| 7 | プロファイル構築 (COO / PM / Marketing / News / Dev / Sales / Finance / Watchdog) | 未着手 |
| 8 | Dev → Codex CLI 統合 (DevSymphony) | 未着手 |
| 9 | launchd 常駐化 + cron本番投入 (Hermes + Ollama + Watchdog死活監視) | 未着手 |
| 10 | Agent Swarms 統合テスト + パイプライン検証 | 未着手 |
| 11 | 本番運用 + KPIモニタリング | 継続 |
Claude Code (メイン機専用 — アーキテクチャ外)
- 位置づけ: Hermes アーキテクチャの外。メイン機で Founder が手動起動する個人ツール
- 実行場所: メイン機のみ。Mac mini にはインストールしない
- 用途: 複雑な分析・Vault横断リファクタ・PJ34開発等、必要時のみ
- コスト: 従量課金 (6/15〜)。自動起動は一切行わない
- コマンド:
cc (Sonnet) / cc-opus (Opus)
- Mac miniとの連携: Claude Code → Hermes への直接指示はしない。Vault Push → Hermes 側が pull/MCP で検知する間接連携
Codex CLI (DevSymphony エンジン)
CLICodex CLI v0.115.0 (ChatGPT Plus サブスクリプション)
Scopeuser scope (全PJ共通)
Commandscodex (直接) / /codex:rescue / /codex:review / /codex:adversarial-review
起動経路Hermes Devプロファイル → codex CLI / Founder手動
コスト$0 (ChatGPT Plus Rate Limit制 — 追加API課金なし)
安全ルールPRマージFounder必須 / package.json・.env変更禁止
レビューCodex adversarial-review + Founder最終確認
技術選定経緯
| Ver | 日付 | 内容 |
|---|
| v1 | 3/7 | Claude Code Agent Teams 単独 (しゅうへい式) |
| v2 | 3/9 | NanoClaw発見。OpenClaw却下 (CVE 20+)。NanoClaw + Claude Code + DevSymphony 3層決定 |
| v2.4 | 4/27 | Mercury Agent比較。Soul 4ファイル・Token Budget・安全設計の3点取り込み |
| v2.5 | 5/1 | Unified Memory Core確立。Oracle DevRel記事の4種メモリ設計をOracle 23ai前提で採用（→v3.0でPJ34に移管） |
| v2.6 | 5/20 | Masterclass記事でHermes内部構造補完。メモリ3層 / Curator / GEPA / プロファイル / Claude Code統合 / cronスケジューラ |
| v2.7 | 5/20 | CC課金変更(6/15)対応。Layer 2=Founder手動のみ / Layer 3=Codex CLIに切替 / Supabase→Oracle 23ai統一 |
| v3.0 | 5/20 | Layer概念廃止。Hermes統合アーキテクチャに移行。Agent Organization + MCP + DevSymphony 全て Hermes 内部。CC=アーキテクチャ外のFounderツール |
| v3.1 | 5/20 | Mac mini (M4 Pro/48GB) 自動化専用機導入。2マシンアーキテクチャ。Ollama追加 (ローカルLLMフォールバック)。Telegram Bot常時起動。ヘッドレス運用→Playwright MCP統一。Phase計画11段階再構成 |
| v3.2 | 5/20 | Ollama廃止。フォールバックをClaude API Sonnet / OpenAI API GPT-5.4に変更。Mac mini RAM要件緩和 (48GB必須→16〜24GB検討可)。ADR-18 superseded |
LLMモデル選定
- カタログ:
02_Knowledge/tech/llm-model-catalog.md
- 選定基準: PinchBench成功率80%以上 × Best Cost $0.20以下
- 旧NanoClaw社員別Worker (廃止):
Andy=Nano / Dev太郎=GLM / マーケ子=Kimi / ニュース郎=DeepSeek / セールス助=MiniMax
- 現行 (v3.2): プライマリ = Grok 4.3 (SuperGrok OAuth・$0)。Fallback-1 = Claude API Sonnet (従量)。Fallback-2 = OpenAI API GPT-5.4 (従量)。中国系プロバイダ使用禁止。Ollama 非採用 (Mac mini RAM要件緩和)
メモリ構成
PJ09はDB不要。Mac miniのローカルストレージに全データ
Mac mini
└─ Hermes Agent ──> 内蔵メモリ + MCP経由 Vault
│
├─ 内蔵 Tier 1: MEMORY.md + USER.md
├─ 内蔵 Tier 2: SQLite FTS5
├─ 内蔵 Tier 3: 外部プロバイダ
│
└─ MCP ──> Obsidian Vault (vault-rag)
│ (Google Drive同期先パス)
├─ Episodic: Daily Notes
├─ Semantic: sqlite-vec + bge-m3
├─ Lexical: 全文検索
└─ Relational: バックリンク
UMC Phase B → PJ34に移管（2026-05-20）: Oracle 23ai統合メモリ（4種メモリ統合設計）は、顧客テナント分離・World Modelが必要なPJ34 (ReraFlow AI Autopilot) の責務。PJ09ローカル自動化にDBは不要。設計資産は 02_Knowledge/decisions/2026-05-01_pj09-unified-memory-core.md に保存済み → PJ34が継承。
Last updated: 2026-05-20 v3.2 — Ollama廃止・Claude API/OpenAI APIフォールバック化・Mac mini RAM要件緩和・ADR-18 superseded