このサイト「AIエージェント編集部」は、Claude Code と tmux を組み合わせた3層マルチエージェントシステムで記事を生成・公開している。本記事では、そのシステム設計と実装の詳細を解説する。
システム全体像
構成は3層になっている。
オーナー(人間)
↓ 口頭指示
Layer 1: 編集長(マツ)— chief_editor
↓ queue/chief_to_deputy.yaml
Layer 2: 副編集長(みさっち)— deputy_editor
↓ queue/tasks/{role}.yaml
Layer 3: 編集部員 × 5
玄翔(researcher)
あかりん(writer_a)
タイキング(writer_b)
霜凜(proofreader)
ケンケン(publisher)
各層は YAML ファイルを介して通信する。上位層が YAML を書き、下位層がそれを読んでタスクを実行する。完了したら result フィールドに結果を書き、上位層に通知する。
tmuxセッション設計
tmux セッション名は editorial-room。3つのウィンドウで構成する。
editorial-room
├── chief : 編集長(Claude Code インスタンス)
├── deputy : 副編集長(Claude Code インスタンス)
└── newsroom : 編集部員 × 5(2×3グリッド, pane .1〜.5)
├── .1 玄翔(researcher)
├── .2 あかりん(writer_a)
├── .3 タイキング(writer_b)
├── .4 霜凜(proofreader)
└── .5 ケンケン(publisher)
各ウィンドウは setup.sh で作成し、start.sh で Claude Code を起動する。
tmux send-keys の2ステップルール
tmux 経由でエージェントにメッセージを送る際、メッセージと Enter を必ず2回に分けて送ることが重要だ。1回でまとめると Enter が無視されることがある。
# ❌ 動かないことがある
tmux send-keys -t editorial-room:chief "メッセージ" Enter
# ✅ 確実に動く
tmux send-keys -t editorial-room:chief "メッセージ"
tmux send-keys -t editorial-room:chief Enter
この挙動に気づくまで、エージェントへの指示が届いていない問題が断続的に発生していた。scripts/send.sh ヘルパーを用意して、2ステップを自動化している。
YAMLキュー設計
エージェント間の通信は YAML ファイルで行う。メッセージキューの役割を担う。
chief_to_deputy.yaml(編集長→副編集長)
task_id: "article_001"
timestamp: "2026-03-25T10:00:00"
from: "chief_editor"
to: "deputy_editor"
command: "本日のデイリー2本を制作すること"
context: |
ai-news-20260325 と claude-news-20260325 を制作する。
相互リンクを必ず入れること。
status: "pending"
tasks/{role}.yaml(副編集長→編集部員)
task_id: "article_001_researcher"
parent_task_id: "article_001"
assigned_to: "researcher"
depends_on: []
command: "モードA(AI全般)とモードB(Claude専門)の両方をリサーチせよ"
status: "pending"
result: ""
result フィールドが空・「TODO」・20文字未満の場合は不十分とみなし、再提出を要求する。これにより「完了したふり」を防いでいる。
また、YAML を書いたら即 git commit する運用にしている。git restore によるロールバックで作業中の YAML が消える事故を防ぐためだ。
4フェーズワークフロー
記事1本の生成は4つのフェーズで構成される。
Phase 1: researcher → 競合調査・キーワード分析・構成案
Phase 2: writer_a/b → 記事HTML生成(depends_on: Phase1)
Phase 3: proofreader → SEO・校閲・構造化データ(depends_on: Phase2)
Phase 4: publisher → build_index.sh → FTPS upload(depends_on: Phase3)
各フェーズは前フェーズの完了を待つ(depends_on)。publisher は FTPS アップロード後、X(Twitter)への告知投稿まで行う。
権限設定(settings.json)
Claude Code の権限設定は .claude/settings.json で管理する。各エージェントがファイル保存・スクリプト実行を自動承認できるよう、allow リストを整備している。
{
"permissions": {
"allow": [
"Write(site/*)",
"Write(queue/*)",
"Bash(bash scripts/build_index.sh)",
"Bash(bash scripts/publish.sh*)",
"Bash(python3 scripts/post_x.py *)",
"Bash(git add *)",
"Bash(git commit *)",
"Bash(git push)"
],
"deny": [
"Bash(rm -rf*)",
"Bash(lftp*)"
]
}
}
設計の失敗談: 当初 Write 権限の自動承認が漏れており、ライターがHTMLを保存しようとするたびに処理が止まっていた。権限が足りないとサブエージェントが詰まり、その場で編集長が代わりに書いてしまうという本末転倒な事態が発生。これを機に権限設定を見直し、シングルセッション時の委任プロトコルも明文化した。
デイリー自動チェック
newsroom.sh にチェックスクリプトを組み込んでいる。起動時に当日分の記事が存在しなければ、編集長に自動で指示が飛ぶ。
# scripts/check_today.sh(抜粋)
TODAY="$(date +%Y%m%d)"
AI_NEWS_DIR="site/articles/$YEAR/ai-news-$TODAY"
CLAUDE_NEWS_DIR="site/articles/$YEAR/claude-news-$TODAY"
MISSING=()
[[ -f "$AI_NEWS_DIR/index.html" ]] || MISSING+=("ai-news-$TODAY")
[[ -f "$CLAUDE_NEWS_DIR/index.html" ]] || MISSING+=("claude-news-$TODAY")
if [[ ${#MISSING[@]} -gt 0 ]]; then
./scripts/send.sh chief "本日分の未更新記事があります: ${MISSING[*]}"
fi
シングルセッション運用
tmux が未起動の場合も、委任の流れは変えない。Claude Code の Agent ツールでサブエージェントを直接起動し、通常の tmux フローを再現する。
# 編集長がシングルセッションでみさっちを起動する例
Agent(
subagent_type="general-purpose",
prompt="""あなたはみさっち(副編集長)です。
instructions/deputy_editor.md を読んで役割を把握してください。
queue/chief_to_deputy.yaml を読んでミッションを確認し、
4フェーズワークフローを開始してください。"""
)
各担当者は自分の role.yaml を読み、成果物を Write ツールで直接保存する。tmux 版と動きは変わらない。
まとめ
このシステムのポイントを整理する。
- 3層構造: 編集長→副編集長→編集部員の委任連鎖で責任を分散
- YAMLキュー: ファイルベースの非同期通信で各エージェントが独立して動く
- 権限設定: settings.json の allow/deny リストで安全な自動化
- 4フェーズ: リサーチ→執筆→校閲→公開の流れを固定し再現性を高める
- 失敗パターンの記録: memory/MEMORY.md に詰まりの原因と対処を蓄積
コードは近日公開予定。