🤖 AI運用ルール

セッション引き継ぎ体制

最終更新 2026年07月15日 ／ 22_AI運用ルール/セッション引き継ぎ体制.md

セッション引き継ぎ体制（2ルート）

壊れたセッション・別セッションの続きを、正確に・スムーズに引き継ぐための恒久体制。2026-07-14 に大串と作り込んで確立。

30秒サマリ — 作業内容で2ルートを使い分ける

作業内容 引き継ぎ方 中核
サイト/システム（git管理） 「◯◯の続きやって」「GitHubの履歴見て続きやって」 git log（真実の現在地）
相談・思考・文面（非git） 「引き継ぎたい」or /recover 会話ログ(.jsonl)

判断基準: git に乗る作業（コード・サイト）は git が真実 → リポ指定。git に乗らない作業（アイデア・文面・設計相談）は会話ログ → /recover。

ルートA：git管理システム（/recover不要・最速）

大串が「<サイト/リンク/システム名>の続きやって」と言うだけ。Claude の動き:

  1. 現在地を1コマンドで一発把握（リポ特定+pull+log+status+スタートカードが約2秒で出る・複数ステップの往復をなくして速い）:
    bash bash "$(dirname "$(readlink ~/.claude/commands/recover.md)")/site_snapshot.sh" <キーワード> # 例: mikke / crm.terasu / scale-base / scale-lead。特定できなければ ~/dev/リポ一覧が出る
    マッピング（配置マップ準拠）: mikke/lab.terasu→lab-terasu ／ crm.terasu→terasu-mgmt ／ terasu.scale→terasu-hp ／ scale-base ／ scale-lead
  2. 報告の冒頭で「📇 スタートカード（CLAUDE.md）参照済み」と必ず明示（読んだことが大串に見えるように・2026-07-15 大串FB）→ 現在地を報告して停止・着手は指示待ち
  3. 現在地を大串に報告して停止（「◯◯まで完了・△△未コミット・次の候補はXX」）。「これやって」の指示を待つ。勝手にコードを触る・参考サイトを開く・古いverに戻す等はしない。

「読み込んで」「履歴見て」「確認して」は"読むだけ"（2026-07-14 大串FB）。現在地の把握と報告で止める。着手は大串の明示的な指示を待つ（提案・相談はOK、勝手な着手はNG）。

→ 会話ログの精読も /recover も不要。git が真実の現在地（別PC/別セッションで進んだ分も乗る）。

ルートB：/recover（相談・非git作業）

新セッションで /recover と打つ（or「引き継ぎたい」「さっきの続き」等の自然文でも自動発火）。

/recover
  ↓ ① 候補一覧が出る（0.2秒・時刻/テーマ/最後の発言つき番号一覧）
番号を選ぶ（例: 10）
  ↓ ② session_picker.py --handoff がスクリプトで引き継ぎ書を機械生成
引き継ぎ書が出て、そこで停止
  ↓ ③「続きやって」で続行

なぜ固まらないか（設計の肝）

  • 候補一覧→番号選択: 大串は壊れたセッションに戻らない・何も貼らない
  • --handoff がスクリプトで機械生成: モデルは巨大jsonl(1.9MB級)を読まない → 精読ハングしない
  • 引き継ぎ書に「作業Dir・発言の流れ・編集ファイル・Git履歴・実行コマンド・中断点」を機械抽出
  • 引き継ぎ書を出したら停止: 勝手にデプロイ/サーバー起動/死んだlocalhost案内をしない

実装ファイル

ファイル 役割
22_AI運用ルール/コマンド集/recover/session_picker.py 中核。候補一覧 / --handoff <id> 引き継ぎ書生成 / git履歴埋め込み
22_AI運用ルール/コマンド集/recover/recover.md /recover コマンド本体
22_AI運用ルール/コマンド集/check_command_distribution.sh コマンド配布チェック（メンバー全員が使えるか6点機械判定）
90_Meta/CLAUDE_global.md「セッション引き継ぎの自然文トリガー」 恒久ルール（2ルート・発火・停止）

実行パス: python3 "$(dirname "$(readlink ~/.claude/commands/recover.md)")/session_picker.py" — recover.md 起点で辿るのでリンク切れ・clone先非依存（メンバーPCでも動く）。

メンバー導入: 各PCで cd <scale-brainのclone先> && git pull && bash 22_AI運用ルール/コマンド集/install.sh recover

落とし穴（実際に踏んだ・再発防止）

症状 真因 対策
ツール実行時に8分〜17分ハング（数十トークンで停止） reasoning effort「高」（＋高速モード）でツール実行が絡むと固まる（スクリプトは0.1秒でシロ・大串がeffort「低」に変えて解決） effort を「低」に切替（システム作業は低推奨）/ /fastオフ / 固まったら新セッション
番号選択後に15分ハング モデルが1.9MB級jsonlを Read/--file で精読 --handoff で機械生成（jsonl全読み禁止）
引き継ぎ書後に勝手に暴走（死んだlocalhost案内・英語混入） 停止せず勝手に続行作業 引き継ぎ書を出したら停止・「続きやって」を待つ
メンバーPCで動かない 実行パスが大串PC固有・依存スクリプトのpush漏れ recover.md起点パス + 配布チェック6点を毎回実行

関連