自律エージェントフレームワーク

ネイティブ機能と MCP サーバーのみを使用して、Claude Code を永続化された自己指向型エージェントシステムに変換します。

同意とセキュリティ境界

自律操作はユーザーによる明示的な要求とスコープの定義が必要です。ユーザーがその機能と現在のワークスペース設定の目標を承認した場合を除き、スケジュール、リモートエージェント、永続化メモリへの書き込み、コンピュータ制御の使用、外部コンテンツの公開、第三者のリソース変更、またはプライベート通信の処理を行わないでください。

定期または イベント駆動型の操作を有効にする前に、計画の事前実演とローカルキューファイルの使用を優先します。認証情報、プライベートワークスペースのエクスポート、個人データセット、アカウント固有の自動化を再利用可能な ECC アーティファクトから除外します。

有効化のタイミング

• ユーザーが継続実行または定時実行するエージェントが必要
• 定期トリガーを設定した自動化ワークフロー
• セッション間でコンテキストを記憶する個人 AI アシスタントの構築
• ユーザーが「毎日実行」「定期的にチェック」「継続的に監視」と言っている
• Hermes、AutoGPT、または類似の自律エージェントフレームワークの機能を複製したい
• コンピュータ使用と計画実行の組み合わせが必要

アーキテクチャ

┌──────────────────────────────────────────────────────────────┐
│                    Claude Code ランタイム                     │
│                                                              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────┐ │
│  │定時タスク │  │リモート   │  │メモリ    │  │コンピュータ │ │
│  │スケジュラ │  │スケジュリ │  │ストレージ│  │使用         │ │
│  │           │  │ング代理   │  │          │  │             │ │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └──────┬──────┘ │
│       │              │             │                │        │
│       ▼              ▼             ▼                ▼        │
│  ┌──────────────────────────────────────────────────────┐    │
│  │              ECC スキル + エージェント層              │    │
│  │                                                      │    │
│  │  skills/     agents/     commands/     hooks/        │    │
│  └──────────────────────────────────────────────────────┘    │
│       │              │             │                │        │
│       ▼              ▼             ▼                ▼        │
│  ┌──────────────────────────────────────────────────────┐    │
│  │              MCP サーバー層                           │    │
│  │                                                      │    │
│  │  memory    github    exa    supabase    browser-use  │    │
│  └──────────────────────────────────────────────────────┘    │
└──────────────────────────────────────────────────────────────┘

コアコンポーネント

1. 永続化メモリ

Claude Code の組み込みメモリシステムを使用し、構造化データを処理するために MCP メモリサーバーで強化します。

組み込みメモリ（~/.claude/projects/*/memory/）：

• ユーザー設定、フィードバック、プロジェクトコンテキスト
• フロントマターメタデータを含む Markdown ファイルとして保存
• セッション開始時に自動ロード

MCP メモリサーバー（構造化知識グラフ）：

• エンティティ、関係、観察
• クエリ可能なグラフ構造
• セッション間の永続化

メモリパターン：

# 短期：現在のセッションコンテキスト
セッション内タスク追跡に TodoWrite を使用

# 中期：プロジェクトメモリファイル
セッション間の回想のため ~/.claude/projects/*/memory/ に書き込み

# 長期：MCP 知識グラフ
mcp__memory__create_entities で永続的な構造化データを作成
mcp__memory__create_relations で関係マッピングを実行
mcp__memory__add_observations で既知エンティティについて新しい事実を追加

2. スケジュール操作（定時タスク）

Claude Code のスケジュール機能を使用して定期的なエージェント操作を作成します。

定時タスクの設定：

# MCP ツール経由
mcp__scheduled-tasks__create_scheduled_task({
  name: "daily-pr-review",
  schedule: "0 9 * * 1-5",  # 平日午前9時
  prompt: "Review all open PRs in affaan-m/everything-claude-code. For each: check CI status, review changes, flag issues. Post summary to memory.",
  project_dir: "/path/to/repo"
})

# claude -p（プログラムモード）経由
echo "Review open PRs and summarize" | claude -p --project /path/to/repo

便利なスケジュール化パターン：

パターン	スケジュール	ユースケース
日次スタンドアップ	0 9 * * 1-5	PR、イシュー、デプロイステータスのレビュー
週次レビュー	0 10 * * 1	コード品質メトリクス、テストカバレッジ
時間単位の監視	0 * * * *	本番環境の健全性、エラー率チェック
夜間ビルド	0 2 * * *	フルテストスイート実行、セキュリティスキャン
会議前準備	*/30 * * * *	今後の会議用コンテキスト準備

3. スケジューリング / リモートエージェント

イベント駆動型ワークフローのために Claude Code エージェントをリモートトリガーします。

スケジューリングパターン：

# CI/CD からトリガー
curl -X POST "https://api.anthropic.com/dispatch" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -d '{"prompt": "Build failed on main. Diagnose and fix.", "project": "/repo"}'

# Webhook からトリガー
# GitHub webhook → dispatch → Claude agent → fix → PR

