ensemble-claude 0.3.1__py3-none-any.whl → 0.4.1__py3-none-any.whl

ensemble/templates/commands/go-issue.md

@@ -0,0 +1,157 @@
+---
+description: |
+  GitHubのIssueを取得し、/goコマンドで実装を開始する。
+  Issue一覧から選択するか、番号を直接指定できる。
+  mainブランチから作業ブランチを作成し、完了後はPR作成を確認する。
+
+  使用例:
+    /go-issue              - Issue一覧から選択
+    /go-issue 123          - Issue #123を直接指定
+    /go-issue --url <URL>  - URLでIssueを指定
+---
+
+以下のワークフローでIssueベースの開発を行います。
+
+## 入力
+
+$ARGUMENTS
+
+## ワークフロー
+
+### Step 1: Issue取得
+
+1. **引数の解析**:
+   - 引数なし → Issue一覧を取得して表示
+   - 番号あり → その番号のIssueを直接取得
+   - `--url` → URLからIssueを取得
+
+2. **Issue一覧の場合** (`gh issue list --json number,title,body,url,state,labels`):
+   - 0件: 「オープンなIssueがありません」で終了
+   - 1件: 確認後に自動選択
+   - 2件以上: 番号付きリストで表示し、ユーザーに選択させる
+
+   表示例:
+   ```
+   オープンなIssue一覧:
+
+   1. #42 [bug] ログイン時にエラーが発生する
+   2. #38 [feature] ダークモード対応
+   3. #35 [docs] READMEの更新
+
+   実装するIssueの番号を入力してください (1-3):
+   ```
+
+3. **Issue詳細の確認**:
+   - タイトル、本文、ラベルを表示
+   - 「このIssueで作業を開始しますか？」と確認
+
+### Step 2: ブランチ作成
+
+1. **現在の状態確認**:
+   ```bash
+   git status --porcelain
+   ```
+   - 未コミットの変更がある場合は警告し、続行するか確認
+
+2. **mainブランチに移動して最新化**:
+   ```bash
+   git checkout main
+   git pull origin main
+   ```
+
+3. **作業ブランチを作成**:
+   ```bash
+   git checkout -b issue/<番号>-<slug>
+   ```
+   例: `issue/42-fix-login-bug`
+
+4. **作成完了を報告**:
+   ```
+   ブランチ 'issue/42-fix-login-bug' を作成しました。
+   ```
+
+### Step 3: /goコマンドに委譲
+
+以下の形式でタスクを構築し、/goコマンドの処理を実行する:
+
+```
+## Issue #<番号>: <タイトル>
+
+### 説明
+<Issue本文>
+
+### ラベル
+<ラベル一覧>
+
+### 完了条件
+- このIssueで要求された機能/修正を実装する
+- テストを追加する（必要に応じて）
+- コードレビューに通るコードを書く
+```
+
+**注意**: `/go`コマンドのskillを呼び出すのではなく、このコマンド内でConductorとして計画・実行を行う。
+
+### Step 4: PR作成確認
+
+実装完了後:
+
+1. **変更のサマリーを表示**:
+   ```bash
+   git diff main --stat
+   ```
+
+2. **PR作成の確認**:
+   ```
+   実装が完了しました。Pull Requestを作成しますか？
+
+   [Y] 作成する
+   [N] 後で作成する
+   [E] コミットメッセージを編集してから作成
+   ```
+
+3. **PR作成** (Yの場合):
+   ```bash
+   gh pr create --title "Fix: <Issueタイトル>" --body "Closes #<番号>
+
+   ## 変更内容
+   <自動生成されたサマリー>
+
+   ## テスト
+   - [ ] 単体テスト追加
+   - [ ] 手動テスト実施
+   "
+   ```
+
+4. **PR URLを表示**:
+   ```
+   Pull Request を作成しました:
+   https://github.com/owner/repo/pull/XX
+   ```
+
+## プロバイダー対応
+
+現在対応しているプロバイダー:
+- **GitHub** (`gh` CLI): 完全対応
+- **GitLab** (`glab` CLI): 今後対応予定
+
+プロバイダーは自動検出する:
+1. `gh` コマンドが利用可能 → GitHub
+2. `glab` コマンドが利用可能 → GitLab
+3. どちらも利用不可 → エラー
+
+## エラーハンドリング
+
+| 状況 | 対応 |
+|------|------|
+| `gh`/`glab` 未インストール | インストール方法を案内して終了 |
+| リポジトリ外で実行 | 「Gitリポジトリで実行してください」 |
+| オープンなIssueなし | 「オープンなIssueがありません」で終了 |
+| 指定番号のIssueなし | 「Issue #XX は見つかりませんでした」 |
+| ブランチ作成失敗 | エラー詳細を表示、手動での対応を案内 |
+| PR作成失敗 | エラー詳細を表示、`gh pr create`コマンドを案内 |
+
+## 注意事項
+
+- Conductorは自分でコードを書かず、適切なエージェントに委譲する
+- Issue本文が曖昧な場合は、ユーザーに追加情報を求める
+- 大規模なIssueはサブタスクに分解することを提案する

