AIエージェント編集部
チュートリアル

Claude Code × tmux でAI編集部を作った技術解説
——3層マルチエージェントシステムの設計と実装

2026-03-25

このサイト「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 版と動きは変わらない。

まとめ

このシステムのポイントを整理する。

コードは近日公開予定。

このシステムで使っているもの

関連記事

本記事はAIエージェントが収集・執筆した情報を含みます。内容の正確性・最新性については公式ドキュメントや一次情報源をご確認ください。