| name | local-exec-handoff |
| description | PlanGate のローカル実行（Codex CLI / Claude Code）で exec を再開・引き継ぐための短い指示パケットを作る。Use when: セッション断後に exec を再開したい時、別エージェント・別ツールに作業を引き継ぎたい時。 |
Local Exec Handoff (PlanGate / Codex 共用)
PlanGate は Claude Code / Codex CLI ともローカル実行が原則。本 skill は ローカルでの exec 再開・ツール間引き継ぎ に使う短いパケットを組み立てる（Codex Cloud 用は manual-cloud-task を参照）。
Read First
参照解決順（導入先で必ずこの順に探す）
本 skill の参照は上流リポジトリ（s977043/plangate）基準の相対パスで書かれている。
導入先ではそのままでは解決できないものがあるため、次の順で探索する:
- 導入先リポジトリの相対パス（
.claude/rules/working-context.md）
- 無ければ plugin root 配下（
<plugin_root>/rules/working-context.md）
<plugin_root> は Bash で ls "${CLAUDE_PLUGIN_ROOT}/rules/" を実行して得た絶対パス。
Read ツールは絶対パスを要求し環境変数を展開しないため、${CLAUDE_PLUGIN_ROOT}/...
という文字列をそのまま Read しても必ず失敗する- 変数が空・未設定なら glob（
~/.claude/plugins/cache/** 等）で推測せず 3 へ進む
- どちらにも無い場合は 「解決できなかった」と明示し、推測で内容を補わない
（packet に「正本
<path> を参照できなかった」旨を書く）
手順 3 に落ちても判定基準は緩めない: 正本が引けない場合でも、本 skill「Rules」節
（C-3 未承認なら exec 再開を拒否 / EH-8 Privacy 準拠 / 受け手の環境に合わせたコマンド表記）と
「Deliverable」の必須項目はすべて満たす。正本を参照できないことを理由に判定基準・
ゲートを緩めてはならない（とくに approvals/c3.json の APPROVED 確認は省略不可）。
| 参照 | install.sh --claude 経由 | plugin（Claude marketplace）経由 | Codex 経由 |
|---|
rules/*.md（下記 3） | .claude/rules/ に着地（解決可） | <plugin_root>/rules/ で解決 | 未配置（解決不可 → 手順 3 へ） |
bin/**（CLI） | コピー対象外（解決不可） | バンドル対象外（解決不可） | 未配置（解決不可） |
scripts/** | コピー対象外（解決不可） | <plugin_root>/scripts/ は存在するが install-plangate-skills.sh のみ（codex-guarded.sh 等は解決不可） | 未配置（解決不可） |
docs/working/TASK-XXXX/*（下記 4〜7）は配布物ではなく導入先で作成する作業成果物なので、
導入先リポジトリ内でそのまま解決する。
読む順序
CLAUDE.mdAGENTS.md.claude/rules/working-context.md → fallback <plugin_root>/rules/working-context.md（current-state.md / status.md 役割分担の正本）docs/working/TASK-XXXX/INDEX.mddocs/working/TASK-XXXX/current-state.mddocs/working/TASK-XXXX/status.md（最終セクション）docs/working/TASK-XXXX/approvals/c3.json（APPROVED 確認）
Rules
- C-3 未承認なら exec 再開を拒否（
approvals/c3.json が承認済みであること。legacy は c3_status: APPROVED、c3-prime（approval_kind: "c3-prime"）は decision: "AUTO_APPROVED" + Plan Package 束縛検証。判定手順の正本は ai-dev-exec skill「前提条件（exec 開始ゲート）」節）
- handoff packet は 次の担当者が 1 分で再開できる粒度
- 機密情報（events.ndjson / 個人情報 / 認証情報）を含めない（EH-8 Privacy 準拠）
- ツール依存（Claude Code 固有コマンド等）を含めず、PlanGate 共通 CLI（
plangate / ./scripts/ai-dev-workflow）に統一する。コマンド表記は packet の受け手の実行環境に合わせる（上流リポジトリの cwd なら bin/plangate、導入先で PATH を通しているなら plangate、CLI が無いなら手順を文章で書く。「CLI 呼び出し」節参照）。ai-dev-workflow は PATH に載るインストール経路が無いため、単体名で書かず必ず ./scripts/ai-dev-workflow TASK-XXXX <sub> と書く（成立するのは上流リポジトリの cwd のみ。scripts/ は配布対象外なので導入先の packet には書かない）
Deliverable
以下を含む短い再開指示（10〜30 行程度）:
- TASK ID
- 現在のフェーズ: exec / verify / handoff のどれか
- 直近の完了タスク: todo.md 該当行
- 次にやること: 1〜3 件の具体的な手順
- 触ってよいファイル範囲: plan.md「Files / Components to Touch」抜粋
- 触ってはいけないファイル: forbidden_files / Hardening Override 領域
- 再開コマンド: 「CLI 呼び出し」節の表から受け手の実行環境に合う行だけを書き写す（両方の表記を並べない）。CLI が無い環境では「
current-state.md を読んで再開」と手順を書く
CLI 呼び出し
前提（Human 決定 #1144）: plugin / install.sh --claude / Codex が導入先へ配るのは
読み物層（skills / rules / agents / commands）だけであり、CLI（PlanGate CLI 本体）も
enforcement 層（scripts/hooks/）も配布物に含まれない。したがって下表の「上流リポジトリの cwd」
列にしか成立しない手順は、導入先では 上流リポジトリ（s977043/plangate）の clone が無いかぎり
実行できない。そこへ到達したら「CLI が無いため実行できない／上流リポジトリの clone が必要」と
明示して停止するか、同表の代替手順へ置き換える。CLI が無いことを理由に手順を黙って省略し、
実施済みと読める記録を残してはならない。
呼び出し表記は実行環境で変わる。相対パス形式（bin/plangate / ./scripts/...）が成立するのは
上流リポジトリ（s977043/plangate）を clone した cwd に居るときだけで、導入先には bin/ も
scripts/（の CLI 本体）も配置されない。導入先で PATH を通した場合のコマンド名は
plangate（bin/plangate ではない）。
| 用途 | 上流リポジトリの cwd | 導入先 + PATH に plangate あり | 導入先 + PATH に無い（既定） |
|---|
| current-state 表示 | bin/plangate resume TASK-XXXX | 導入先の TASK には使えない（--dir 相当なし）→ current-state.md を直接読む | current-state.md を直接読む |
| フェーズ確認 | bin/plangate status TASK-XXXX | 同上 → status.md / INDEX.md を直接読む | status.md / INDEX.md を直接読む |
| exec 継続 | bin/plangate exec TASK-XXXX | 同上 → 手動で TDD 実行（ゲート確認は ai-dev-exec skill） | 手動で TDD 実行 |
| 検証 | bin/plangate validate TASK-XXXX | plangate validate --dir docs/working/TASK-XXXX | ai-dev-exec skill の sha256 突合フォールバック |
注意: TASK-XXXX 位置引数は cwd ではなく CLI 本体の位置を基準に解決される。
bin/plangate は自身のパスから plangate_root（= bin/ の親）を求め、
<CLI の repo root>/docs/working/TASK-XXXX を読み書きする。bin/ は導入先に配置されない
ため、PATH 上の plangate は必ず別の場所にある上流 clone の実体を指す。cwd 非依存で
パスを明示できる --dir を持つのは validate / validate-schemas だけで、
resume / status / exec に相当オプションは無い。
packet 自体は手動構築。専用 CLI は環境を問わず未提供（CLI がある環境では resume + status の出力を整形し、無い環境では current-state.md / status.md を読んで整形する）。
ツール別読み替え
- Codex CLI:
.codex/ 配下にパケットを置く必要なし。plangate resume 出力（無ければ current-state.md）と本 skill Deliverable で十分。上流リポジトリで作業する場合の exec 再開は scripts/codex-guarded.sh --task TASK-XXXX exec --full-auto を推奨（pre/post-flight で plan_hash 整合・settings タスクロック検証）。session 中の物理 hook は .codex/hooks.json で EH-1/2/3/6/9 が自動発火する (PR #347)。 ← 誤り。2026-08-13 の実測で .codex/hooks.json は parse 拒否され hook が 1 件も登録されていないことが判明した（EH-1/2/3/6/9 は未発火）。session 中の物理 block は無いものとして扱うこと。****scripts/codex-guarded.sh と .codex/hooks.json はどちらも配布対象外なので、Codex への導入経路（skills のみ配置）ではこれらは存在せず、ゲートは packet 内の手順で人手維持する。
- Claude Code:
/working-context skill と組み合わせて利用。上流リポジトリでは PreToolUse:Write/Edit hook が EH-3/EH-6/EH-9 を強制するため wrapper 不要。導入先では hook が配線されているとは限らないため、packet に「plan_hash 突合を exec 開始前に自分で実行する」旨を明記する。
