## 経緯
お姉様指示「tmuxと生成AIのベストプラクティスを実装」→ why-first GO → task-router(GROK分析+CODEX補助) → grok盲点出し → 実装 → 検証 → 全ホスト展開。続けてお姉様提案でログインセッションセレクター追加(#66)。
## 成果物
- `~/.claude/tmux/ai-agent.conf` — claude-base管理スニペット。各ホストの `~/.tmux.conf` から if-shell ガード付き source（未展開ホストでもエラーにならない）
- `~/.claude/scripts/ai-tmux.sh` (`~/.local/bin/ai-tmux`) — start/ls/peek/attach/select/log/clean/kill
- `~/.claude/rules/tmux-ai-workflow.md` — 使い分け・Gotcha・禁止事項
- `~/.bashrc` (shadow/cure/arcana) — SSHログイン時 `ai-tmux select` 自動起動
## 設定の根拠（grok盲点出し反映）
| 設定 | 値 | 根拠 |
|------|-----|------|
| history-limit | 50000 | 既定2000ではエージェント推論ログが流れる。メモリ膨張対策に `ai-tmux clean` |
| escape-time | 10ms | **0msはSSHでマルチバイトシーケンス分断リスク**。10msが安全圏 |
| default-terminal+Tc | tmux-256color+RGB | Claude Code等TUIの色崩れ防止 |
| extended-keys | on (csi-u) | Claude CodeのShift+Enter/Ctrl+Enterを素通し |
| monitor-activity | on / visual off | ポップアップはトークン単位出力でスパム化するためウィンドウリスト色のみ |
| detach-on-destroy | off | 誤killでclientごと落ちる事故防止 |
## ログインセッションセレクター (#66)
SSHログイン時に「既存セッションattach / 新規 / 素のシェル」を選択。**旧 ssh-agent-launcher.sh (2026-06-07廃止) の廃止理由4点を全て潰した設計**:
- exec乗っ取り → サブプロセス表示のみ
- 選択強制ブロック → **タイムアウト10秒で素のシェル**(Enter/sでも即抜け)
- 全画面クリア → クリアしない
- エージェント終了後ループ → ループしない
- 無効化 `AI_TMUX_SELECT=0` / 非対話・TTYなし・tmux内では発動しない（Claude Code Bash/scpを邪魔しない）
## 設計判断（重要）
- **send-keysによるプロンプト注入はai-tmuxに意図的に非実装**。対話CLIのプログラム操作で claude -p 課金(2026/6/15分離)を回避する潜脱は規約違反として却下済みのため。プログラム呼び出しは9router fail-closedルートを使う
- agenthub(pipe-pane+GARBAGE_RE方式・vvv#497)とは共存。ls/peek/selectの観測対象だがstart/killはagent-hub-server側
- ANSIゴミ: peekは制御文字除去済み。生ログ(log on)は `strings
## 発見バグ → instinct化
tmuxのペイン系操作(select-pane/capture-pane/pipe-pane/clear-history)はセッション名のみの `=name` 指定だと `can't find pane` エラー。**`=name:`（コロン付き）でセッションのカレントウィンドウに解決される**。has-session/kill-session/attachは `=name` でOK。
## テスト時の注意
tmux attach のテストは TERM=dumb だと `open terminal failed: terminal does not support clear` で失敗する。`TERM=xterm-256color script -qec ...` でPTY+TERMを与えて検証する。
## 展開状況
shadow=適用検証済 / cure・arcana=スクリプト+bashrc+symlink適用済(tmux3.4) / mac=同期済・tmux未導入 / win=同期済(対象外)
## 検証記録
- #65: tmux source-file構文OK・8設定値全反映・agenthub3セッション無傷・ai-tmux 8項目スモークテスト合格
- #66: ガード3種(TTYなし/無効化/tmux内)・タイムアウト・s選択・番号選択→attach→detach復帰 全合格