ensemble-claude 0.3.0__py3-none-any.whl

ensemble/templates/commands/status.md

@@ -0,0 +1,56 @@
+---
+description: 現在の進捗状況を表示・更新する
+---
+
+`status/dashboard.md` を読み込み、現在の進捗を報告してください。
+
+## 実行手順
+
+### 1. ダッシュボードの確認
+
+```bash
+cat status/dashboard.md
+```
+
+### 2. 状態の収集
+
+以下を確認し、ダッシュボードの内容と照合:
+
+- **queue/tasks/**: 未処理のタスクがあるか
+- **queue/reports/**: 未処理の完了報告があるか
+- **queue/ack/**: 未確認のACKがあるか
+
+### 3. 差分があれば更新
+
+ダッシュボードの内容が古い場合:
+
+1. 各ペイン/worktreeの状況を確認
+2. `status/dashboard.md` を更新
+3. 更新内容を報告
+
+### 4. サマリーの報告
+
+以下の形式で報告:
+
+```
+## 現在の状態
+
+- **アクティブタスク**: [タスク名]
+- **進捗**: [完了サブタスク数]/[全サブタスク数]
+- **実行中のエージェント**: [エージェント一覧]
+- **待機中の作業**: [あれば記載]
+
+## 最近の完了
+
+- [直近の完了タスク一覧]
+
+## 注意事項
+
+- [問題があれば記載]
+```
+
+## 注意事項
+
+- このコマンドは読み取り専用の操作が中心
+- ダッシュボード更新以外のファイル変更は行わない
+- 問題を発見した場合はConductorに報告する

ensemble/templates/scripts/dashboard-update.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+# scripts/dashboard-update.sh
+# ダッシュボードを更新する
+
+set -euo pipefail
+
+PROJECT_DIR="${PROJECT_DIR:-$(pwd)}"
+DASHBOARD="$PROJECT_DIR/status/dashboard.md"
+
+# コマンド
+CMD="${1:-}"
+shift || true
+
+case "$CMD" in
+    task)
+        # タスク名を設定: dashboard-update.sh task "タスク名"
+        TASK_NAME="${1:-なし}"
+        sed -i "s/## 現在のタスク.*/## 現在のタスク\n$TASK_NAME/" "$DASHBOARD"
+        ;;
+
+    status)
+        # エージェント状態を更新: dashboard-update.sh status "pane-0" "busy" "conductor" "計画中"
+        PANE="${1:-}"
+        STATE="${2:-idle}"
+        AGENT="${3:--}"
+        PROGRESS="${4:--}"
+
+        # 状態行を生成
+        STATUS_LINE="| $PANE | $STATE | $AGENT | $PROGRESS |"
+
+        # 既存の状態テーブルを更新（簡易版：最後の行を置換）
+        # TODO: 複数ペイン対応
+        ;;
+
+    complete)
+        # タスク完了を記録: dashboard-update.sh complete "task-001" "success"
+        TASK_ID="${1:-}"
+        RESULT="${2:-success}"
+        TIMESTAMP=$(date '+%Y-%m-%d %H:%M')
+
+        # 完了タスクに追加
+        if grep -q "## 最近の完了タスク" "$DASHBOARD"; then
+            sed -i "/## 最近の完了タスク/a - $TASK_ID: $RESULT ($TIMESTAMP)" "$DASHBOARD"
+        fi
+        ;;
+
+    log)
+        # ログを追加: dashboard-update.sh log "メッセージ"
+        MESSAGE="${1:-}"
+        TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+
+        if grep -q "## 改善ログ" "$DASHBOARD"; then
+            sed -i "/## 改善ログ/a - [$TIMESTAMP] $MESSAGE" "$DASHBOARD"
+        fi
+        ;;
+
+    timestamp)
+        # 最終更新時刻を更新
+        TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+        sed -i "s/*Last updated:.*/*Last updated: $TIMESTAMP*/" "$DASHBOARD"
+        ;;
+
+    *)
+        echo "Usage: dashboard-update.sh <command> [args]"
+        echo ""
+        echo "Commands:"
+        echo "  task <name>           - Set current task name"
+        echo "  status <pane> <state> <agent> <progress> - Update agent status"
+        echo "  complete <task_id> <result> - Record task completion"
+        echo "  log <message>         - Add log entry"
+        echo "  timestamp             - Update last modified time"
+        exit 1
+        ;;
+esac
+
+# 常に最終更新時刻を更新
+TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+sed -i "s/*Last updated:.*/*Last updated: $TIMESTAMP*/" "$DASHBOARD"

