org-attach

name	org-attach
description	組織の生きているペイン（secretary / dispatcher / worker）へ tmux で**直接入る** ための **コマンドを出力するだけ** の read-only スキル。`mcp__org-broker__list_panes`（論理ペイン） と `/usr/bin/tmux -L claude-org-broker list-panes -a`（pane_id ↔ session マッピング）を pane_id（%N）で突き合わせ、各ペインに role + name(task_id) ラベル付きの attach コマンドを 生成する（読取専用 `-r` / 書込は `-r` 無し / デタッチは `Ctrl-b d`）。 「ワーカーのペインを見たい」「ワーカーのペインに入りたい」「dispatcher の様子を直接見たい」 「ペインに入りたい」「あのペインを直接覗きたい」「attach コマンド教えて」 「tmux でつなぎたい」「worker の画面に入る」等で発動。 自分で attach はせず・ペインも一切変更しない（コマンド文字列とペイン一覧表を表示するのみ）。 作業委譲（org-delegate）・ダッシュボードで状況一覧（org-dashboard）・watcher 停止（org-attention-stop） には発動しない。
effort	low
allowed-tools	["Read","Bash(printenv ORG_TRANSPORT)","Bash(/usr/bin/tmux -L claude-org-broker list-panes*)","Bash(/usr/bin/tmux -L claude-org-broker list-sessions*)","mcp__org-broker__list_panes","mcp__org-broker__list_peers"]

org-attach: 組織ペインへの tmux attach コマンドを生成（read-only）

組織の生きているペイン（secretary / dispatcher / worker）へ人間が自分のターミナルから tmux で直接 attach するための attach コマンド文字列を生成して表示する スキル。 このスキルは 何も attach しない・どのペインも変更しない。論理ペイン一覧（broker）と tmux 側の pane_id↔session マッピングを pane_id（%N）で join し、各ペインへの attach コマンドを role + name(task_id) ラベル付きで印字するだけ。コピーした人間がコマンドを自分の端末に貼って入る。

輸送層 両系（frame C / 二フレーム） — このスキルは broker(tmux) フレーム専用: このスキルは tmux backend（socket claude-org-broker）上の detached tmux session への attach を 前提とする。broker フレーム: 各 broker ペインは claude-org-broker-{pid}-{seq} という独立した detached tmux session（1 ペイン = 1 session）として存在し、tmux attach -t <session> で入れる ― 本スキルの attach モデルが意味を持つ主フレームはこちら。renga フレーム（opt-in, ORG_TRANSPORT=renga）は概念が異なる: renga は単一画面のタイリングモデルで、ペインは 1 つの 生きたウィンドウ内のタイルであって、独立した detached session ではない。「detached session へ attach し直す」概念がそのまま写像せず、ペイン単位の tmux attach -t <session> は存在しない。 よって renga 下では本スキルの attach 形は適用外で、画面そのものを直接見ればよい（attach 不要）。 本スキルは renga フレームでは「broker(tmux) 専用ツールです」と明示して停止する（下記 Step 0）。

（既定の二フレーム注記（Refs #604）: org-attach は本質的に broker/tmux ツールなので header を broker 主軸で書く。輸送層全体の既定は二つのフレームで指す対象が異なる ― 運用既定は renga （broker 実走 dogfood が Epic #6 Issue G まで未活性）だが、コード既定は tools/transport.py: DEFAULT_TRANSPORT が runtime 0.1.28 (Epic #586) で renga→broker にフリップ済み。broker tool を 使う手保守スキルのうち .claude/skills/org-attention-stop/SKILL.md は header を 「既定 broker / opt-in renga」のコード既定フレームで書く ― 本スキルはこの broker 主軸の先例に倣う。 （.claude/skills/org-attention-start/SKILL.md は逆に「既定 renga」 の運用既定フレームで書かれており、両者は指す対象が異なるだけで矛盾しない。）総説は root CLAUDE.md「輸送層（transport）両系」節、契約面は docs/contracts/backend-interface-contract.md Surface 8。）

権限フレーム: list_panes は broker の ops-tier ツール（secretary / dispatcher のみ付与、 worker には付与されない）。したがって org-attach は 窓口（Secretary）/ ディスパッチャー面のスキルで、 人間は窓口セッションから実行する。

なぜ /usr/bin/tmux 絶対パス必須か（最重要）