# 別のエージェントからトリガー
claude -p "Analyze the output of the security scan and create issues for findings"

4. コンピュータ使用

物理世界とのインタラクション用に Claude のコンピュータ使用 MCP を活用します。

機能：

• ブラウザ自動化（ナビゲーション、クリック、フォーム入力、スクリーンショット）
• デスクトップコントロール（アプリ起動、入力、マウス制御）
• CLI を超えたファイルシステム操作

フレームワーク内のユースケース：

• Web UI の自動テスト
• フォーム入力とデータエントリー
• スクリーンショットベースの監視
• マルチアプリケーションワークフロー

5. タスクキュー

セッション境界を越えた永続化タスクキューを管理します。

実装：

# メモリを通じたタスク永続化
タスクキューを ~/.claude/projects/*/memory/task-queue.md に書き込み

# タスク形式
---
name: task-queue
type: project
description: 自律操作用の永続化タスクキュー
---

## アクティブなタスク
- [ ] PR #123: レビューして CI 合格後に承認
- [ ] デプロイメント監視：/health を 30 分ごとにチェック、2 時間継続
- [ ] リサーチ：AI ツール領域の潜在的顧客 5 社を探す

## 完了
- [x] 日次スタンドアップ：3 つの PR、2 つのイシューをレビュー

Hermes の置き換え

Hermes コンポーネント	ECC 相当機能	実装方法
ゲートウェイ/ルーター	Claude Code スケジューリング + 定時タスク	スケジュール済みタスクがエージェントセッションをトリガー
メモリシステム	Claude メモリ + MCP メモリサーバー	組み込みの永続化 + 知識グラフ
ツールレジストリ	MCP サーバー	動的にロードされるツールプロバイダー
オーケストレーション	ECC スキル + エージェント	スキル定義がエージェント動作をガイド
コンピュータ使用	コンピュータ使用 MCP	ネイティブブラウザおよびデスクトップコントロール
コンテキストマネージャー	セッション管理 + メモリ	ECC 2.0 セッションライフサイクル
タスクキュー	メモリ永続化タスク一覧	TodoWrite + メモリファイル

セットアップガイド

ステップ 1：MCP サーバーの構成

これらが ~/.claude.json にあることを確認してください：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@anthropic/memory-mcp-server"]
    },
    "scheduled-tasks": {
      "command": "npx",
      "args": ["-y", "@anthropic/scheduled-tasks-mcp-server"]
    },
    "computer-use": {
      "command": "npx",
      "args": ["-y", "@anthropic/computer-use-mcp-server"]
    }
  }
}

ステップ 2：基本的なスケジュール済みタスクを作成

# 朝のブリーフィング
claude -p "Create a scheduled task: every weekday at 9am, review my GitHub notifications, open PRs, and calendar. Write a morning briefing to memory."

# 継続的な学習
claude -p "Create a scheduled task: every Sunday at 8pm, extract patterns from this week's sessions and update the learned skills."

ステップ 3：メモリグラフの初期化

# アイデンティティとコンテキストをブートストラップ
claude -p "Create memory entities for: me (user profile), my projects, my key contacts. Add observations about current priorities."

ステップ 4：コンピュータ使用の有効化（オプション）

コンピュータ使用 MCP にブラウザとデスクトップコントロールのアクセス許可を付与します。

ワークフロー例

自律 PR レビューアー

Cron：営業時間内 30 分ごと実行
1. ウォッチ中のリポジトリの新規 PR をチェック
2. 各新規 PR について：
   - ローカルでブランチをプル
   - テストを実行
   - コードレビューエージェントで変更をレビュー
   - GitHub MCP 経由でレビューコメントを公開
3. レビューステータスをメモリに更新

個人研究エージェント

Cron：毎日午前 6 時実行
1. メモリに保存された検索クエリをチェック
2. 各クエリについて Exa 検索を実行
3. 新しい発見をまとめる
4. 昨日の結果と比較
5. 摘要をメモリに書き込み
6. 朝のレビュー用に高優先度アイテムをマーク

会議準備エージェント

トリガー：各カレンダーイベント 30 分前
1. カレンダーイベントの詳細を読み込み
2. 参加者についてのメモリバックアップ情報を検索
3. 参加者との最近のメール/Slack ディスカッションを抽出
4. 話題のポイントとアジェンダ案を準備
5. 準備文書をメモリに書き込み

制約

• スケジュール済みタスクは分離されたセッションで実行される - メモリを通じない限り、対話型セッションとコンテキストを共有しません。
• コンピュータ使用は明示的なアクセス許可が必要です。アクセスできると想定しないでください。
• リモートディスパッチにはレート制限がある可能性があります。スケジュール済みタスクを設計する際に適切な間隔を使用してください。
• メモリファイルは簡潔に保つべきです。ファイルが無限に増加しないように古いデータをアーカイブします。
• スケジュール済みタスクが正常に完了したことを常に確認してください。スケジュール済みタスクのプロンプトにエラーハンドリングを追加します。