ensemble/templates/commands/go.md

@@ -49,10 +49,10 @@ $ARGUMENTS
 
 3. パターンに応じて実行:
 
-   **パターンA（takt方式）**:
-   - Taskツール（subagent）で直接実行
-   - Dispatch不要、Conductorが直接管理
-   - シンプルで高速
+   **パターンA（単一Worker）**:
+   - Dispatch経由でWorker1つで実行
+   - Conductorは計画・判断・委譲のみ
+   - 軽量タスクでも設計思想を遵守
 
    **パターンB（shogun方式）**:
    1. `queue/conductor/dispatch-instruction.yaml` に指示を書く
@@ -69,6 +69,21 @@ $ARGUMENTS
 
 4. 実行中は `status/dashboard.md` を都度更新（Dispatchが担当）
 
+### 完了待機（全パターン共通）
+
+Dispatchへの委譲後、ポーリングで完了を待機:
+
+```bash
+# 完了待機（30秒間隔）
+while [ ! -f "queue/reports/completion-summary.yaml" ]; do
+  sleep 30
+done
+```
+
+完了検知後:
+1. completion-summary.yaml を読み込み
+2. Phase 3（レビュー）へ進む
+
 ### Phase 3: レビュー
 
 5. 全サブタスク完了後、並列レビューを実行:

ensemble/templates/scripts/launch.sh

@@ -1,14 +1,18 @@
 #!/bin/bash
 # scripts/launch.sh
-# Ensembleのメインtmuxセッションを起動する
-# 構成: 左=conductor、右=その他（tiled）
+# Ensembleの2セッションtmux環境を起動する
+# 構成: 2つの独立したセッション（conductor専用 + workers）
+#
+# これにより、2つのターミナルウィンドウで同時に監視できる
 #
 # 注意: ペインIDを使用することで、ユーザーのtmux設定（pane-base-index等）に
 #       依存せずに動作する
 
 set -euo pipefail
 
-SESSION="ensemble"
+SESSION_BASE="${SESSION_BASE:-ensemble}"
+SESSION_CONDUCTOR="${SESSION_BASE}-conductor"
+SESSION_WORKERS="${SESSION_BASE}-workers"
 PROJECT_DIR="${PROJECT_DIR:-$(pwd)}"
 LOG_DIR="$PROJECT_DIR/logs"
 QUEUE_DIR="$PROJECT_DIR/queue"
@@ -19,12 +23,16 @@ echo "Launching Ensemble..."
 mkdir -p "$LOG_DIR"
 
 # キューディレクトリ作成
-mkdir -p "$QUEUE_DIR/tasks" "$QUEUE_DIR/processing" "$QUEUE_DIR/reports" "$QUEUE_DIR/ack"
+mkdir -p "$QUEUE_DIR/tasks" "$QUEUE_DIR/processing" "$QUEUE_DIR/reports" "$QUEUE_DIR/ack" "$QUEUE_DIR/conductor"
 
 # 既存セッションがあれば削除
