secretary-resume

name	secretary-resume
description	/secretary-handover で書き出した handover ファイルを読み込み、 窓口を新しいセッションで復帰させる。/clear 直後の最初のターンで使う。 「窓口を復帰」「resume」「引き継ぎから再開」と言われたときに使う。 /org-start ではない（ディスパッチャー・キュレーターは既に生きている前提）。
effort	low
allowed-tools	["Read","Bash(py -3 tools/journal_append.py:*)","mcp__org-broker__set_summary","mcp__org-broker__list_panes","mcp__org-broker__set_pane_identity","mcp__org-broker__list_peers","mcp__org-broker__check_messages"]

secretary-resume: 窓口の復帰

/secretary-handover で書き出した .state/secretary-handover.md を読み込み、 窓口として最低限の自覚（組織員としての立ち位置・直近の人間とのやり取り・進行中ワーク） を復元する。

前提:

• ディスパッチャー / ワーカーのペインは前セッションから生きたまま 残っている。新たに spawn しない（/org-start ではない）。
• キュレーターは常駐しない（オンデマンド化）。curator_pane_id / curator_peer_id が null であること・ペインリストに curator が見えないことは正常系。
• state DB (.state/state.db) はそのまま使う。ペイン identity の再記録も不要。
• handover ファイルが存在しないか古すぎる場合は、/org-start もしくは /org-resume の使用を案内する。

輸送層（transport）両系 — 既定 broker / opt-in renga: 本ファイル（および各スキル）の mcp__org-broker__* 呼び出しは 既定 broker（ORG_TRANSPORT 無設定）で書いてあり、そのまま従えばよい（既定挙動）。ORG_TRANSPORT=renga（opt-in・切戻し可）では MCP サーバー名が renga-peers になり、ツールの 完全修飾名が mcp__org-broker__* → mcp__renga-peers__* に機械置換される（引数形・セマンティクスは同一なので手順の論理は変わらない）。輸送依存で手順が変わる点だけ renga 併記する:

• 受信モデル: 既定 broker は push 一次（各ペイン同居の channel sidecar server:org-broker-channel が broker キューを ~1 秒間隔で claim→notifications/claude/channel で idle セッションへ本文注入。pull = ナッジ + check_messages は sidecar 不在 / unhealthy / channel 非対応ペイン（codex pull-peer）/ claude.ai login 不在時のフォールバック層）。ORG_TRANSPORT=renga 時は dispatcher / worker メッセージが <channel source="renga-peers" …> として in-band で push される。
• spawn 儀式: 既定 broker は --mcp-config <broker> 注入による Claude Code folder-trust プロンプトの send_keys(enter=true) 機械承認に加え、push 一次のため channel sidecar を --dangerously-load-development-channels server:org-broker-channel で load し dev-channel 承認プロンプトを send_keys(enter=true) で機械承認する（2 段承認）。ORG_TRANSPORT=renga 時は --dangerously-load-development-channels server:renga-peers の「Load development channel?」を Enter 承認する 1 段。
• エラー分岐: 既定 broker は shared codes（pane_not_found / last_pane / invalid-params）に加え broker 固有 [token_invalid] / [session_invalid] / [tool_not_authorized] / [no_backend]（= adapter_unavailable）/ [nudge_failed] / [peer_not_found] / [name_taken] を返しうる（未知コードは default-branch で escalate）。ORG_TRANSPORT=renga 時は broker 固有コードは発生しない。

new_tab / focus_pane は broker surface に無い（意図的除外）。契約面の正本は docs/contracts/backend-interface-contract.md Surface 8 + push-primary amendment（broker push 一次が 既定の契約、pull は fallback として retain）。opt-in renga は削除せず常時有効な切戻しの安全装置として維持する。broker 実走（dogfood）は Epic #6 Issue G スコープで本ファイルの既定運用経路ではない（二フレーム注記（Refs #604）: ここの「既定 broker」はコード既定（tools/transport.py: DEFAULT_TRANSPORT、生成面はこれで render）。運用既定は broker dogfood が Epic #6 Issue G まで未活性のため renga で、両者は指す対象が異なり矛盾しない。総説は root CLAUDE.md。）

Step 0: 自分の identity を確認する

1. mcp__org-broker__set_summary で「Secretary: 窓口（resumed）」をセット
2. mcp__org-broker__list_panes でフォーカスペインの name/role を確認:
   • 期待値: name == "secretary" かつ role == "secretary"
   • 不一致なら mcp__org-broker__set_pane_identity(target="focused", name="secretary", role="secretary") で修復

Step 1: handover ファイルを読み込む

1. .state/secretary-handover.md が存在するか確認:

   ls -la .state/secretary-handover.md 2>&1
   

   • 存在しない → ユーザーに案内して停止: 「handover ファイルがありません。/org-start で組織を起動するか、 /org-resume で suspend 状態から再開してください。」
2. フロントマター created_at を見て鮮度を判定:
   • 24 時間以内 → そのまま採用
   • 24 時間超〜7 日以内 → ユーザーに警告（「handover が古いです、続行しますか？」）
   • 7 日超 → 採用せず、/org-start への切り替えを推奨する
3. ファイル本文を Read で取り込む。書かれている内容は次セッションの自分にとっての 「事実」として扱う（後の Step 3 で state.db と照合する）。

Step 2: state.db で現状を再取得する

python -c "
from tools.state_db import connect
from tools.state_db.queries import get_org_state_summary
import json
conn = connect('.state/state.db')
print(json.dumps(get_org_state_summary(conn), ensure_ascii=False, indent=2, default=str))
"

確認項目:

• session.status が handover フロントマターと一致するか
• dispatcher_pane_id が handover に書いた値と一致するか
• curator_pane_id / curator_peer_id が null であるか（null が正常。値が残っている 場合は旧仕様からの stale 値の可能性があるので人間に報告する）
• active_runs[] が handover の「進行中のワーク」セクションと整合するか

Step 3: ペイン生存確認

mcp__org-broker__list_peers

• ディスパッチャーの name が見えること
• curator は通常見えないのが正常（オンデマンド化）。見えている場合は オンデマンド curate 実行中なので、そのまま放置してよい（dispatcher が閉じる）
• handover に記載のワーカーが現存するか（消えていれば後述）

差分があれば人間に報告する（例:「handover ではワーカー X が進行中とありますが、 現在のペインリストには見当たりません」）。勝手に再 spawn しない。

Step 4: ブリーフィングを人間に返す

handover の情報と state.db の現状を統合した上で、以下の構造で簡潔に報告:

窓口を復帰しました。

【セッション】
- 目的: <session.objective>
- 状態: <session.status>

【ペイン構成】
- dispatcher (pane=N, peer=M)
- curator: 常駐なし（オンデマンド起動）
- workers: <task_id list>

【直近の合意・判断】
- ...

【Pending Decisions】
- ...（無ければ「なし」）

【次のアクション】
- ...

ご指示をお願いします。

Step 5: handover ファイルを保持する

• 削除しない（次回トラブル時の参照用に残す）
• .state/secretary-handover.prev.md は前回のもの。読み込み済みであっても消さない

イベント記録

py -3 tools/journal_append.py secretary_resumed \
    --json '{"handover_age_hours": <数値>}' 2>/dev/null \
    || echo "(journal_append unavailable; skipping)"

やってはいけないこと

• 新規にディスパッチャー / キュレーターを spawn する（既に生きている）
• ワーカーに勝手に SUSPEND / SHUTDOWN を送る
• handover の内容と state.db の現状が食い違うときに、勝手にどちらかへ寄せる （必ず人間に報告して判断を仰ぐ）