ensemble/templates/scripts/launch.sh

@@ -0,0 +1,137 @@
+#!/bin/bash
+# scripts/launch.sh
+# Ensembleのメインtmuxセッションを起動する
+# 構成: 左=conductor、右=その他（tiled）
+#
+# 注意: ペインIDを使用することで、ユーザーのtmux設定（pane-base-index等）に
+#       依存せずに動作する
+
+set -euo pipefail
+
+SESSION="ensemble"
+PROJECT_DIR="${PROJECT_DIR:-$(pwd)}"
+LOG_DIR="$PROJECT_DIR/logs"
+QUEUE_DIR="$PROJECT_DIR/queue"
+
+echo "Launching Ensemble..."
+
+# ログディレクトリ作成
+mkdir -p "$LOG_DIR"
+
+# キューディレクトリ作成
+mkdir -p "$QUEUE_DIR/tasks" "$QUEUE_DIR/processing" "$QUEUE_DIR/reports" "$QUEUE_DIR/ack"
+
+# 既存セッションがあれば削除
+if tmux has-session -t "$SESSION" 2>/dev/null; then
+    echo "Killing existing session..."
+    tmux kill-session -t "$SESSION"
+fi
+
+# キューのクリーンアップ（新しいセッションはクリーンスタート）
+echo "Cleaning up queue..."
+rm -f "$QUEUE_DIR/tasks/"*.yaml 2>/dev/null || true
+rm -f "$QUEUE_DIR/processing/"*.yaml 2>/dev/null || true
+rm -f "$QUEUE_DIR/reports/"*.yaml 2>/dev/null || true
+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"
+
+# 3. 左ペイン（conductor）を上下に分割（conductor / dispatch）
+tmux split-window -v -t "$CONDUCTOR_PANE" -c "$PROJECT_DIR" -l 50%
+
+# 新しく作成されたペインの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_PANE: conductor (左上)
+# DISPATCH_PANE: dispatch (左下)
+# DASHBOARD_PANE: dashboard (右、フル高さ)
+
+# 4. 各ペインでコマンド起動（2回分割方式）
+# conductor (--agent でエージェント定義をロード)
+echo "Starting Conductor (Opus, no thinking)..."
+tmux send-keys -t "$CONDUCTOR_PANE" \
+    "MAX_THINKING_TOKENS=0 claude --agent conductor --model opus --dangerously-skip-permissions"
+sleep 1
+tmux send-keys -t "$CONDUCTOR_PANE" Enter
+
+# フレンドリーファイア防止
+sleep 3
+
+# dispatch (--agent でエージェント定義をロード)
+echo "Starting Dispatch (Sonnet)..."
+tmux send-keys -t "$DISPATCH_PANE" \
+    "claude --agent dispatch --model sonnet --dangerously-skip-permissions"
+sleep 1
+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"
+sleep 1
+tmux send-keys -t "$DASHBOARD_PANE" Enter
+
+# 5. conductorペインにフォーカス
+tmux select-pane -t "$CONDUCTOR_PANE"
+
+# ペインIDをファイルに保存（他のスクリプトから参照可能に）
+mkdir -p "$PROJECT_DIR/.ensemble"
+cat > "$PROJECT_DIR/.ensemble/panes.env" << EOF
+# Ensemble pane IDs (auto-generated)
+CONDUCTOR_PANE=$CONDUCTOR_PANE
+DISPATCH_PANE=$DISPATCH_PANE
+DASHBOARD_PANE=$DASHBOARD_PANE
+EOF
+
+echo ""
+echo "=========================================="
+echo "  Ensemble launched successfully!"
+echo "=========================================="
+echo ""
+echo "Layout:"
+echo "  +------------------+----------+"
+echo "  |    conductor     |          |"
+echo "  |                  | dashboard|"
+echo "  +------------------+          |"
+echo "  |    dispatch      |          |"
+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 ""
+echo "Add workers: ./scripts/pane-setup.sh [count]"
+echo "To attach:   tmux attach-session -t $SESSION"
+echo ""