-if tmux has-session -t "$SESSION" 2>/dev/null; then
-    echo "Killing existing session..."
-    tmux kill-session -t "$SESSION"
+if tmux has-session -t "$SESSION_CONDUCTOR" 2>/dev/null; then
+    echo "Killing existing conductor session..."
+    tmux kill-session -t "$SESSION_CONDUCTOR"
+fi
+if tmux has-session -t "$SESSION_WORKERS" 2>/dev/null; then
+    echo "Killing existing workers session..."
+    tmux kill-session -t "$SESSION_WORKERS"
 fi
 
 # キューのクリーンアップ（新しいセッションはクリーンスタート）
@@ -38,43 +46,29 @@ rm -f "$QUEUE_DIR/ack/"*.ack 2>/dev/null || true
 echo "$(date -Iseconds) Session started, queue cleaned" >> "$LOG_DIR/ensemble-$(date +%Y%m%d).log"
 
 # === レイアウト ===
-# +------------------+----------+
-# |    conductor     |          |
-# |                  | dashboard|
-# +------------------+          |
-# |    dispatch      |          |
-# +------------------+----------+
-# ワーカー追加時はdashboard列に縦に追加される
-
-# 1. セッション作成（全体）
-echo "Creating session..."
-tmux new-session -d -s "$SESSION" -n "main" -c "$PROJECT_DIR"
-
-# 最初のペインのIDを取得（これがconductorになる）
-CONDUCTOR_PANE=$(tmux list-panes -t "$SESSION:main" -F '#{pane_id}')
-echo "  Conductor pane: $CONDUCTOR_PANE"
-
-# 2. 左右に分割（左65% : 右35%）
-tmux split-window -h -t "$CONDUCTOR_PANE" -c "$PROJECT_DIR" -l 35%
-
-# 新しく作成されたペインのIDを取得（これがdashboardになる）
-DASHBOARD_PANE=$(tmux list-panes -t "$SESSION:main" -F '#{pane_id}' | grep -v "$CONDUCTOR_PANE")
-echo "  Dashboard pane: $DASHBOARD_PANE"
+# セッション1: conductor
+# +------------------+------------------+
+# |   Conductor      |   dashboard      |
+# +------------------+------------------+
+#
+# セッション2: workers
+# +------------------+------------------+
+# |   dispatch       |   worker-area    |
+# +------------------+------------------+
 
-# 3. 左ペイン（conductor）を上下に分割（conductor / dispatch）
-tmux split-window -v -t "$CONDUCTOR_PANE" -c "$PROJECT_DIR" -l 50%
+# === セッション1: Conductor ===
+echo "Creating conductor session..."
+tmux new-session -d -s "$SESSION_CONDUCTOR" -n "main" -c "$PROJECT_DIR"
 
-# 新しく作成されたペインのIDを取得（これがdispatchになる）
-# conductorとdashboard以外のペインがdispatch
-DISPATCH_PANE=$(tmux list-panes -t "$SESSION:main" -F '#{pane_id}' | grep -v "$CONDUCTOR_PANE" | grep -v "$DASHBOARD_PANE")
-echo "  Dispatch pane: $DISPATCH_PANE"
+# conductorペインのIDを取得
+CONDUCTOR_PANE=$(tmux list-panes -t "$SESSION_CONDUCTOR:main" -F '#{pane_id}')
+echo "  Conductor pane: $CONDUCTOR_PANE"
 
-# 現在の状態:
-# CONDUCTOR_PANE: conductor (左上)
-# DISPATCH_PANE: dispatch (左下)
-# DASHBOARD_PANE: dashboard (右、フル高さ)
+# 左右に分割（左60% : 右40%）- 右側はdashboard
+# split-windowは新しいペインIDを返すので、それを直接キャプチャする
+DASHBOARD_PANE=$(tmux split-window -h -t "$CONDUCTOR_PANE" -c "$PROJECT_DIR" -l 40% -P -F '#{pane_id}')
+echo "  Dashboard pane: $DASHBOARD_PANE"
 
-# 4. 各ペインでコマンド起動（2回分割方式）
 # conductor (--agent でエージェント定義をロード)
 echo "Starting Conductor (Opus, no thinking)..."
 tmux send-keys -t "$CONDUCTOR_PANE" \
