feat: prefix S のセッションの一覧とメニューをコマンド tmux-menu からも開けるようにする

[takemi-ohama]

何をしたいか

prefix S（Ctrl-b S）で開くセッションの一覧と操作のメニューを、コマンド tmux-menu からも開けるようにしたい。

#234（PR #264）で入れた prefix S は、tmux のキー割り当てでしか呼べない。キーを覚えていない人や、tmux の外にいるときは使えない。#234 の設計でも「tmux の外からは呼べない」を弱点として挙げていた。

提案

tmux-go / tmux-peek / tmux-kill と同じ形で、tmux-session を指す symlink tmux-menu を足す。実行する中身は prefix S の割り当てと同じ choose-tree である。

どこで呼ぶか	動き
tmux の中	今の pane にセッションの一覧を出す。選んで Enter を押すと、移る（a）・中身を見る（p）・落とす（k）のメニューが出る
tmux の外	直近のセッションへ attach し、そのまま一覧を出す（tmux attach \; choose-tree …）

中身のスケッチ（未実行）:

set -- choose-tree -Zs -O name \
  "run-shell -t \"%%%\" \"tmux-session menu -c #{q:client_name} #{q:session_id}\""
if [ -n "${TMUX:-}" ]; then
  tmux "$@"
else
  tmux attach \; "$@"
fi

tmux の外からも呼べるので、#234 の「tmux の外からは呼べない」という弱点が消える。

確かめること

• シェルから開いた choose-tree で、template の #{q:client_name} が Enter を押した端末の名前へ展開されるか。キー割り当てから開いた場合と同じに振る舞う見込みだが、実際の端末で操作しないと確かめられない
• tmux の外で、サーバもセッションも無いときの扱い。例: 知らせを出して終了コード 1 で終える
• tmux の外で、どのセッションへ attach するか。既定の attach は直近のセッションを選ぶ。名前を引数で取るかどうか
• prefix S の割り当て（containers/base/tmux.conf）と tmux-menu の中身を 1 か所へまとめるか。例: 割り当てのほうを run-shell 'tmux-menu' 相当にして、同じ行を 2 か所に持たないようにする

決めること

• サブコマンドの名前（tmux-session menu を引数なしで呼ぶ形にするか、tmux-session ui のような新しいサブコマンドにするか）。今の menu は -c 端末 <セッション> が必須の内部用なので、意味を分けるなら別名がよい
• 利用者向けの文書（docs/user/）と確定仕様（docs/specifications/tmux-named-session.md）への追記

修正レイヤー

• containers/base/tmux-session（サブコマンドの追加）
• containers/base/Dockerfile（symlink tmux-menu の追加）
• 場合により containers/base/tmux.conf

由来

#234 のリリース後に、利用者から「Ctrl-b S をコマンドにできないか」「tmux-menu というコマンドにする」と要望があった（2026-09-24）。

進行

モード: standard / 作業ツリー: /Users/takemi_ohama/devbase/.worktrees/feature/plan71-tmux-menu / 計画: /Users/takemi_ohama/devbase/.worktrees/feature/plan71-tmux-menu/issues/PLAN71_tmux-menu-design.md

• 要求と受け入れ条件 — 2026-09-24 20:11
• 作業場所の用意 — 2026-09-24 20:12
• 設計 — 2026-09-24 20:12
• 素材の収集と出典の確定
• ドキュメント再構成 — 2026-09-24 20:15
• ドキュメントレビュー — 2026-09-24 20:16
• 計画 — 2026-09-26 00:43
• 実装 — 2026-09-26 00:43
• 構造改善 — 2026-09-26 00:58
• 実装レビュー — 2026-09-26 00:58
• 完了判定 — 2026-09-26 01:19
• Pull Request — 2026-09-26 01:25
• 確定仕様化 — 2026-09-26 01:26
• 後片付け — 2026-09-26 01:50
• 配布 — 2026-09-26 01:51
• 体裁レビュー
• リリース後テスト — 2026-09-26 01:52
• 振り返り — 2026-09-26 01:57

振り返り: #270 (comment)

[takemi-ohama]

範囲外と判断し、devbasex/ai-plugins#980 として残した（中継の下の ndf-next の告知が手操作を促す件）。

[takemi-ohama]

リリース後テスト: 人手の確認の手順（条件 2〜5 の見た目）

main 5edc75f で、条件 1〜5 は擬似端末に attach したクライアントにキーを打って確かめ、合格した（記録: PR #274 のコメント）。機械で見られないのは実際の端末エミュレータでの描画だけである。メニューとポップアップ、確認の問いが正しく描かれ、読めることを確かめる。次の手順で見る。

1. イメージを建て直す

利用者が本番で行う手順（latest を更新する）:

devbase build base --no-cache   # 派生イメージを使っていれば、それも建て直す
devbase down && devbase up      # コンテナを作り直す

