dmux ワークフロー

dmux を使用して平行 AI エージェント セッションをオーケストレーションします。dmux はエージェント ハーネス用の tmux ペーン マネージャーです。

アクティベーション条件

• 複数のエージェント セッションを並行実行している
• Claude Code、Codex、その他のハーネス全体で作業を調整している
• 分割統治並列化の利点がある複雑なタスク
• ユーザーが「並行実行」「この作業を分割」「dmux を使用」「マルチエージェント」と言った場合

dmux とは

dmux は AI エージェント ペーンを管理する tmux ベースのオーケストレーション ツールです：

• n を押して新しいペーンをプロンプトで作成
• m を押してペーン出力をメイン セッションにマージ
• サポート対象：Claude Code、Codex、OpenCode、Cline、Gemini、Qwen

インストール： npm install -g dmux または github.com/standardagents/dmux を参照

クイック スタート

# dmux セッション開始
dmux

# エージェント ペーン作成 (dmux で 'n' を押してからプロンプト入力)
# ペーン 1: "Implement the auth middleware in src/auth/"
# ペーン 2: "Write tests for the user service"
# ペーン 3: "Update API documentation"

# 各ペーンが独自のエージェント セッション実行
# 'm' を押して結果をマージバック

ワークフロー パターン

パターン 1: リサーチ + 実装

リサーチと実装を並行トラックに分割：

ペーン 1 (リサーチ): "Research best practices for rate limiting in Node.js.
  Check current libraries, compare approaches, and write findings to
  /tmp/rate-limit-research.md"

ペーン 2 (実装): "Implement rate limiting middleware for our Express API.
  Start with a basic token bucket, we'll refine after research completes."

# ペーン 1 完了後、ペーン 2 のコンテキストに結果をマージ

パターン 2: マルチファイル機能

独立したファイル全体で作業を並列化：

ペーン 1: "Create the database schema and migrations for the billing feature"
ペーン 2: "Build the billing API endpoints in src/api/billing/"
ペーン 3: "Create the billing dashboard UI components"

# すべてマージして、メイン ペーンで統合実施

パターン 3: テスト + 修正ループ

1 つのペーンでテスト実行、別ペーンで修正：

ペーン 1 (ウォッチャー): "Run the test suite in watch mode. When tests fail,
  summarize the failures."

ペーン 2 (フィッサー): "Fix failing tests based on the error output from pane 1"

パターン 4: クロス ハーネス

異なるタスクに異なる AI ツール使用：

ペーン 1 (Claude Code): "Review the security of the auth module"
ペーン 2 (Codex): "Refactor the utility functions for performance"
ペーン 3 (Claude Code): "Write E2E tests for the checkout flow"

パターン 5: コード レビュー パイプライン

平行レビュー観点：

ペーン 1: "Review src/api/ for security vulnerabilities"
ペーン 2: "Review src/api/ for performance issues"
ペーン 3: "Review src/api/ for test coverage gaps"

# すべてのレビューを 1 つのレポートにマージ

ベスト プラクティス

1. 独立したタスクのみ。 互いの出力に依存するタスクを並列化しないこと。
2. 明確な境界。 各ペーンは別々のファイルまたは関心事で作業すること。
3. 戦略的なマージ。 マージ前にペーン出力を確認して競合を回避すること。
4. Git worktree 使用。 ファイル競合が起こりやすい作業の場合、ペーンごとに別々の worktree を使用すること。
5. リソース認識。 各ペーンが API トークンを使用 — 合計ペーン数を 5～6 以下に保つこと。

Git Worktree 統合

重複するファイルに影響するタスク：

# 分離用に worktree 作成
git worktree add ../feature-auth feat/auth
git worktree add ../feature-billing feat/billing

# 別々の worktree でエージェント実行
# ペーン 1: cd ../feature-auth && claude
# ペーン 2: cd ../feature-billing && claude

# 完了時にブランチをマージ
git merge feat/auth
git merge feat/billing

補完ツール

ツール	機能	使用時期
dmux	エージェント用 tmux ペーン管理	平行エージェント セッション
Superset	10 個以上の並行エージェント用ターミナル IDE	大規模オーケストレーション
Claude Code Task ツール	プロセス内サブエージェント起動	セッション内での規則的な並列化
Codex マルチエージェント	組み込みエージェント ロール	Codex 固有の並行作業

トラブルシューティング

• ペーンが応答しない： エージェント セッションが入力を待機しているか確認。m を使用して出力を読む。
• マージ競合： git worktree を使用してペーンごとにファイル変更を分離。
• 高トークン使用量： 並行ペーン数を減らす。各ペーンは完全なエージェント セッション。
• tmux が見つからない： brew install tmux (macOS) または apt install tmux (Linux) でインストール。