@@ -82,9 +76,36 @@ tmux send-keys -t "$CONDUCTOR_PANE" \
 sleep 1
 tmux send-keys -t "$CONDUCTOR_PANE" Enter
 
+# dashboard
+echo "Starting Dashboard monitor (in conductor session)..."
+tmux send-keys -t "$DASHBOARD_PANE" \
+    "watch -n 5 cat status/dashboard.md"
+sleep 1
+tmux send-keys -t "$DASHBOARD_PANE" Enter
+
+# conductorペインを選択
+tmux select-pane -t "$CONDUCTOR_PANE"
+
 # フレンドリーファイア防止
 sleep 3
 
+# === セッション2: Workers ===
+echo "Creating workers session..."
+tmux new-session -d -s "$SESSION_WORKERS" -n "main" -c "$PROJECT_DIR"
+
+# 最初のペインのIDを取得（これがdispatchになる）
+DISPATCH_PANE=$(tmux list-panes -t "$SESSION_WORKERS:main" -F '#{pane_id}')
+echo "  Dispatch pane: $DISPATCH_PANE"
+
+# 左右に分割（左60% : 右40%）- 右側はワーカー用
+# split-windowは新しいペインIDを返すので、それを直接キャプチャする
+WORKER_AREA_PANE=$(tmux split-window -h -t "$DISPATCH_PANE" -c "$PROJECT_DIR" -l 40% -P -F '#{pane_id}')
+echo "  Worker area pane: $WORKER_AREA_PANE"
+
+# 現在の状態:
+# DISPATCH_PANE: dispatch (左、フルハイト)
+# WORKER_AREA_PANE: ワーカー用プレースホルダー (右、フルハイト)
+
 # dispatch (--agent でエージェント定義をロード)
 echo "Starting Dispatch (Sonnet)..."
 tmux send-keys -t "$DISPATCH_PANE" \
@@ -95,23 +116,33 @@ tmux send-keys -t "$DISPATCH_PANE" Enter
 # フレンドリーファイア防止
 sleep 3
 
-# dashboard
-echo "Starting Dashboard monitor..."
-tmux send-keys -t "$DASHBOARD_PANE" \
-    "watch -n 5 cat status/dashboard.md"
+# 右側のプレースホルダーにメッセージ表示
+tmux send-keys -t "$WORKER_AREA_PANE" \
+    "echo '=== Worker Area ===' && echo 'Run: ./scripts/pane-setup.sh [count]' && echo 'to add workers here.'"
 sleep 1
-tmux send-keys -t "$DASHBOARD_PANE" Enter
+tmux send-keys -t "$WORKER_AREA_PANE" Enter
 
-# 5. conductorペインにフォーカス
-tmux select-pane -t "$CONDUCTOR_PANE"
+# dispatchペインを選択
+tmux select-pane -t "$DISPATCH_PANE"
 
 # ペインIDをファイルに保存（他のスクリプトから参照可能に）
 mkdir -p "$PROJECT_DIR/.ensemble"
 cat > "$PROJECT_DIR/.ensemble/panes.env" << EOF
 # Ensemble pane IDs (auto-generated)
+# Session names
+CONDUCTOR_SESSION=$SESSION_CONDUCTOR
+WORKERS_SESSION=$SESSION_WORKERS
+
+# Pane IDs (use these with tmux send-keys -t)
 CONDUCTOR_PANE=$CONDUCTOR_PANE
 DISPATCH_PANE=$DISPATCH_PANE
 DASHBOARD_PANE=$DASHBOARD_PANE
+WORKER_AREA_PANE=$WORKER_AREA_PANE
+
+# Usage examples:
+# source .ensemble/panes.env
+# tmux send-keys -t "\$CONDUCTOR_PANE" 'message' Enter
+# tmux send-keys -t "\$DISPATCH_PANE" 'message' Enter
 EOF
 
 echo ""
@@ -119,19 +150,27 @@ echo "=========================================="
 echo "  Ensemble launched successfully!"
 echo "=========================================="
 echo ""