latest を触らずに見るなら、確認用に残した devbase-base:plan71-verify（main 5edc75f から建てた）で使い捨てのコンテナを開く:

docker run --rm -it --user ubuntu --entrypoint bash -e TERM="$TERM" devbase-base:plan71-verify
tmux new -d -s alpha; tmux new -d -s beta; tmux new -d -s gamma

2. tmux の中から（条件 2・3）

打つもの	期待する表示
tmux new -s home で入り、tmux-menu ⏎	今の pane が全面の一覧になり、セッションが名前順（alpha, beta, gamma, home）に 1 行ずつ並ぶ。カーソルは今のセッション home にある
↑ で alpha を選んで ⏎	画面の中央付近に、表題 alpha のメニューが出る。項目は「移る（他の端末を外す） a」「中身を見る p」「落とす k」
p	画面の 9 割の大きさのポップアップに session alpha ($N)・clients・panes・screen が出て、最後に [Enter で閉じる]。⏎ で閉じる
もう一度 tmux-menu ⏎ → beta を選び ⏎ → k	状態行に beta を落としますか? (y/n) が出る。y で beta が一覧から消える（tmux ls で確かめる）
別の端末で tmux attach -t alpha しておき、tmux-menu ⏎ → alpha → ⏎ → a	打った端末が alpha に切り替わる。別の端末は [detached (from session alpha)] を出して外れる
Ctrl-b S → ⏎	tmux-menu と同じ一覧とメニューが出る。Esc で閉じる

3. tmux の外から（条件 4・5）

打つもの	期待する表示
tmux の外のシェルで（Ctrl-b d で出てから）tmux-menu ⏎	端末の繋がっていないセッションへ attach し、すぐ一覧が出る
セッションを選んで ⏎ → p / a / k	2 と同じメニュー・ポップアップ・問いが出て、選んだセッションに効く
tmux kill-server の後に tmux-menu ⏎	tmux-menu: tmux サーバが起動していません を出して終わり（echo $? が 1）、tmux ls でもサーバは無い

描画が崩れる（メニューが切れる・文字化けする・ポップアップが出ない）ときは、端末エミュレータの名前と echo $TERM を添えて知らせる。

[takemi-ohama]

振り返り（2026-09-26）

対象: issue #270 / PR #271（設計） / PR #274（実装）

prefix S のセッションの一覧とメニューを、コマンド tmux-menu（tmux-session menu の短縮名）からも開けるようにした。tmux の中では今の pane に一覧を出し、外では attach してから出す。prefix S の割り当ては run-shell で tmux-menu を呼ぶ形にし、一覧の template を tmux-session の 1 か所にまとめた。モードは standard。main へのマージ（5edc75f）が配布である。

何が起きたか

観点	事実
手戻り（設計）	設計の cross-review が 8 ラウンドかかった（修正のコミット 7 件）。指摘 16 件のうち 12 件は設計書の「テスト設計」の表に向いていた。ラウンド 2 以降の 11 件はすべてこの表で、内容はフィクスチャ・端末への打ち方・sh -c の展開・attach 先の前提といった、走らせれば分かる細部だった。設計そのもの（決定 1〜4・契約）への指摘はラウンド 1 で出尽くした
手戻り（実装）	実装の cross-review は 3 ラウンドで収束した（minor 3 件。確定仕様が古い定義のまま・TMUX_PANE が空の経路のテストが無い・回帰テストの節）。テストを先に足した時点では 22 件が落ちた
駆動の誤り	スイープ後の再開で駆動が state を作り直した。そのため直したスレッドへの返信と resolve が抜け、fix のサマリがすべて 0 件になった（ai-plugins#1132）。反証で支持された指摘が not_run だけで insufficient_evidence になり、round 1 で収束と判定された（ai-plugins#1133）。どちらも手で戻して回した
工程を飛ばした判断	構造改善は、assess が拡張子の無い tmux-session（#!/bin/sh、差分 40 行）を本番コードに数えなかった。「本番コードの差分 0」（終了コード 3）と判定され、起動しなかった（ai-plugins#1134）。差分が小さく結果に差は無かったが、判定の根拠は誤っていた
環境	macOS の bash 3.2 で launch-cli.sh の空配列展開が落ち、codex と kiro が NO_RESULT になった。キャッシュを patch して回避した（既存の ai-plugins#476 へ由来を追記）
確定仕様化	spec-finalize に --design を複数渡すと、最後の 1 つしか削除されないまま ok で終わった。残った 2 件を手で消した（ai-plugins#1136）
通過工程の点検	取り込みの stage-check.sh report 270 は「ドキュメントレビュー」までの 5 件だけを「記録あり」とし、「記録の無い必須の工程はありません」を返した。調べると、控えを積むのは development-workflow の Skill 単位の hook だけだった。3 層で通した後半（計画〜配布）は、本文と盤面には載っても控えに積まれていなかった。控えの判定の先端が最後に積まれた工程で止まるため、合格の文で終わる。既存の ai-plugins#961 の別の現れ方としてコメントした
見落とし（リリース後テスト）	受け入れ条件 2〜5 は「人が実際の端末で見る」と書かれ、マージの後に回った。リリース後テストで、使い捨てのコンテナの中の script(1) の擬似端末に本物のクライアントを attach した。その端末へキーを打って 18 項目を確かめ、すべて合格した。マージ前にも同じ形で行えた。機械で見られないのは端末エミュレータでの描画だけで、これは保留にし、手順を #270 に残した
範囲	範囲は広げていない。tmux-first / tmux-clean の差分 0 行を条件にし、守った

