ai-research

# ai-research

Claude Code と Gemini が tmux でチャットするスキル。

## 前提条件（実行前に確認）

- **tmux セッション内**で実行すること（`tmux` コマンドが動作する環境）
- `gemini` CLI がインストール済み
- Gemini 認証済み（Google AI API キー設定済み）

## 役割分担（重要）

| AI | 役割 | 担当タスク |
|----|------|------------|
| **Claude Code** | 実装担当 | コード作成・編集・ファイル操作・テスト実行 |
| **Gemini** | 調査役 | Web検索・ドキュメント調査・出典付き情報収集 |
| **Codex** | 設計相談 | RESEARCH MEMO を受けて設計・レビュー（ハンドオフ先） |

**Gemini に実装を依頼しないこと。** Gemini から調査結果を受けて、Claude Code が実装する。

## セットアップ

### Gemini ペイン作成

現在のウィンドウを水平分割し、右側ペインで Gemini を起動:

```bash
# 3つの Bash コマンドを順番に実行（send-keys は && で連結しないこと）
tmux split-window -h
tmux send-keys "gemini"
tmux send-keys Enter
```

- `split-window -h`: 水平分割（左右に分かれる）
- 新しいペインがアクティブになるが、Claude Code は元のペインで継続
- **重要**: `tmux send-keys` は `&&` で連結せず、別々の Bash コマンドとして実行すること
  - `sleep && tmux capture-pane` のような組み合わせは OK

### ペイン番号の確認

```bash
tmux list-panes -F "#{pane_index}: #{pane_current_command}"
```

通常、Claude Code が pane 0 または 1、Gemini が pane 1 または 2 になる。

**重要**: 以降のコマンド例では `:.1` を使用しているが、**実際のペイン番号に置き換えること**。`list-panes` の結果で Gemini が動作しているペイン番号を確認し、`:.1` → `:.2` などに適宜変更する。

## チャット

### Gemini に質問

```bash
# 2つの Bash コマンドを順番に実行（&& で連結しないこと）
tmux send-keys -t :.1 "質問内容"
tmux send-keys -t :.1 Enter
```

- `-t :.1`: 現在のウィンドウのペイン 1 を指定
- **重要**: テキスト送信と Enter 送信は別々の Bash コマンドとして実行
- `&&` で連結すると Enter が送信されないことがある

### Gemini の返信を確認（待機付き）

```bash
sleep 45 && tmux capture-pane -t :.1 -p -S -100
```

- `-S -100`: スクロールバッファから過去100行を取得
- 応答が長い場合は `sleep` の秒数を増やす（最大待機時間は下表参照）
- 「Thinking」や検索中の表示がある場合は追加で待機する

### Gemini ペイン終了

```bash
tmux kill-pane -t :.1
```

## ワークフロー

1. `/ai-research` でペイン作成・Gemini 起動
2. Gemini に**調査・質問**を送信
3. 返信を確認（sleep で待機）
4. Gemini の調査結果を **RESEARCH MEMO** としてまとめる
5. 必要に応じて `codex-collab` にハンドオフ
6. ペイン終了

## 使用例

### 調査 → RESEARCH MEMO 作成

```
User: "React Server Components について調査して"

Claude:
1. Gemini ペイン作成（3つの Bash コマンドを順番に実行）
   Bash(tmux split-window -h)
   Bash(tmux send-keys "gemini")
   Bash(tmux send-keys Enter)
   Bash(sleep 5