-echo "Layout:"
-echo "  +------------------+----------+"
-echo "  |    conductor     |          |"
-echo "  |                  | dashboard|"
-echo "  +------------------+          |"
-echo "  |    dispatch      |          |"
-echo "  +------------------+----------+"
+echo "Two separate tmux sessions created!"
+echo ""
+echo "Session 1: $SESSION_CONDUCTOR"
+echo "  +------------------+------------------+"
+echo "  |   Conductor      |   dashboard      |"
+echo "  +------------------+------------------+"
+echo ""
+echo "Session 2: $SESSION_WORKERS"
+echo "  +------------------+------------------+"
+echo "  |   dispatch       |   worker-area    |"
+echo "  +------------------+------------------+"
 echo ""
 echo "Panes:"
-echo "  - $CONDUCTOR_PANE (left-top)   : Conductor (Opus, no thinking)"
-echo "  - $DISPATCH_PANE (left-bottom): Dispatch (Sonnet)"
-echo "  - $DASHBOARD_PANE (right)      : Dashboard monitor"
+echo "  - $CONDUCTOR_PANE : Conductor (Opus, no thinking)"
+echo "  - $DASHBOARD_PANE : Dashboard monitor"
+echo "  - $DISPATCH_PANE  : Dispatch (Sonnet)"
+echo "  - $WORKER_AREA_PANE : Worker area (placeholder)"
+echo ""
+echo "To view both simultaneously, open two terminal windows:"
+echo "  Terminal 1: tmux attach -t $SESSION_CONDUCTOR"
+echo "  Terminal 2: tmux attach -t $SESSION_WORKERS"
 echo ""
 echo "Add workers: ./scripts/pane-setup.sh [count]"
-echo "To attach:   tmux attach-session -t $SESSION"
 echo ""

ensemble/templates/scripts/pane-setup.sh

@@ -1,31 +1,44 @@
 #!/bin/bash
 # scripts/pane-setup.sh
-# ワーカーペインを既存のmainウィンドウに追加する（右側縦並び）
+# ワーカーペインをensemble-workers:mainウィンドウの右側に追加する
 # フレンドリーファイア防止のため3秒間隔で起動
 #
 # 注意: ペインIDを使用することで、ユーザーのtmux設定（pane-base-index等）に
 #       依存せずに動作する
 #
-# 初期レイアウト:
+# 初期レイアウト (launch.sh後):
+# Session: ensemble-workers, Window: main
+# +------------------+------------------+
+# |   dispatch       |   worker-area    |
+# +------------------+------------------+
+#
+# Worker 1追加後:
+# +------------------+------------------+
+# |   dispatch       |   worker-1       |
+# +------------------+------------------+
+#
+# Worker 2追加後:
 # +------------------+----------+
-# |    conductor     |          |
-# |                  | dashboard|
-# +------------------+          |
-# |    dispatch      |          |
+# |                  | worker-1 |
+# |   dispatch       +----------+
+# |                  | worker-2 |
 # +------------------+----------+
 #
-# ワーカー追加後:
+# Worker 4追加後:
 # +------------------+----------+
-# |    conductor     | worker-1 |
+# |                  | worker-1 |
+# |                  +----------+
+# |   dispatch       | worker-2 |
+# |                  +----------+
+# |                  | worker-3 |
 # |                  +----------+
-# +------------------+ worker-2 |
-# |    dispatch      +----------+
-# |                  | dashboard|
+# |                  | worker-4 |
 # +------------------+----------+
 
 set -euo pipefail
 
-SESSION="${SESSION:-ensemble}"
+CONDUCTOR_SESSION="${CONDUCTOR_SESSION:-ensemble-conductor}"
+WORKERS_SESSION="${WORKERS_SESSION:-ensemble-workers}"
 PROJECT_DIR="${PROJECT_DIR:-$(pwd)}"
 WORKER_COUNT="${1:-2}"  # デフォルト2ワーカー
 PANES_FILE="$PROJECT_DIR/.ensemble/panes.env"
@@ -44,35 +57,52 @@ else
     exit 1
 fi
 