context window の大きさ

測定: skill-stats.py --agents --session <設計までの会話> --session <実装以降の会話> --days 5。設計までの会話には、同じ日の別の作業（取り込み・仕上げ 1 組）も含まれる。

層	フェーズ	モデル	件数	固定費の中央値	実作業の中央値	実作業 < 固定費	最大充填の最大	目印
conductor	-	claude-opus-5-5	2	30916	173702	0	267476	割る候補
supervisor	設計	claude-opus-5-5	1	33545	130393	0	163938
supervisor	実装	claude-opus-5-5	1	21811	64591	0	86402
supervisor	検査	claude-opus-5-5	1	17550	111577	0	129127
supervisor	取り込み	claude-opus-5-5	2	24967	88567	0	120180
supervisor	仕上げ	claude-opus-5-5	2	25380	99118	0	147453
worker	その他	claude-opus-5-5	12	28352	43944	0	116895

層	件数	固定費の合計	実作業の合計	総消費
conductor	2	61831	347403	409234
supervisor	7	173601	681932	855533
worker	12	301104	643195	944299
合計	21	536536	1672530	2209066

フェーズ	supervisor	supervisor の実作業	worker の件数	supervisor と worker の固定費の合計	目印
設計	1	130393	6	232129	worker を使いすぎ
実装	1	64591	1	31766
検査	1	111577	2	37380
取り込み	1	87706	3	105209	worker を使いすぎ

• conductor の 割る候補（最大充填 267k）: そのままにする。設計までの会話が約 130 分続き、別の作業も同じ会話で通した結果である。区間の切れ目で再起動する既存の手順で足りる
• 設計の worker を使いすぎ（worker 6 件）: worker の数を直接減らすより、設計の cross-review のラウンド数（8）を減らす手を先に試す（下の ai-plugins#1140）。worker の用途の内訳はこの測定からは読めないため、次の測定で目印が消えるかを見る
• 取り込みの worker を使いすぎ（worker 3 件）: そのままにする。worker の実作業の中央値（約 4.4 万）は最大充填の上限から遠く、束ねても節約は固定費の 2 件分（約 6 万）にとどまる。どの取り込みの worker かはこの測定からは読めない

次に変えること

変えること	落とし先	状態
設計書のテスト設計は「どの条件を、どの振る舞いで縛るか」と「どう壊したら落ちるべきか」までにとどめる。フィクスチャや起動の形は実装で、走らせた結果として決める	design の手順	ai-plugins#1140 として起票
「人が〜で見る」という条件を、振る舞い（機械）と見た目（人）に分けて書く。人手に残す前に、擬似端末で打てないかを確かめる	requirements-design / quality-gates の手順	ai-plugins#1141 として起票
通過工程の控えを、記録のスクリプト自身が積む	development-workflow の記録の仕組み	既存の ai-plugins#961・#725。別の現れ方を #961 へ追記
駆動の再開と収束の判定を直す	cross-review の駆動	ai-plugins#1132・#1133 として起票済み
assess がシェルスクリプトを shebang で本番コードに数える	cross-refactoring の assess	ai-plugins#1134 として起票済み

途中で起票した課題

番号	何を見つけたか	見つけた場面
devbasex/ai-plugins#980	中継の下の ndf-next の告知が手操作を促す	要求定義
devbasex/ai-plugins#1132	スイープ後の再開で駆動が state を作り直し、返信・resolve をしない	実装レビュー
devbasex/ai-plugins#1133	支持された指摘が not_run だけで insufficient_evidence になり、round 1 で収束と判定される	実装レビュー
devbasex/ai-plugins#1134	assess が拡張子の無いシェルスクリプトを本番コードに数えない	構造改善
devbasex/ai-plugins#476（既存・追記）	launch-cli.sh が bash 3.2 の空配列展開で落ちる	実装レビュー
devbasex/ai-plugins#1136	spec-finalize の --design を繰り返すと最後の 1 つしか削除しない	確定仕様化
devbasex/ai-plugins#961（既存・追記）	3 層で通した工程が控えに積まれず、点検が合格の文で終わる	振り返り
devbasex/ai-plugins#1140	設計書のテスト設計の細部で設計の cross-review が長引く	振り返り
devbasex/ai-plugins#1141	「人が見る」条件が振る舞いと見た目を分けず、マージ後へ回る	振り返り