zsh では tmux は oh-my-zsh の tmux プラグインで alias 化けする（tmux is an alias for _zsh_tmux_plugin_run）。素の tmux ... を出力すると、人間の zsh に貼った瞬間に alias 経由で 別物（プラグインのラッパ）が走り、-L claude-org-broker の socket 指定や attach -r -t <session> が 意図通り効かない。生成する全コマンドで実体パス /usr/bin/tmux を使い、出力にもその理由を 1 行添える。

Step 0: 輸送フレームを確認する（renga なら停止）

まず ORG_TRANSPORT を read-only で読む（この 1 コマンドだけが Step 0 の許可対象）:

printenv ORG_TRANSPORT

renga フレームならこのスキルは適用外なので attach コマンドを生成せず停止する。

• ORG_TRANSPORT=renga（明示）の場合 → 次の旨を伝えて停止する（attach コマンドは生成しない）: 「現在は renga（単一画面タイリング）で稼働しています。renga ではペインは 1 つのライブウィンドウ内の タイルで、detached tmux session への attach という概念がそのまま適用されません。ペイン状況の一覧は /org-dashboard を使ってください。」
• それ以外（無設定 / broker） → broker(tmux) フレームとして Step 1 へ進む。

Step 1: 論理ペイン一覧を取得（broker）

mcp__org-broker__list_panes

戻り値は 1 論理ペイン = 1 レコードで、主に次のフィールドを持つ:

• id: tmux backend では これが tmux の pane_id（%N 文字列）そのもの。 （runtime broker_queue_event.schema.json: "Backend-native pane id: int on WezTerm, string (e.g. "%3") on tmux" / dispatcher/runner.py: "broker/tmux backend emits tmux pane_id strings of the form %N"。WezTerm backend では int になるが、本スキルが対象とする tmux socket claude-org-broker では %N 文字列で来る。）
• name: ペイン名（worker-{task_id} / dispatcher / secretary 等）
• role: secretary / dispatcher / curator / worker
• focused, geometry（x / y / width / height）, cwd

重要 — attach 可能なのは broker が spawn した子ペイン（dispatcher / worker）だけ: 窓口（root secretary）は broker 起動時に logical pane（bookkeeping entry、register_logical_pane） として登録されるだけで、adapter 実ペインを持たず id / pane_id が null（%N 無し）。よって broker socket の detached session には出現せず attach 対象外である（窓口は org を起動した人間の 手元 terminal でそのまま動くので、そもそも attach 不要）。id が %N のレコードだけが attach 可能。 一次参照: docs/operations/broker-dogfood-runbook.md §8（attach 導線の正準ガイド・「対象範囲（重要）」節）。

list_panes が空 / 取得不可なら「組織ペインが見つかりません。/org-start 済みか確認してください」と 報告して停止する。list_panes が [tool_not_authorized] を返したら ops-tier 権限が無い （worker セッションから呼んでいる等）ので、窓口 / ディスパッチャー面で実行するよう案内する。

補足が要れば mcp__org-broker__list_peers（read-only）で peer 名と cwd を突き合わせてもよい （join には必須ではない）。

Step 2: tmux 側の pane_id ↔ session マッピングを取得

/usr/bin/tmux -L claude-org-broker list-panes -a -F '#{pane_id} #{session_name}'

• -L claude-org-broker: runtime の BROKER_SOCKET。組織の tmux はこの socket 上にある
• -a: 全 session の全ペインを列挙
• -F '#{pane_id} #{session_name}': 各行を %N <session> の固定 2 列に整形して頑健にパースする （tmux のデフォルト行は session:window.pane: [geometry] [history] %N (active) 形で、ここからも session 名と %N を取れるが、明示 -F の方が確実）

出力例（1 行 = 1 ペイン、各 broker ペインは独立 session claude-org-broker-{pid}-{seq}）:

%0 claude-org-broker-1912-1
%5 claude-org-broker-1912-14
%6 claude-org-broker-1912-17

socket 接続自体が落ちている場合は error connecting to ... claude-org-broker が返る。その時は 「tmux socket claude-org-broker に繋がりません（組織が起動していない可能性）。/org-start 済みか 確認してください」と報告して停止する。

Step 3: pane_id（%N）で join

list_panes の id（%N）を key に、Step 2 の %N → <session> マッピングと突き合わせる:

list_panes.id (%N)  ⨝  tmux pane_id (%N)  →  各論理ペインの session 名

join 前に、まず id が null（%N 無し）の logical pane を除外する。これらは attach 対象外で、 join に回さず別枠で報告する（下記）。id が %N のレコードだけを tmux マッピングと突き合わせる。

両側でマッチしないエントリは失敗にせず一覧で報告する（実運用で起こる）:

• id が null の logical pane（通常は窓口 = secretary）: これは drift ではなく正常。 adapter 実ペインを持たないので attach できない。「(logical pane / attach 対象外。窓口は人間の手元 terminal)」と注記して別枠表示する（attach コマンドは出さない）。
• list_panes に %N があるが tmux に同 %N が無い: backend 再起動 / pane が死んだ直後の drift。 「session 解決不可」として attach コマンドは出さず、行だけ「(tmux 側に %N 無し)」と注記して出す。
• tmux にあるが list_panes に無い: 組織外の手動 session / 孤児 session。「(broker 未登録 session)」 として、role/name は不明のまま attach コマンドだけ参考表示する（人間判断に委ねる）。

Step 4: attach コマンドを生成して出力

join できた各ペインについて、role + name(task_id) ラベル付きで次を出力する:

• 読取専用 attach（既定・安全）: /usr/bin/tmux -L claude-org-broker attach -r -t <session>
  • -r = read-only attach。覗くだけで誤入力でペインを壊さない。まずこちらを案内する
• 読取書込 attach（自分で打ちたい時のみ）: 同じコマンドから -r を外す → /usr/bin/tmux -L claude-org-broker attach -t <session>
• デタッチ: attach 中に Ctrl-b d を押すと、ペインを動かしたまま自分だけ抜ける （ペインは生き続ける ― close ではない）

出力末尾に「tmux は zsh で alias 化けするため、必ず実体パス /usr/bin/tmux を使うこと」を 1 行添える。

出力フォーマット（worked example）

Step 1 / Step 2 が次を返したとする:

list_panes（論理ペイン。窓口 = secretary は id が null の logical pane）:

id	role	name
null	secretary	secretary
%5	dispatcher	dispatcher
%6	worker	worker-feat-org-attach-skill

/usr/bin/tmux -L claude-org-broker list-panes -a -F '#{pane_id} #{session_name}' （secretary は logical pane なので broker socket に出ない点に注意）:

%5 claude-org-broker-1912-14
%6 claude-org-broker-1912-17

logical pane 除外 → %N を持つ dispatcher / worker のみ join → 生成する出力:

組織ペインへの attach コマンド（broker/tmux フレーム・read-only スキル：表示のみ、自動 attach はしません）
※ これらを自分のターミナルに貼って入る

■ dispatcher (dispatcher)          session=claude-org-broker-1912-14
  読取専用 : /usr/bin/tmux -L claude-org-broker attach -r -t claude-org-broker-1912-14
  読取書込 : /usr/bin/tmux -L claude-org-broker attach    -t claude-org-broker-1912-14

■ worker (worker-feat-org-attach-skill)   session=claude-org-broker-1912-17
  読取専用 : /usr/bin/tmux -L claude-org-broker attach -r -t claude-org-broker-1912-17
  読取書込 : /usr/bin/tmux -L claude-org-broker attach    -t claude-org-broker-1912-17

(logical pane / attach 対象外)
- secretary (secretary): 窓口は logical pane（pane_id 無し・broker socket 非出現）。
  org を起動した人間の手元 terminal でそのまま見えるので attach 不要。

- まず読取専用（-r）で入るのを推奨。自分で打ちたい時だけ -r を外す。
- 抜けるとき: Ctrl-b d（デタッチ。ペインは動いたまま自分だけ抜ける）。
- 別セッションへ切替: Ctrl-b s（attach 中にセッション一覧から選ぶ。現状は per-session attach）。
- tmux は zsh で alias 化けするため、必ず実体パス /usr/bin/tmux を使うこと。

unmatched があった場合の追記例:

(参考) join できなかったエントリ:
- broker %3 (worker / worker-foo) : tmux 側に %3 無し（pane drift の可能性、attach 不可）
- tmux session claude-org-broker-1912-9 (%9)  : broker 未登録 session（組織外/孤児の可能性）
    /usr/bin/tmux -L claude-org-broker attach -r -t claude-org-broker-1912-9

やらないこと（read-only 不変条件）

• 自分で attach しない（コマンド文字列を出すだけ）
• ペインを spawn / close / rename / send_keys / send_message しない
• .state/ / registry / tmux のいずれも変更しない
• 書込み・spawn・送信系の broker / tmux ツールは allowed-tools に含めない （許可は list_panes / list_peers と read-only な tmux list-panes / list-sessions のみ）
• 状況の一覧だけが目的なら /org-dashboard、作業委譲は /org-delegate を使う（本スキルは attach 用コマンド出力専用）