-echo "Adding $WORKER_COUNT worker panes..."
-echo "  Using dashboard pane: $DASHBOARD_PANE"
+echo "Adding $WORKER_COUNT worker panes to ensemble-workers:main window..."
 
-# mainウィンドウを選択
-tmux select-window -t "$SESSION:main"
+# ensemble-workersセッションのmainウィンドウを選択
+tmux select-window -t "$WORKERS_SESSION:main"
 
 # ワーカーペインIDを格納する配列
 declare -a WORKER_PANES=()
 
 # 現在のペインID一覧を取得（後で新しいペインを特定するため）
 get_all_pane_ids() {
-    tmux list-panes -t "$SESSION:main" -F '#{pane_id}'
+    tmux list-panes -t "$WORKERS_SESSION:main" -F '#{pane_id}'
 }
 
+# 最初のワーカーはWORKER_AREA_PANEを使用（プレースホルダーを置き換え）
+if [ -n "${WORKER_AREA_PANE:-}" ]; then
+    FIRST_WORKER_PANE="$WORKER_AREA_PANE"
+else
+    # WORKER_AREA_PANEがない場合は、右側のペインを探す（dispatchでないペイン）
+    FIRST_WORKER_PANE=$(tmux list-panes -t "$WORKERS_SESSION:main" -F '#{pane_id}' | \
+        grep -v "$DISPATCH_PANE" | head -1)
+fi
+
+echo "  First worker will use pane: $FIRST_WORKER_PANE"
+
 for i in $(seq 1 "$WORKER_COUNT"); do
     echo "Starting worker-$i..."
 
-    # 分割前のペインID一覧
-    BEFORE_PANES=$(get_all_pane_ids)
+    if [ "$i" -eq 1 ]; then
+        # 最初のワーカーはプレースホルダーペインを使用
+        NEW_PANE="$FIRST_WORKER_PANE"
+    else
+        # 2番目以降は右側のペインを分割
+        # 分割前のペインID一覧
+        BEFORE_PANES=$(get_all_pane_ids)
 
-    # dashboardペインを上に分割してワーカーを追加
-    tmux split-window -v -t "$DASHBOARD_PANE" -c "$PROJECT_DIR" -b
+        # 前のワーカーペインを下に分割
+        PREV_PANE="${WORKER_PANES[$((i - 2))]}"
+        tmux split-window -v -t "$PREV_PANE" -c "$PROJECT_DIR"
 
-    # フレンドリーファイア防止
-    sleep 2
+        # フレンドリーファイア防止
+        sleep 2
 
-    # 分割後のペインID一覧から新しいペインを特定
-    AFTER_PANES=$(get_all_pane_ids)
-    NEW_PANE=$(comm -13 <(echo "$BEFORE_PANES" | sort) <(echo "$AFTER_PANES" | sort))
+        # 分割後のペインID一覧から新しいペインを特定
+        AFTER_PANES=$(get_all_pane_ids)
+        NEW_PANE=$(comm -13 <(echo "$BEFORE_PANES" | sort) <(echo "$AFTER_PANES" | sort))
+    fi
 
     echo "  Worker-$i pane: $NEW_PANE"
     WORKER_PANES+=("$NEW_PANE")
@@ -83,21 +113,32 @@ for i in $(seq 1 "$WORKER_COUNT"); do
         "export WORKER_ID=$i && claude --agent worker --dangerously-skip-permissions"
     sleep 1
     tmux send-keys -t "$NEW_PANE" Enter
+
+    # フレンドリーファイア防止（最初以外）
+    if [ "$i" -lt "$WORKER_COUNT" ]; then
+        sleep 3
+    fi
 done
 
 # 全ワーカーのClaude起動完了を待つ（各ワーカー約10秒）
 echo "Waiting for all workers to initialize..."
 sleep $((WORKER_COUNT * 10))
 