ensemble/templates/scripts/pane-setup.sh

@@ -0,0 +1,111 @@
+#!/bin/bash
+# scripts/pane-setup.sh
+# ワーカーペインを既存のmainウィンドウに追加する（右側縦並び）
+# フレンドリーファイア防止のため3秒間隔で起動
+#
+# 注意: ペインIDを使用することで、ユーザーのtmux設定（pane-base-index等）に
+#       依存せずに動作する
+#
+# 初期レイアウト:
+# +------------------+----------+
+# |    conductor     |          |
+# |                  | dashboard|
+# +------------------+          |
+# |    dispatch      |          |
+# +------------------+----------+
+#
+# ワーカー追加後:
+# +------------------+----------+
+# |    conductor     | worker-1 |
+# |                  +----------+
+# +------------------+ worker-2 |
+# |    dispatch      +----------+
+# |                  | dashboard|
+# +------------------+----------+
+
+set -euo pipefail
+
+SESSION="${SESSION:-ensemble}"
+PROJECT_DIR="${PROJECT_DIR:-$(pwd)}"
+WORKER_COUNT="${1:-2}"  # デフォルト2ワーカー
+PANES_FILE="$PROJECT_DIR/.ensemble/panes.env"
+
+# 最大4ワーカー（Claude Max 5並列 - Conductor用1を除く）
+if [ "$WORKER_COUNT" -gt 4 ]; then
+    echo "Warning: Max 4 workers allowed. Reducing from $WORKER_COUNT to 4."
+    WORKER_COUNT=4
+fi
+
+# panes.env から既存のペインIDを読み込む
+if [ -f "$PANES_FILE" ]; then
+    source "$PANES_FILE"
+else
+    echo "Error: $PANES_FILE not found. Run launch.sh first."
+    exit 1
+fi
+
+echo "Adding $WORKER_COUNT worker panes..."
+echo "  Using dashboard pane: $DASHBOARD_PANE"
+
+# mainウィンドウを選択
+tmux select-window -t "$SESSION:main"
+
+# ワーカーペインIDを格納する配列
+declare -a WORKER_PANES=()
+
+# 現在のペインID一覧を取得（後で新しいペインを特定するため）
+get_all_pane_ids() {
+    tmux list-panes -t "$SESSION:main" -F '#{pane_id}'
+}
+
+for i in $(seq 1 "$WORKER_COUNT"); do
+    echo "Starting worker-$i..."
+
+    # 分割前のペインID一覧
+    BEFORE_PANES=$(get_all_pane_ids)
+
+    # dashboardペインを上に分割してワーカーを追加
+    tmux split-window -v -t "$DASHBOARD_PANE" -c "$PROJECT_DIR" -b
+
+    # フレンドリーファイア防止
+    sleep 2
+
+    # 分割後のペインID一覧から新しいペインを特定
+    AFTER_PANES=$(get_all_pane_ids)
+    NEW_PANE=$(comm -13 <(echo "$BEFORE_PANES" | sort) <(echo "$AFTER_PANES" | sort))
+
+    echo "  Worker-$i pane: $NEW_PANE"
+    WORKER_PANES+=("$NEW_PANE")
+
+    # WORKER_ID環境変数を設定して、--agent workerでClaudeを起動
+    # 重要: send-keysは2回分割で送信（shogunパターン）
+    tmux send-keys -t "$NEW_PANE" \
+        "export WORKER_ID=$i && claude --agent worker --dangerously-skip-permissions"
+    sleep 1
+    tmux send-keys -t "$NEW_PANE" Enter
+done
+
+# 全ワーカーのClaude起動完了を待つ（各ワーカー約10秒）
+echo "Waiting for all workers to initialize..."
+sleep $((WORKER_COUNT * 10))
+
+# Conductorペインにフォーカスを戻す
+tmux select-pane -t "$CONDUCTOR_PANE"
+
+# panes.env を更新（ワーカーペインIDを追加）
+{
+    echo "# Ensemble pane IDs (auto-generated)"
+    echo "CONDUCTOR_PANE=$CONDUCTOR_PANE"
+    echo "DISPATCH_PANE=$DISPATCH_PANE"
+    echo "DASHBOARD_PANE=$DASHBOARD_PANE"
+    for idx in "${!WORKER_PANES[@]}"; do
+        echo "WORKER_$((idx + 1))_PANE=${WORKER_PANES[$idx]}"
+    done
+    echo "WORKER_COUNT=$WORKER_COUNT"
+} > "$PANES_FILE"
+
+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}"

