secretary-handover

name	secretary-handover
description	窓口のコンテキストを圧迫したまま session を続けるのを避けるため、 直近のやり取り・進行中ワーク・組織状態を handover ファイルに書き出し、 /clear → /secretary-resume で新しい窓口セッションを開始する準備をする。 「リフレッシュ」「窓口を引き継ぎたい」「コンテキスト整理」と言われたとき、 または窓口自身が context が長くなったと判断したときに使う。
effort	low
allowed-tools	["Read","Write","Edit","Bash(py -3 tools/journal_append.py:*)","Bash(bash tools/journal_append.sh:*)"]

secretary-handover: 窓口の引き継ぎ

窓口セッションを長期化させずに、組織員としての自覚と直近やり取りを次セッションへ 受け渡すための引き継ぎファイルを作る。書き出した後にユーザーへ /clear → /secretary-resume の流れを案内する。

重要な前提:

• ディスパッチャー / キュレーター / ワーカーのペインは生かしたまま残す。 /clear は窓口の Claude コンテキストだけをリセットするので、state.db と handover ファイルから復帰できれば組織は途切れない。
• state DB (.state/state.db) は唯一の SoT。ペイン identity やワーク状態は そちらから引ける。handover はあくまで「会話の温度感」「人間との合意」「進行中の判断」など、 構造化データに収まらない部分を残すために使う。

Step 1: handover 対象を整理する

書き出す前に、窓口（自分）の context から以下を抽出する:

1. 直近の人間との合意・判断
   • 採用した方針、却下した選択肢、保留中の検討事項
2. 進行中のワーク
   • 派遣中のワーカー、その task_id、最新の進捗ステータス
3. Pending Decisions（人間に投げて未回答）
   • .state/pending_decisions.json があれば併読し、register と context の差分を残す
4. 次のアクション（窓口視点）
   • 次に自分が何をすべきか、誰の返答を待っているか
5. 直近の重要なやり取り抜粋
   • ユーザーが言った決定的な一言、自分が提案して合意された案など、3〜6 項目程度

Step 2: state.db から構造化情報を取得する

handover に参考情報として埋め込む。書き出し先は sandbox で write 可能な $TMPDIR （未設定なら /tmp フォールバック）に置く:

python3 -c "
from tools.state_db import connect
from tools.state_db.queries import get_org_state_summary
import json, os
conn = connect('.state/state.db')
out_path = os.path.join(os.environ.get('TMPDIR', '/tmp'), 'secretary-handover-state.json')
with open(out_path, 'w') as f:
    json.dump(get_org_state_summary(conn), f, ensure_ascii=False, indent=2, default=str)
print(out_path)
"

シェルリダイレクトで > /tmp/... を使うと、sandbox 環境では /tmp が read-only で 書き込み失敗する。Python 側で TMPDIR を解決してから open(..., 'w') する形が安全。

ここから以下を取り出す:

• session.status / session.objective
• session.dispatcher_pane_id / session.dispatcher_peer_id
• session.curator_pane_id / session.curator_peer_id （null が正常系。curator はオンデマンド化済みで常駐せず、org-start が StateWriter.CLEAR で明示クリアする。null を「欠損」扱いしない）
• active_runs[]（進行中タスク）
• active_worker_dirs[]（生きているワーカーディレクトリ）
• 直近の recent_events 上位 3〜5 件

Step 3: handover ファイルを書き出す

書き出し先: .state/secretary-handover.md

既存ファイルがあれば .state/secretary-handover.prev.md にバックアップしてから上書きする:

[ -f .state/secretary-handover.md ] && cp .state/secretary-handover.md .state/secretary-handover.prev.md

フォーマット（YAML frontmatter + markdown）:

---
created_at: <UTC ISO8601>
session_status: <ACTIVE | IDLE | SUSPENDED>
session_objective: <一行サマリー or null>
dispatcher_pane: <pane_id> / peer=<peer_id>
curator_pane: null  # 常駐廃止（オンデマンド化）。null が正常
---

# Secretary Handover

## 直近の人間との合意・判断
- ...

## 進行中のワーク
- worker-<task_id> (<worker_dir>): <最新の状態 / 待ち事項>
- ...

## Pending Decisions（人間に投げて未回答）
- ...
（無ければ「なし」と明記する。空にしない）

## 次のアクション（窓口視点）
- ...

## 直近の重要なやり取り抜粋
- user: 「...」
- 窓口: 「...」
- ...

## 参考: state.db スナップショット
（Step 2 で取得した active_runs / recent_events を簡潔に転記。
 全文は `.state/state.db` に残っているので最小限でよい）

書き方の注意:

• 「過去ログ」ではなく「次の自分への申し送り」として書く。たとえば 「ユーザーは B 案で進めたい意向」「ワーカーからの retro gate ack 待ち」のような形。
• 機密情報・トークン・パスワードは絶対に書かない。
• ファイルは人間も読むことを想定する。

Step 4: イベントを記録する

py -3 tools/journal_append.py secretary_handover \
    --json '{"reason": "context_compaction", "active_workers": [...]}' 2>/dev/null \
    || echo "(journal_append unavailable; skipping)"

Step 5: ユーザーへ案内する

以下のメッセージで完了報告する:

窓口の handover を `.state/secretary-handover.md` に書き出しました。
このまま /clear で context をリセットしてください。
新しい窓口セッションが始まったら /secretary-resume を実行すると、
handover を読み込んで現状把握した状態で再開できます。

ディスパッチャー・キュレーター・ワーカーペインはそのまま稼働を続けるので、
組織は中断されません。

窓口がやってはいけないこと:

• /clear を自分で打とうとしない（Claude Code 側のコマンド、ユーザーが入力する）
• ディスパッチャーやキュレーターに SHUTDOWN を送らない（/org-suspend ではないので、 ペインは生かしたまま残す）