-# Conductorペインにフォーカスを戻す
+# Conductorセッションのmainウィンドウに戻り、フォーカス
+tmux select-window -t "$CONDUCTOR_SESSION:main"
 tmux select-pane -t "$CONDUCTOR_PANE"
 
 # panes.env を更新（ワーカーペインIDを追加）
 {
     echo "# Ensemble pane IDs (auto-generated)"
+    echo "# Session names"
+    echo "CONDUCTOR_SESSION=$CONDUCTOR_SESSION"
+    echo "WORKERS_SESSION=$WORKERS_SESSION"
+    echo ""
+    echo "# Pane IDs"
     echo "CONDUCTOR_PANE=$CONDUCTOR_PANE"
     echo "DISPATCH_PANE=$DISPATCH_PANE"
-    echo "DASHBOARD_PANE=$DASHBOARD_PANE"
+    echo "WORKER_AREA_PANE=${WORKER_AREA_PANE:-}"
     for idx in "${!WORKER_PANES[@]}"; do
         echo "WORKER_$((idx + 1))_PANE=${WORKER_PANES[$idx]}"
     done
@@ -107,5 +148,37 @@ tmux select-pane -t "$CONDUCTOR_PANE"
 echo ""
 echo "Worker panes added: $WORKER_COUNT workers (ready for tasks)"
 echo ""
-echo "Current panes:"
-tmux list-panes -t "$SESSION:main" -F "  #{pane_id}: #{pane_width}x#{pane_height}"
+echo "Layout (ensemble-workers:main window):"
+if [ "$WORKER_COUNT" -eq 1 ]; then
+    echo "  +------------------+------------------+"
+    echo "  |   dispatch       |   worker-1       |"
+    echo "  +------------------+------------------+"
+elif [ "$WORKER_COUNT" -eq 2 ]; then
+    echo "  +------------------+----------+"
+    echo "  |                  | worker-1 |"
+    echo "  |   dispatch       +----------+"
+    echo "  |                  | worker-2 |"
+    echo "  +------------------+----------+"
+else
+    echo "  +------------------+----------+"
+    echo "  |                  | worker-1 |"
+    echo "  |                  +----------+"
+    echo "  |   dispatch       | worker-2 |"
+    echo "  |                  +----------+"
+    if [ "$WORKER_COUNT" -ge 3 ]; then
+        echo "  |                  | worker-3 |"
+        echo "  |                  +----------+"
+    fi
+    if [ "$WORKER_COUNT" -ge 4 ]; then
+        echo "  |                  | worker-4 |"
+        echo "  +------------------+----------+"
+    else
+        echo "  +------------------+----------+"
+    fi
+fi
+echo ""
+echo "Current panes in ensemble-workers:main window:"
+tmux list-panes -t "$WORKERS_SESSION:main" -F "  #{pane_id}: #{pane_width}x#{pane_height}"
+echo ""
+echo "Switch to workers window: tmux attach -t $WORKERS_SESSION"
+echo ""

{ensemble_claude-0.3.1.dist-info → ensemble_claude-0.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ensemble-claude
-Version: 0.3.1
+Version: 0.4.1
 Summary: AI Orchestration Tool for Claude Code - Multi-agent orchestration for complex development tasks
 Project-URL: Homepage, https://github.com/ChikaKakazu/ensemble
 Project-URL: Documentation, https://github.com/ChikaKakazu/ensemble#readme
@@ -87,10 +87,13 @@ pip install -e .
 # 1. Initialize Ensemble in your project
 ensemble init
 
-# 2. Launch the tmux session with Conductor + Dispatch
+# 2. Launch the tmux sessions (2 separate sessions)
 ensemble launch
 
-# 3. Run a task (in the Conductor pane)
+# 3. Open another terminal to view workers session
+tmux attach -t ensemble-workers
+
+# 4. Run a task in the Conductor session
 /go implement user authentication
 
 # Light workflow (minimal cost)
@@ -103,8 +106,8 @@ ensemble launch
 |---------|-------------|
 | `ensemble init` | Initialize Ensemble in current project |
 | `ensemble init --full` | Also copy agent/command definitions locally |
-| `ensemble launch` | Start tmux session with Conductor + Dispatch |
-| `ensemble launch --no-attach` | Start session without attaching |
+| `ensemble launch` | Start 2 tmux sessions (conductor + workers) |
+| `ensemble launch --no-attach` | Start sessions without attaching |
 | `ensemble --version` | Show version |
 
 ## Requirements