claude-delegate-pattern

Claude Code をオーケストレーター（親）に据え、Codex CLI と Gemini CLI (AGY) を並列サブエージェントとして非同期駆動する「delegateパターン」のskillファイル集です。

なぜdelegateパターンが必要か

単一のAIエージェントに全ての作業を任せると、3つの壁にぶつかります。

壁	症状
コンテキスト上限	ログが肥大化 → 指示を忘れる、動作が重くなる
レート制限	同一プロバイダーを酷使 → APIが止まる
直列処理の遅さ	調査→実装→レビューを1体が順番にこなす → 全体が遅い

delegateパターンはこれを役割分担 + 並列 + ファイルベース通信で解決します。

Lux / Claude Code（親・オーケストレーター）
  ├─ Codex CLI ──→ Tasks/codex_task.md ──→ Reports/codex_report.md
  └─ AGY (Gemini CLI) ──→ Tasks/agy_task.md ──→ Reports/agy_report.md
                               ↓
                    親が全レポートを読んで統合・tama（人間）に報告

アーキテクチャの3原則

1. 親子関係を明確に：Claude Codeが唯一の意思決定者。CodexとAGYは実行者。
2. Obsidianを通信チャネルに：タスクと成果物をMarkdownファイルで管理。エージェントごとに書き込み先を分離して競合ゼロ。
3. 完了通知はClaudeのサブエージェントインフラに乗せる：codex exec / agy --prompt をBashで呼ぶと、Claude Codeがサブエージェントとして認識 → Monitor不要で完了通知が届く。

セットアップ

必要なもの

ツール	インストール	備考
Claude Code	claude.ai/code	親エージェント
Codex CLI	npm install -g @openai/codex → codex login	OpenAIアカウント必要
Gemini CLI (AGY)	npm install -g @google/gemini-cli → agy auth	Googleアカウント必要
Obsidian	obsidian.md	タスク・ログ管理Vault

skillファイルの設置

1. skills/delegate.md をダウンロード
2. Claude Codeに以下を送る：

このファイルを読んでskillを作成してください：
[delegate.mdのパス or 内容を貼り付け]

3. 自分のObsidian Vaultパスに合わせてパスを書き換える

実装例

# Obsidianにタスクファイルを作成（Claude Codeが自動で行う）
# Tasks/codex_research.md ← Codex用
# Tasks/agy_review.md     ← AGY用

# Codex をバックグラウンドで起動（Claude CodeのBashツールでrun_in_background=trueで実行）
codex exec "Tasks/codex_research.md を読んで結果を Reports/codex_research.md に書け"

# AGY を同時にバックグラウンドで起動
agy --prompt "Tasks/agy_review.md を読んで結果を Reports/agy_review.md に書け" --dangerously-skip-permissions

ファイル構成

claude-delegate-pattern/
├── README.md
├── skills/
│   └── delegate.md          # Claude Codeに読ませるskillファイル
└── examples/
    └── task_template.md     # Obsidianタスクファイルのテンプレート

agmsg（リアルタイムバス）との比較

評価軸	agmsg	delegate（このパターン）
通信方式	SSE / WebSocket	ファイルI/O
信頼性	接続エラー・ストリーム瞬断あり	シンプル・堅牢
ログ永続性	揮発的	Obsidianに永続保存
実装コスト	高い	低い（標準CLIのみ）
用途	リアルタイム対話	調査・実装・レビュー

調査・実装・レビューなどの「依頼→成果物」型タスクにはdelegateが最適。

License

MIT