ensemble/templates/scripts/setup.sh

@@ -0,0 +1,163 @@
+#!/bin/bash
+# Ensemble Setup Script
+# Creates the directory structure and initial files for Ensemble AI Orchestration
+
+set -e
+
+echo "🎵 Ensemble Setup"
+echo "=================="
+
+# Get the project root (parent of scripts/)
+PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$PROJECT_DIR"
+
+# 1. Check required commands
+echo "Checking required commands..."
+for cmd in claude tmux git; do
+    if ! command -v $cmd &> /dev/null; then
+        echo "⚠️  Warning: $cmd is not installed. Some features may not work."
+    fi
+done
+
+# 2. Create directory structure
+echo "Creating directory structure..."
+
+mkdir -p .claude/{agents,commands,skills}
+mkdir -p scripts
+mkdir -p workflows
+mkdir -p status
+mkdir -p notes
+mkdir -p queue/{tasks,reports,ack}
+
+# 3. Create CLAUDE.md (only if it doesn't exist)
+if [ ! -f CLAUDE.md ]; then
+    echo "Creating CLAUDE.md..."
+    cat > CLAUDE.md << 'CLAUDEEOF'
+# プロジェクト: Ensemble AI Orchestration
+
+## 概要
+このプロジェクトはEnsemble AIオーケストレーションシステムを使用しています。
+
+## 基本ルール
+- /go コマンドでタスクを開始する
+- /go-light で軽量ワークフロー（コスト最小）
+- 実行パターンはConductorが自動判定する
+- 自己改善フェーズを必ず実行する
+
+## ⚠️ コンパクション復帰プロトコル（全エージェント必須）
+
+コンパクション後は、作業を再開する前に**必ず**以下を実行せよ:
+
+1. **自分のペイン名を確認する**:
+   ```bash
+   tmux display-message -p '#W'
+   ```
+
+2. **対応するエージェント定義を読み直す**:
+   - conductor → `.claude/agents/conductor.md`
+   - dispatch → `.claude/agents/dispatch.md`
+   - reviewer → `.claude/agents/reviewer.md`
+   - （その他、自分の役割に対応するファイル）
+
+3. **禁止事項を確認してから作業開始**
+
+4. **現在のタスクをダッシュボードで確認**:
+   ```bash
+   cat status/dashboard.md
+   ```
+
+summaryの「次のステップ」を見てすぐ作業してはならぬ。
+**まず自分が誰かを確認せよ。**
+
+## 通信プロトコル
+- エージェント間の指示・報告はファイルベースキュー（queue/）経由
+- send-keysは「新タスクあり」の通知のみに使用
+- ACKファイルで受領確認を行う
+
+## 実行パターン
+- パターンA: 単純タスク → subagentで直接実行
+- パターンB: 中規模タスク → tmux多ペインで並列実行
+- パターンC: 大規模タスク → git worktreeで分離 + 各worktree内並列
+
+## 学習済みルール（自動追記）
+<!-- learner agentが自動追記するセクション -->
+
+CLAUDEEOF
+else
+    echo "CLAUDE.md already exists, skipping..."
+fi
+
+# 4. Create dashboard.md
+echo "Creating status/dashboard.md..."
+cat > status/dashboard.md << 'EOF'
+# 🎵 Ensemble Dashboard
+
+## 現在のタスク
+なし
+
+## 実行状態
+| ペイン/Worktree | 状態 | エージェント | 進捗 |
+|---|---|---|---|
+| - | idle | - | - |
+
+## 最近の完了タスク
+なし
+
+## Skills候補
+なし
+
+## 改善ログ
+なし
+
+---
+*Last updated: -*
+EOF
+
+# 5. Create .gitignore additions
+if [ -f .gitignore ]; then
+    if ! grep -q "queue/tasks/" .gitignore 2>/dev/null; then
+        echo "" >> .gitignore
+        echo "# Ensemble queue files (transient)" >> .gitignore
+        echo "queue/tasks/*.yaml" >> .gitignore
+        echo "queue/reports/*.yaml" >> .gitignore
+        echo "queue/ack/*.ack" >> .gitignore
+    fi
+else
+    cat > .gitignore << 'EOF'
+# Ensemble queue files (transient)
+queue/tasks/*.yaml
+queue/reports/*.yaml
+queue/ack/*.ack
+
+# Python
+__pycache__/
+*.pyc
+.pytest_cache/
+.coverage
+htmlcov/
+*.egg-info/
+dist/
+build/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+EOF
+fi
+
+echo ""
+echo "✅ セットアップ完了！"
+echo ""
+echo "使い方:"
+echo "  claude  # Claude Codeを起動"
+echo "  /go タスク内容  # Ensembleでタスクを実行"
+echo "  /go-light タスク内容  # 軽量ワークフロー"
+echo ""
+echo "次のステップ:"
+echo "  1. .claude/agents/conductor.md を確認"
+echo "  2. MAX_THINKING_TOKENS=0 claude --model opus で起動"

ensemble/templates/scripts/worktree-create.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+# scripts/worktree-create.sh
+# Ensembleの並列開発用worktreeを作成する
+
+set -euo pipefail
+
+# 色定義
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# ログ関数
+log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+
+# 使用方法
+usage() {
+    echo "Usage: $0 <branch-name> [base-branch]"
+    echo ""
+    echo "Arguments:"
+    echo "  branch-name    作成するブランチ名（ensemble/接頭辞が自動付与）"
+    echo "  base-branch    ベースとなるブランチ（デフォルト: main）"
+    echo ""
+    echo "Example:"
+    echo "  $0 feature-auth main"
+    echo "  → ../ensemble-feature-auth にworktreeが作成される"
+    echo "  → ブランチ名: ensemble/feature-auth"
+    exit 1
+}
+
+# 引数チェック
+if [ $# -lt 1 ]; then
+    usage
+fi
+
+BRANCH_NAME="$1"
+BASE_BRANCH="${2:-main}"
+
+# ensemble/ プレフィックスを付与（まだない場合）
+if [[ ! "$BRANCH_NAME" =~ ^ensemble/ ]]; then
+    FULL_BRANCH_NAME="ensemble/${BRANCH_NAME}"
+else
+    FULL_BRANCH_NAME="$BRANCH_NAME"
+    BRANCH_NAME="${BRANCH_NAME#ensemble/}"
+fi
+
+# worktreeディレクトリ名
+PROJECT_ROOT=$(git rev-parse --show-toplevel)
+PARENT_DIR=$(dirname "$PROJECT_ROOT")
+WORKTREE_DIR="${PARENT_DIR}/ensemble-${BRANCH_NAME}"
+
+log_info "Creating worktree for: ${FULL_BRANCH_NAME}"
+log_info "Base branch: ${BASE_BRANCH}"
+log_info "Worktree directory: ${WORKTREE_DIR}"
+
+# 既存チェック
+if [ -d "$WORKTREE_DIR" ]; then
+    log_error "Worktree directory already exists: ${WORKTREE_DIR}"
+    exit 1
+fi
+
+# ベースブランチが存在するか確認
+if ! git rev-parse --verify "$BASE_BRANCH" >/dev/null 2>&1; then
+    log_error "Base branch does not exist: ${BASE_BRANCH}"
+    exit 1
+fi
+
+# ブランチが既に存在するか確認
+if git rev-parse --verify "$FULL_BRANCH_NAME" >/dev/null 2>&1; then
+    log_warn "Branch already exists: ${FULL_BRANCH_NAME}"
+    log_info "Creating worktree with existing branch..."
+    git worktree add "$WORKTREE_DIR" "$FULL_BRANCH_NAME"
+else
+    log_info "Creating new branch and worktree..."
+    git worktree add -b "$FULL_BRANCH_NAME" "$WORKTREE_DIR" "$BASE_BRANCH"
+fi
+
+# 成功メッセージ
+log_info "Worktree created successfully!"
+echo ""
+echo "Next steps:"
+echo "  1. cd ${WORKTREE_DIR}"
+echo "  2. Start Claude Code in this directory"
+echo ""
+echo "To remove this worktree later:"
+echo "  git worktree remove ${WORKTREE_DIR}"
+echo "  git branch -d ${FULL_BRANCH_NAME}"