akari-video 0.1.0

package/vendor/skills/edit-plan/execution.md

@@ -0,0 +1,157 @@
+# 承認後の実行
+
+## 原則
+
+このファイルは Checkpoint 3 の明示承認後だけ読む。承認された manifest を [M1〜M4 契約](../../docs/contract-2026-07-13-m1-m4.md) の `edit.json` と authoring 規約へ忠実に変換し、表現できない計画を独自フィールドで補わない。使ってよいのは公開契約が定めたフィールドだけである（[SKILL.md](SKILL.md) のハードルール）。
+
+## 1. source 構成を確定する
+
+**複数の映像素材が最終構成に必要なら、`edit.json v1`（`sources[]` + `cuts[].src`）で書く**。これが第一選択肢であり、[マルチソース契約](../../docs/contract-2026-07-18-edit-json-v1-sources.md) が定める公開フィールドである。render-cut は v1 の複数入力書き出しに対応済みで、素材をまたぐ順序・同じ素材の再登場・並べ替えをそのまま書き出せる。
+
+素材構成は次から選び、選んだ理由を `decision-log.md` に追記する。
+
+- **v1 マルチソース（複数素材の既定）**: `sources[]` へ素材、`cuts[]` へ `src` 付きクリップ列を書き、`version` を `1` にする。素材別の keep-range 編集性を保ったまま複数素材を並べられるので、B ロールや別テイクの差し込みもここで表す。
+- **主素材 1 本の v0（単一素材で足りる場合の既定）**: 主素材 1 本だけで構成が成立するなら `version: 0` + 単一 `source` を維持する。version を上げる必要はない。
+- **単一中間マスターへ conform（代替手段）**: v1 でも表現しにくい合成 — 焼き込みエフェクト、素材そのものを作り替える加工、公開契約に無い合成 — が要るときだけ、承認済み順序と区間を ffmpeg で 1 本にし、そのファイルを source にする。複数素材を 1 本として扱える一方、元素材別の keep-range 編集性が下がる。素材・source 時刻・master 時刻の対応表は `decision-log.md` に残す。
+
+素材別に独立した `edit.json` を作る案が要件を満たす場合は併記してよい。承認を得ずに黙って concat したり、公開契約に無い `source_id` や独自 track を発明したりしない。
+
+BGM と SFX は [音声契約](../../docs/contract-2026-07-14-edit-json-v1-audio.md) の `audio`（version を問わない任意フィールド）で書き、ナレーションは [narration 契約](../../docs/contract-2026-07-20-edit-json-v1-narration.md) の `audio.narration[]` で書く。動画 B ロールは v1 の `sources[]` + `cuts[].src` で表す。いずれの契約でも表せない計画は、中間マスターへ焼き込むか、計画のみとして未実行にするかを manifest で区別する。
+
+### v1 で書くときの注意
+
+- **`cuts` が空 = 空タイムライン**。v0 の「空 = source 全体を使う」と意味が違う。v1 で素材全体を使いたいなら `{ "src": "s1", "in": 0, "out": <素材尺> }` を明示的に書く。素材尺が取得できず全体 cut を作れないときは、推測せず停止して報告する。空タイムラインは契約上は合法なので edit-lint も PASS し、書き出し段で `no output duration because cuts is empty` として初めて止まる。
+- **字幕・注釈・解析結果は (`src`, source 秒) でアンカーする**。同じ素材区間がタイムライン上に複数回現れ得るため source 秒 → timeline 秒は一対多であり、timeline 秒へ変換した結果を永続化しない。字幕（`captions.json`）と注釈（`review.json` の `annotations[]`）の各項目は `src` に `sources[].id` を書く。`src` の省略は単一ソース互換の意味になり、素材が 2 本以上ある edit では当該項目が警告付きでスキップされる。
+- **`sources[].id` は `s1`, `s2`, … の連番を推奨**。参照は path ではなく安定した id で行うので、素材の差し替えや path 変更で cut・サイドカーの参照が壊れない。id はファイル内で一意にする。
+- `source` と `sources[]` は排他である。v0 のまま `sources[]` を書いたり、`version: 1` で単一 `source` を残したりしない。
+- `overlays[].start`、`audio.bgm`、`audio.sfx[].t` は v0 / v1 を問わずアウトプットタイムライン座標であり、この source 秒アンカー規則の対象外である。
+
+## 2. edit.json を作る
+
+承認値を次の形へ入れる。例の数値を既定値として流用しない。
+
+**単一素材（v0）**
+
+```json
+{
+  "version": 0,
+  "output": { "width": 1280, "height": 720, "fps": 30 },
+  "source": {
+    "path": "source/master.mp4",
+    "proxy": "source/master-proxy.mp4"
+  },
+  "cuts": [
+    { "in": 5.0, "out": 10.0 }
+  ],
+  "overlays": [
+    {
+      "id": "chapter-setup",
+      "html": "overlays/chapter-setup.html",
+      "start": 1.0,
+      "duration": 4.0,
+      "transform": { "x": 0, "y": -80, "scale": 1, "rotate": 0 },
+      "vars": { "--color": "#ffffff" }
+    }
+  ]
+}
+```
+
+**複数素材（v1）**
+
+```json
+{
+  "version": 1,
+  "output": { "width": 1280, "height": 720, "fps": 30 },
+  "sources": [
+    { "id": "s1", "path": "source/interview.mp4", "proxy": "source/interview-proxy.mp4" },
+    { "id": "s2", "path": "source/broll-workshop.mp4", "proxy": null }
+  ],
+  "cuts": [
+    { "src": "s1", "in": 5.0, "out": 10.0 },
+    { "src": "s2", "in": 12.0, "out": 15.5 },
+    { "src": "s1", "in": 40.0, "out": 44.0 }
+  ],
+  "overlays": [
+    {
+      "id": "chapter-setup",
+      "html": "overlays/chapter-setup.html",
+      "start": 1.0,
+      "duration": 4.0,
+      "transform": { "x": 0, "y": -80, "scale": 1, "rotate": 0 },
+      "vars": { "--color": "#ffffff" }
+    }
+  ]
+}
+```
+
+- v0 の `source.path`、v1 の `sources[].path` は原本または承認済み中間マスター、`proxy` は対応する 720p preview。原本を proxy へ置き換えない。proxy が無い素材は `null` を書く。
+- path は `edit.json` からの相対または絶対。可搬性のため同一ツリーでは相対を使う。
+- v0 の `cuts` は source 秒の keep-range で昇順・非重複。空配列は source 全体を使う。
+- v1 の `cuts` は `src` で素材を指すクリップ列で、**配列順がそのままタイムライン順**になる。同じ `src` の再登場と任意の並べ替えを認め、昇順・非重複は強制しない。各要素は `0 <= in < out` を満たし、`src` は `sources[].id` を指す。空配列は空タイムラインである。
+- `overlays.start` は cut 連結後の timeline 秒。source 秒の event をそのまま入れない。
+- overlay ID は一意、HTML path は存在し、`duration > 0` とする。
+
+v0 では、source 時刻 `s` が keep-range `[in, out]` にあるとき、timeline 時刻は「それ以前の keep-range 長の合計 + `(s - in)`」で求める。v1 では `cuts` を配列順にギャップなく連結し、各 cut の長さを `out - in` として同じ式で求める（上の例なら s1 5.0–10.0 が timeline 0.0–5.0、s2 12.0–15.5 が 5.0–8.5、s1 40.0–44.0 が 8.5–12.5）。同じ `(src, source 秒)` が複数の cut に含まれるなら、対応する timeline 時刻も複数になる。境界にある overlay は実フレームを確認し、カットで消える区間へ置かない。
+
+### 切り出し・先出しクリップの発話スナップと呼吸
+
+トレーラー・オープニングフック・引用など、本編とは別に短く切り出すクリップ（以下「切り出し・先出しクリップ」）の `in` / `out` は、**クリップ内の発話を `analysis.json` の word-level 実測（`transcript[].words`）で拾い、発話へスナップして決める**。ハードルール:
+
+- **窓 = クリップ内発話の頭 − 0.25s / 末尾 + 0.25s**（前後合わせて呼吸 0.5s。オーナー指針 2026-07-24）。発話の頭・末尾ギリギリで詰めず、前後に無音の呼吸を残して急な切替感を消す。
+- coarse な segment 時刻（whisper の 2 秒量子化・句読点境界）や**見せ場スコア位置の機械窓のまま切り出さない**。機械窓は発話の外で切れていることがあり、意図した発話が窓の外へ落ちる。
+- **発話を含まない切り出し窓を作らない**。見せ場スコアが指す位置に発話が無ければ、窓ではなく発話の実測区間を正本にして取り直す。
+- **全文表示が 1.0 秒未満になる字幕を含むクリップを作らない**。収まらないなら窓を字幕が読める長さまで延ばすか、その字幕を落とす（読めない字幕を出さない）。
+- スナップに使う `words` は source 秒。窓（`cuts[].in/out`）も source 秒で書く（§1 の source 秒アンカー規則）。
+
+呼吸 0.5s（頭 0.25s / 末尾 0.25s）は、将来 `direction` のプリセット / `intensity` 写像（`join_breathing`）に載る予定である（席の予約。ここでは写像を定義せず、現時点の採用値は固定値として `decision-log.md` に記す）。
+
+## 3. オーバーレイ HTML を作る
+
+最初に [overlay-authoring](../overlay-authoring/SKILL.md) を読み、必要なリーフだけを追加で読む。利用不能なら [CLAUDE.md の authoring 規約](../../CLAUDE.md) を読み、fallback を `decision-log.md` に追記する。
+
+- 断片のルート要素は 1 個にする。
+- 調整可能な値を `--x`、`--y`、`--scale`、`--font-size`、`--color` 等の CSS 変数にする。
+- `edit.json.overlays[].start/duration` を SSOT とし、ランタイム所有の外側コンテナに反映される `data-start` / `data-duration` と一致させる。断片内に独立した時刻源を作らない。
+- アニメーションは transform / opacity 中心にし、4K 映像上の `filter: blur()` と `backdrop-filter` を使わない。
+- wall-clock に依存せず、シーク時に Web Animations API の `currentTime` で同じ絵を再現できるようにする。
+- 3D が必要なら Three.js + glTF、動画 texture は proxy を使う。
+- transcript 等の可変文字列を HTML と CSS の文脈に合わせて escape する。
+
+サムネ用の HTML 文字組を、タイミング付き動画 overlay として無条件に再利用しない。
+
+## 4. 字幕（captions.json）の表示区間を作る
+
+字幕を持つ計画では、各 caption の表示区間を**実発話区間**に一致させる。segment 境界を敷き詰めた（`end = 次の caption の start`）字幕は、ポーズ・無音・フィラー間にも字幕を残し、実発話より早く出る／長く残る。ハードルール:
+
+- **`caption.start` = 先頭語（`words[0]`）の実測 start / `caption.end` = 末尾語（`words[-1]`）の実測 end + 読み切り猶予**。読み切り猶予は既定 **0.2〜0.4 秒**（採用値は `decision-log.md` に記す）。
+- **次 caption の start まで引き伸ばさない**（敷き詰め禁止）。**無発話区間（発話 `words` が無い区間）は無字幕**とする。隙間が生まれるのが正であり、隙間を字幕で埋めない。
+- caption の start / end は source 秒アンカー（§1）。`words[]` も同じ source 秒で持つ。
+- **按分 fallback（`words` が取れず segment の start/end を文字数比で分配する推定）を使うときも、敷き詰め禁止は同じ**。按分は末尾語 end の**時刻の推定**であって**区間の拡張ではない**ので、推定した末尾 end + 読み切り猶予で閉じ、次 caption まで伸ばさない。
+- 参照挙動: 旧 Akari-OS（video-on-os）の字幕表示。字幕の付ける/付けない・スタイル等の方針レベルは [report-guide.md](report-guide.md) の素材計画 §字幕枠で決め、ここでは区間の作り方だけを定める。
+
+## 5. 検証して判断記録を閉じる
+
+- [edit-lint](../edit-lint/SKILL.md) を実行し、`edit.json` の構造、cuts 整合、参照解決、
+  overlay の timeline 時刻・ID・HTML root・data 属性が PASS になるまで findings を修正する。
+  v1 では `sources[].id` の一意性と `cuts[].src` の参照整合も検査対象になる。
+- overlay の CSS 変数と禁止 CSS は overlay-authoring 規約に照らして確認する。
+- 中間マスターを作った場合は、素材別対応表と実フレームで境界を確認する。
+- `decision-log.md` に実行結果（生成物一覧・provenance・実行日時）を追記し、Checkpoint 3
+  が実行済みであることを記録する。過去の log 行は変更しない。
+
+## よくある間違い
+
+- `version: 0` のまま `sources[]` を書く（`sources[]` を使うファイルは `version: 1`）。
+- `version: 1` で `cuts` を空のまま「素材全体を使う」つもりになる（v1 の空 `cuts` は空タイムライン）。
+- `version: 1` で `cuts[].src` を省く、または `sources[].id` に無い id を書く。
+- `source` と `sources[]` を併存させる（排他。lint エラー）。
+- 複数素材を理由に、公開契約に無い `source_id` や独自 track を追加する。
+- 素材計画にある BGM / SFX / ナレーションを、契約フィールド（`audio` / `audio.narration[]`）ではなく独自 field で書く。
+- 字幕・注釈・解析結果を timeline 秒へ変換して永続化する（正本は (`src`, source 秒)）。
+- **caption の表示区間を segment 境界で敷き詰め（`end = 次の caption の start`）、無発話区間にも字幕を残す**（実発話が終われば字幕も終わる。§4）。
+- 按分 fallback を「区間の拡張」に使い、末尾語の推定 end を越えて次 caption まで字幕を伸ばす（§4）。
+- **切り出し・先出しクリップを見せ場スコア位置の機械窓（segment 量子化時刻）のまま切り出し、意図した発話を窓の外へ落とす／全文 1.0s 未満の読めない字幕を出す**（発話へスナップし呼吸 0.5s を残す。§2）。
+- `cuts` と overlay の時刻をどちらも source 秒で書く。
+- 実行承認前に中間マスターや overlay を作る。
+- authoring skill がないことを理由に規約を省略する。
+- edit.json の sample 値を、承認されていない出力仕様として使う。

package/vendor/skills/edit-plan/expression-selection.md

@@ -0,0 +1,290 @@
+# 表現手段を文脈から選ぶ（意味 → 手段）
+
+シーンごとに「何の表現手段で見せるか」を決めるための選択規約である。[beats.md](beats.md) が
+「どこが見せ場か」を、[beat-sync.md](beat-sync.md) が「見せ場でいつ何を発火するか」を定めるのに対し、
+本リーフは**素材計画（Checkpoint 2）で「そのシーンを何で見せるか」を決める段**を担う。
+
+本リーフは**候補の決め方**であって、承認の省略ではない。ここで決めた候補は従来どおり
+[approvals-and-generation.md](approvals-and-generation.md) の Checkpoint 2（素材計画）を通す
+（§承認ゲートは不変）。
+
+## 選択原則
+
+- **意味が手段を決める。手段が先にあるのではない。** そのシーンが視聴者に何を伝える場面かを
+  先に言語化し、その意味から手段を引く。
+- **手段の目新しさ・使いたさを選択理由にしない。** 「3D を入れたい」「せっかくカタログにある」は
+  理由にならない。理由になるのは「このシーンの意味がその手段を要求している」ことだけである。
+- **1 シーン 1 主役。** 同時に主張する手段は 1 つにする。補助（字幕・控えめな装飾）は可だが、
+  主役を 2 つ置かない（3D モデルを回しながら全画面グラフを重ね、さらに語レベルの文字演出を
+  被せる、をしない）。
+
+## 意味 → 手段の既定対応表
+
+| シーンの意味 | 第一候補 | 第二候補 | 使わない |
+|---|---|---|---|
+| 製品・物体の説明 | 3D モデル（bake-3d カタログ） | 実写 B ロール | 文字だけで説明しない |
+| データ・数値・比較 | HTML グラフ/表 | 文字演出（数値の強調） | 3D の飾り |
+| 手順・操作の説明 | スクリーン録画・資料 | HTML 図解 | 無関係なストック |
+| 場所・雰囲気 | 実写 B ロール | ストック素材 | — |
+| 感情・主張の瞬間 | 文字演出（語レベル） | 人物演出（囲い・ズーム） | 情報系オーバーレイ |
+| 概念・構造の説明 | HTML 図解（図・囲い・矢印） | 3D（空間的な概念のみ） | — |
+
+- 表は**意味の側から引く**。手段の側から「この素材をどこで使えるか」と逆引きしない。
+- **「使わない」列は禁止であり、`allowed_means`（§ハードフィルタ）で許可されていても選ばない。**
+  許可は義務ではなく、禁止列を解除もしない。
+- 表に無い意味のシーンは、最も近い行を選んだうえで**どの行を借りたか**を根拠に書く
+  （§根拠の記録）。行を発明しない。
+
+## 表の手段と `allowed_means` 語彙の対応
+
+`allowed_means` の語彙は演出カード（decision-cards の `direction` カード）が持つ 7 値であり、
+対応表の呼び方とは粒度が違う。突き合わせは次で固定する。
+
+| 対応表の手段 | `allowed_means` の値 |
+|---|---|
+| 3D モデル（bake-3d カタログ） / 3D（空間的な概念のみ） / 3D の飾り | `3D` |
+| 実写 B ロール | `実写 B ロール` |
+| ストック素材 | `ストック素材` |
+| スクリーン録画・資料 | `スクリーン録画・資料` |
+| HTML グラフ/表 / HTML 図解 / 情報系オーバーレイ | `HTML 図解` |
+| 文字演出（語レベル） / 文字演出（数値の強調） | `文字演出` |
+| 人物演出（囲い・ズーム） | 囲い等の重ね物は `HTML 図解`、ズーム等の映像側の変形は**手段チェックの対象外**（素材を伴わないため） |
+
+- `AI 生成` は対応表の**行に現れない**。これは「何で見せるか」ではなく「その素材をどう調達するか」の
+  軸であり、B ロール・ストック・3D・図解のいずれとも直交する。生成で素材を用意するときに
+  **重ねて**効くチェックである（§ハードフィルタ）。
+- overlay HTML を自分で書くこと（[overlay-authoring](../overlay-authoring/SKILL.md)）は
+  `HTML 図解` / `文字演出` のチェックで扱い、`AI 生成` のチェックは画像・動画・音声の生成素材に
+  かける。
+
+## ハードフィルタ — `allowed_means`
+
+演出カードの `allowed_means`（`<レポートパス>.decisions.json` の `direction` カードの
+`answer.allowed_means`。既定は 7 値すべて許可）に**無い手段は候補から除外する**。
+
+- **第一候補が除外されたら第二候補へ**。第二候補も除外されたら、その意味の行の候補は尽きている。
+- **全滅なら「その意味のシーンは素の映像 + 字幕」**とする。除外された手段を「近いから」と
+  読み替えて別の手段へ滑らせない（3D が不許可だからストック素材の 3D 風 CG を使う、をしない）。
+- 除外・全滅も**決定である**。何を除外して何に落ちたかを §根拠の記録の形式で残す。
+- `decisions.json` が無い・破損している場合は
+  [report-guide.md](report-guide.md) の汎用カード機構の既定どおり**チャットの明示承認で代替**する
+  （既定で全許可とみなして進めない）。
+- `allowed_means` はハードフィルタであり、演出の強さ（`direction { preset, intensity }` →
+  [beat-sync.md](beat-sync.md)）とは別軸である。`intensity` を上げても不許可の手段は復活しない。
+
+### AI 生成素材の二重ゲート
+
+`AI 生成` は `allowed_means` に加えて **intake の方針（AI 生成の許可）にも従う**。両方が許可して
+初めて生成素材を候補にできる（片方でも不許可なら、その素材は生成せず「あれば提案」または
+「使わない」へ落とす）。
+
+- 実測（`packages/schemas/intake.schema.json` v0）: intake.json v0 のフィールドは
+  `version` / `tasks` / `target` / `autonomy` / `status` / `submitted_at` であり、**AI 生成の可否を
+  持つ専用フィールドは無い**。したがって intake 側の方針は `target.taste` の自由記述と
+  `decision-log.md` に残る承認記録から読む。
+- どちらからも読み取れないときは「許可されている」とみなさず、
+  [approvals-and-generation.md](approvals-and-generation.md) の生成前宣言で確認してから進む。
+
+## カタログ接続 — 手段が決まってから素材を探す
+
+**手段が決まってから素材を探す**（素材を先に見つけて手段を後付けしない）。探索は
+[report-guide.md](report-guide.md#素材計画) の全スコープ層を近い順（プロジェクト `assets/` →
+上位ディレクトリの `.akari/assets/` → `~/.akari/assets/` → 製品リポ `assets/` →
+`catalog/`）に行い、どの層のヒットかを明記する。
+
+- **検索キーは `when_to_use` と `tags`** である。`when_to_use` はシーンの意味と直接突き合わせ、
+  `tags` は絞り込みに使う。`title` / `description` の語感だけで選ばない。
+- **ライセンスは `meta.json` で確認してから採用する。** 見るのは `license.spdx` /
+  `license.scope` / `license.attribution_required` と `source.license_at_source`（再配布条件）である。
+  - `attribution_required: true` なら、採用した時点でクレジット文の義務が発生する
+    （編集レポートへ載せる。[beat-sync.md](beat-sync.md) のクレジット運用と同じ）。
+  - **素材単体の再配布を禁じている素材は、プロジェクトへ複製するのは可でも公開リポジトリへ
+    コミットしない。**
+  - `catalog/` は `remote: true` の**取得先索引であり実体を持たない**（[catalog/INDEX.md](../../catalog/INDEX.md)）。
+    未取得なら「取得が要る」ことを素材計画に明記する。
+  - 例外: `catalog/telop/` だけは本リポへベンダリングされた目次方式カタログで、`meta.json` を
+    持たない（実測: `index.jsonl` に license フィールドは無い）。ライセンス根拠は
+    [catalog/telop/INDEX.md](../../catalog/telop/INDEX.md) の来歴で確認し、実際にレンダリングへ
+    使う書体のライセンスは `catalog/font/<id>/meta.json` で別途確認する。
+- 該当ヒットが無いことを「あれば提案」と記録しない。[report-guide.md](report-guide.md#素材計画) の
+  三択（あれば提案 / なければ生成 / 使わない）へ落とし、プレビュー・検索結果を捏造しない。
+
+## 根拠の記録
+
+**全選択について**、「シーンの意味 → 表のどの行 → 選んだ素材 id」を編集判断レポートの素材計画へ
+**1 行**で記録する（[beat-sync.md](beat-sync.md) の選択根拠と同じ粒度）。記録先は
+`decision-log.md` の `material` category（[report-guide.md](report-guide.md#decision_log)）である。
+
+```text
+<scene id> @ <timeline 秒> | 意味: <シーンの意味> | 行: <対応表の行名> / <第一候補|第二候補|全滅> |
+手段: <allowed_means 語彙> | 素材: <素材 id>（<層> / <license.spdx> / クレジット<要|不要>） | 理由: <1 文>
+```
+
+- **除外・全滅・不採用も 1 行を書く**（`手段: —（全滅 → 素の映像 + 字幕）` のように書き、何が
+  除外されたかを理由に残す）。黙って落とさない。
+- 素材が生成物（overlay HTML 等）で `id` を持たない場合は、生成物のパスを素材欄に書く。
+- 候補順位を飛ばした場合（第一候補が許可されているのに第二候補を採る等）は、飛ばした理由を
+  理由欄に書く。理由なき逸脱は不可であり、既定は第一候補である。
+
+## 承認ゲートは不変
+
+本リーフは候補の決め方であり、承認の省略ではない。
+
+- 素材計画は従来どおり **Checkpoint 2（素材計画）** の人間承認を通す
+  （[approvals-and-generation.md](approvals-and-generation.md)）。
+- `allowed_means` を通過したことは「承認された」ことを意味しない。ハードフィルタは候補を
+  **減らす**だけで、残った候補を自動承認しない。
+- 有償・重い生成（AI 生成素材）は、`allowed_means` と intake の両方を通過していても
+  生成前宣言を省略しない。
+
+## worked example
+
+### 前提
+
+タスク管理アプリの紹介動画（解説トーン = 真面目）。意味の異なる 3 シーンを扱う。
+
+| scene | timeline 秒 | シーンの意味 | 内容 |
+|---|---|---|---|
+| `sc-01` | 24.0 | 製品・物体の説明 | アプリの画面を実機に映して見せる |
+| `sc-02` | 98.0 | データ・数値・比較 | 導入前後の処理時間（12 分 → 90 秒） |
+| `sc-03` | 232.0 | 感情・主張の瞬間 | 発話「正直、ここまで変わるとは思っていませんでした。」 |
+
+### ケース 1 — `allowed_means` が全許可（7 値すべて）
+
+```json
+["実写 B ロール", "スクリーン録画・資料", "ストック素材", "AI 生成", "3D", "HTML 図解", "文字演出"]
+```
+
+| scene | 表の行 | 第一候補 | フィルタ判定 | 採用手段 | 採用素材 |
+|---|---|---|---|---|---|
+| `sc-01` | 製品・物体の説明 | 3D モデル | `3D` は許可 → 通過 | 3D | `catalog/3d/modern-smartphone` |
+| `sc-02` | データ・数値・比較 | HTML グラフ/表 | `HTML 図解` は許可 → 通過 | HTML 図解 | 生成（overlay HTML）+ 書体 `catalog/font/noto-sans-jp` |
+| `sc-03` | 感情・主張の瞬間 | 文字演出（語レベル） | `文字演出` は許可 → 通過 | 文字演出 | `catalog/telop/ref3_mincho_flash` |
+
+素材の選定根拠（カタログ実測）:
+
+- `sc-01`: `catalog/3d/` の 3 件を `when_to_use` で突き合わせ、`modern-smartphone` の
+  「アプリ紹介・UI 解説・プロダクトデモで、実機に画面を映し込んだモックアップ映像を作るとき」が
+  シーンの意味と一致する（`vintage-camera` はレトロ小物、`studio-hdri` は環境光であり不一致）。
+  `license.spdx` = `CC0-1.0` / `attribution_required: false` → クレジット不要。`remote: true` の
+  ため取得が要ることを素材計画に明記する。
+- `sc-02`: `catalog/` にグラフ・表のカテゴリは存在しない（実測のディレクトリは
+  3d / audio / broll / font / luts / telop）。
+  三択の「なければ生成」として overlay HTML を自作し、書体は `catalog/font/noto-sans-jp`
+  （`OFL-1.1` / クレジット不要）を使う。**「使わない」列の 3D の飾りは、`3D` が許可されていても
+  置かない。**
+- `sc-03`: `catalog/telop/index.jsonl` を `use_when.beats ⊇ emotion` で検索するとヒットは 3 件
+  （`ref3_karaoke_flash` = エモい歌モノ / `ref3_kid_karaoke` = 子ども向け / `ref3_tl_r3s7_07` =
+  昭和ラジオ風）で、いずれも解説トーン（真面目）と不一致だった。**同じ「文字演出」の範囲内で**
+  `tone` 一致を優先し、`roles: emphasis` かつ `tone: 真面目・エモい` の `ref3_mincho_flash`
+  （極太明朝ドン）を採用する。第一候補の手段は変えていないため候補順位の逸脱ではないが、
+  `use_when.beats` が一致しない選択であるため理由を記録する。
+
+記録行（`decision-log.md` の `material`）:
+
+```text
+sc-01 @ 24.0 | 意味: 製品・物体の説明 | 行: 製品・物体の説明 / 第一候補 | 手段: 3D | 素材: modern-smartphone（catalog / CC0-1.0 / クレジット不要） | 理由: when_to_use「実機に画面を映し込んだモックアップ」がシーンの意味に一致
+sc-02 @ 98.0 | 意味: データ・数値・比較 | 行: データ・数値・比較 / 第一候補 | 手段: HTML 図解 | 素材: overlays/sc-02-chart.html（生成 / 書体 noto-sans-jp OFL-1.1 / クレジット不要） | 理由: catalog にグラフ素材のカテゴリが無く三択の「なければ生成」。3D の飾りは禁止列のため不使用
+sc-03 @ 232.0 | 意味: 感情・主張の瞬間 | 行: 感情・主張の瞬間 / 第一候補 | 手段: 文字演出 | 素材: ref3_mincho_flash（catalog/telop / 来歴 akari-telop / クレジット不要） | 理由: emotion 一致の 3 件はトーン不一致のため、同じ文字演出の中で tone 一致（真面目・エモい）の emphasis を採用
+```
+
+### ケース 2 — `3D` と `AI 生成` が不許可（5 値）
+
+```json
+["実写 B ロール", "スクリーン録画・資料", "ストック素材", "HTML 図解", "文字演出"]
+```
+
+| scene | 表の行 | 第一候補 | フィルタ判定 | 採用手段 | 採用素材 |
+|---|---|---|---|---|---|
+| `sc-01` | 製品・物体の説明 | 3D モデル | `3D` が**除外** → 第二候補へ | 実写 B ロール | `catalog/broll/laptop-typing-closeup` |
+| `sc-02` | データ・数値・比較 | HTML グラフ/表 | `HTML 図解` は許可 → 通過 | HTML 図解 | 生成（overlay HTML）+ 書体 `catalog/font/noto-sans-jp` |
+| `sc-03` | 感情・主張の瞬間 | 文字演出（語レベル） | `文字演出` は許可 → 通過 | 文字演出 | `catalog/telop/ref3_mincho_flash` |
+
+ケース 1 との差分と、`AI 生成` 不許可が効いた箇所:
+
+- `sc-01` **だけが変わる**。第一候補の `3D` が除外されたため第二候補「実写 B ロール」へ移り、
+  `catalog/broll/` の唯一のエントリ `laptop-typing-closeup` の `when_to_use`
+  「SaaS/アプリ紹介、リモートワーク解説…作業中であることを示す一般的な手元ショット」が
+  シーンの意味と一致する。`LicenseRef-Mixkit-Free-License` / `attribution_required: false` で
+  クレジットは不要だが、`source.license_at_source` が**素材そのままの再配布を禁じている**ため、
+  プロジェクトへの複製は可・**公開リポジトリへはコミットしない**。
+- `AI 生成` 不許可により、`sc-01` で「3D の代わりに AI 生成の製品カット動画を作る」案は候補に
+  ならない（`実写 B ロール` が許可でも、その素材を**生成で用意する**経路が塞がる）。同じ理由で
+  `sc-03` のテロップ背景に AI 生成画像を敷く案も落ち、語レベルの文字演出だけで構成する。
+- `sc-02` は不変である。`HTML 図解` は許可されたままであり、禁止列の「3D の飾り」は
+  ケース 1 でもケース 2 でも置かない（`allowed_means` の可否と無関係に禁止列だから）。
+- overlay HTML の自作（`sc-02` / `sc-03`）は `HTML 図解` / `文字演出` のチェックで扱うため、
+  `AI 生成` 不許可の影響を受けない（§表の手段と `allowed_means` 語彙の対応）。
+
+記録行（差分のある `sc-01` のみ。`sc-02` / `sc-03` はケース 1 と同一）:
+
+```text
+sc-01 @ 24.0 | 意味: 製品・物体の説明 | 行: 製品・物体の説明 / 第二候補 | 手段: 実写 B ロール | 素材: laptop-typing-closeup（catalog / LicenseRef-Mixkit-Free-License / クレジット不要） | 理由: 第一候補 3D が allowed_means で除外。when_to_use「SaaS/アプリ紹介…手元ショット」が一致。再配布禁止のため公開リポジトリへコミットしない
+```
+
+### 全滅の検算
+
+仮にケース 2 からさらに `実写 B ロール` と `ストック素材` も落ちた場合、`sc-01` の行の候補
+（3D → 実写 B ロール）は尽きる。このとき `sc-01` は**素の映像 + 字幕**とし、次の 1 行を残す。
+「文字だけで説明しない」（禁止列）は表現手段としての文字演出を主役に据えないという意味であり、
+全滅時のフォールバック（素の映像 + 字幕）を禁じるものではない。
+
+```text
+sc-01 @ 24.0 | 意味: 製品・物体の説明 | 行: 製品・物体の説明 / 全滅 | 手段: —（全滅 → 素の映像 + 字幕） | 素材: なし | 理由: 3D・実写 B ロール・ストック素材がいずれも allowed_means で除外
+```
+
+### 自己整合の確認
+
+- 6 件の選択（3 シーン × 2 通り）はすべて対応表の**同じ行の第一候補または第二候補**であり、
+  行をまたいだ選択・表に無い手段は 1 件も無い。
+- 「使わない」列に触れた選択は 0 件（`sc-02` の 3D の飾り、`sc-03` の情報系オーバーレイ、
+  `sc-01` の「文字だけで説明」はいずれも不採用）。
+- **1 シーン 1 主役**: 6 件とも主張する手段は 1 つで、字幕は補助に留めている。
+- 候補順位の逸脱は 0 件（`sc-01` ケース 2 の第二候補は、第一候補がフィルタで除外された結果である）。
+- 記録行は 6 件 + 全滅の検算 1 件のすべてに存在し、いずれも「意味 → 行 → 素材 id」を含む。
+
+## 検証（2026-07-23 実測）
+
+worked example が引いたカタログの実データは次で確認した（`catalog/` は読み取りのみ）。
+
+```
+$ ls catalog/3d | tr '\n' ' '
+INDEX.md modern-smartphone studio-hdri vintage-camera
+$ node -e "const m=require('./catalog/3d/modern-smartphone/meta.json');console.log(m.license.spdx,m.license.attribution_required,m.remote)"
+CC0-1.0 false true
+$ node -e "const m=require('./catalog/broll/laptop-typing-closeup/meta.json');console.log(m.license.spdx,m.license.attribution_required)"
+LicenseRef-Mixkit-Free-License false
+$ node -e "const m=require('./catalog/font/noto-sans-jp/meta.json');console.log(m.license.spdx,m.license.attribution_required)"
+OFL-1.1 false
+```
+
+`catalog/telop/index.jsonl`（36 件）を `use_when.beats ⊇ emotion` で絞ると 3 件
+（`ref3_karaoke_flash` / `ref3_kid_karaoke` / `ref3_tl_r3s7_07`）であり、採用した
+`ref3_mincho_flash` は `roles: ["emphasis"]` / `tone: ["真面目","エモい"]` / `strength: high` である。
+
+ケース 1 の `sc-02` / `sc-03` の overlay HTML を一時プロジェクトへ置いた `edit.json`
+（`version: 0` + 単一 `source`）は、`validate-edit.mjs` が `OK`、`edit-lint` が
+`PASS (0 findings, 5 skipped)` である（本リーフの選択が既存の検証手順をそのまま通ることの実測。
+検証の正は [execution.md](execution.md) §4 の [edit-lint](../edit-lint/SKILL.md) 実行であり、
+本リーフは検証手順を追加しない）。
+
+## よくある間違い
+
+- 手段を先に決め、後からその手段が似合うシーンを探す（意味が手段を決める、の逆流）。
+- 「カタログに良い 3D があったから」を選択理由に書く。目新しさ・使いたさは理由にならない。
+- 1 シーンに主張する手段を 2 つ以上置く（3D + 全画面グラフ + 語レベル文字演出の同時発火）。
+- `allowed_means` を読まずに対応表だけで決める。フィルタは対応表より後段ではなく、**候補を
+  減らす前提条件**である。
+- 第一候補が `allowed_means` で除外されたとき、第二候補へ行かず「近い手段」へ滑らせる
+  （3D 不許可 → 3D 風のストック CG、をしない）。
+- 全滅したのに何かを埋めようとする。全滅の既定は**素の映像 + 字幕**である。
+- 「使わない」列の手段を、`allowed_means` に含まれていることを理由に採用する。許可は義務ではない。
+- `AI 生成` を `allowed_means` だけで判断し、intake の方針を見ない（二重ゲートである）。
+- 素材を `title` / `description` の語感で選び、`when_to_use` と `tags` を突き合わせない。
+- `meta.json` のライセンスを確認せずに採用する。`attribution_required: true` ならクレジット文の
+  義務が、再配布禁止なら公開リポジトリへコミットしない義務が発生する。
+- `catalog/` のエントリを取得済みの実体だと思い込む（`remote: true` の索引であり実体は無い）。
+- 該当ヒットが無いのに「あれば提案」と記録する、またはプレビューを捏造する。
+- 除外・全滅・不採用を記録せずに黙って落とす。除外も決定であり 1 行を残す。
+- 候補順位を飛ばした選択の理由を書かない（理由なき逸脱は不可。既定は第一候補）。
+- ハードフィルタを通ったことを承認と読み替え、Checkpoint 2 を省略する。

package/vendor/skills/edit-plan/plan-json.md

@@ -0,0 +1,52 @@
+# plan.json — 素材ゼロから仮枠タイムラインを確定する
+
+正本契約: [contract-2026-07-20-plan-json-v0.md](../../docs/contract-2026-07-20-plan-json-v0.md)。
+本リーフは [workflow.md](workflow.md) §2「素材がゼロの場合」の分岐からだけ読む。
+録画素材がある場合は plan.json を作らず、従来どおり分析統合からチャットでの方針提示へ進む
+（確度に応じてステップを飛ばせる 1 本のパイプライン。仮枠は方向性が不確かなときだけ効く）。
+
+## 1. 質問対話で方針を深掘る
+
+- 選択肢式（ABC 回答）の質問を 1 問ずつ重ね、目的・尺・トーン・構成ビートを確定させる。
+  1 問 = 1 決定にし、複合質問で回答を曖昧にしない
+- 対話サーフェスは [decision-cards](../../packages/decision-cards/) の既存機構を
+  そのまま使う: `<plan-dir>/plan-dialogue.html` + `<plan-dir>/plan-dialogue.html.decisions.json`
+  の別ペアを作り、`node packages/decision-cards/report-helper.mjs` で提示する。
+  ヘルパー不通時はチャットの明示承認で代替し、その旨を記録する（[approvals-and-generation.md](approvals-and-generation.md)
+  の Checkpoint 運用と同じ代替規約）
+- この decisions.json は plan-dialogue 専用であり、`decision-log.md`（判断記録）とはファイルを
+  分ける。混ぜない（decisions.json = 対話の生データ、decision-log.md = 確定した決定の要約）
+
+## 2. plan.json を書く
+
+- 置き場所は `<plan-dir>/plan.json`（`decision-log.md` と同じディレクトリ。AKARI プロジェクトでは
+  `planning/` ロールが既定）
+- 対話で決まった構成ビートを `slots[]`（配列順 = timeline 順、`start` は書かない）に、
+  決定事項（尺の上限・確定尺・位置つき指示）を `constraints[]` に落とす。
+  書式・必須キー・null 規約は契約 §1 のフィールド表に従う
+- 対話中の slot は `confidence: "proposed"` + `fill.method: null` で書き始めてよい。
+  人間が対話で確定させた項目だけを `locked` にする。**AI の判断で locked にしない**
+- 同一ファイルを段階的に更新する（`decision-log.md` への追記と同じ、確定した事実だけを積み増す
+  規律）。決定の経緯は対話の decisions.json が持つため、plan.json 側には結果だけを書く
+- 書いたら毎回検証する:
+  `node packages/schemas/bin/validate-plan.mjs <plan-dir>/plan.json`
+  （error 0 件を維持。warning は仮枠の未成熟として許容されるが、完了報告に列挙する）
+
+## 3. 確定と接続
+
+- 方針が確定したら（対話 decisions.json の `completedAt` 非 null、またはチャット明示承認）、
+  `.akari/events/` に gate event `plan-confirmed` を記録する
+- 以降の工程（[report-guide.md](report-guide.md) の「方針をチャットで決める」節）では、
+  編集方針のチャット提示が plan.json の slot id を根拠として参照する。台本や構成をチャット側で
+  再フリーテキスト化しない（2026-07-22 改訂: レポート生成は analyze-project へ移管済み。
+  plan.json の位置づけ自体は変わらない）
+- BGM・SFX・B ロール等の素材三択（提案/生成/不採用）は従来どおり
+  [report-guide.md の「素材計画」節](report-guide.md#素材計画)の管轄。plan.json には
+  持ち込まない（契約 §5）
+
+## 4. 仮枠プレビュー（現時点の運用）
+
+仮枠の再生 QA は「静止画 + TTS + テキストカードを通常の edit.json v1 にコンパイルする」
+規約（契約 §6）で行う設計だが、**コンパイラは未実装**。当面は静止コンセプトをチャットで
+提示する従来運用（workflow.md §2）を維持し、動画生成は承認工程まで保留する。
+コンパイラ実装後にこの節を差し替える。

package/vendor/skills/edit-plan/recipe.md

@@ -0,0 +1,74 @@
+# recipe.md — レシピ凍結と好みの記憶
+
+正本契約: [contract-2026-07-25-recipe-v0.md](../../docs/contract-2026-07-25-recipe-v0.md)。
+スキーマ: [recipe.schema.json](../../packages/schemas/recipe.schema.json)。
+検証 CLI: `node packages/schemas/bin/validate-recipe.mjs <path>`。
+
+本リーフは 2 つの独立した手順を持つ。**recall**（[workflow.md](workflow.md) の方針決めの前段
+から読む）と **freeze**（実行承認後の完了処理から読む）。学習・自動適用はしない —
+確認済みのみ記録し、出所付きで提示するだけのファイル契約である（契約 §0）。
+
+## 1. recall 手順（方針決めの前段で行う）
+
+方針をチャットで人間に提示する前に、一度だけ次を行う。
+
+1. `~/.akari/recipes/` を列挙する（存在しなければ何もせず通常フローへ進む — error にしない）
+2. `workflow: "edit"` のレシピだけを対象にする（`workflow: "research"` は無視する）
+3. 該当レシピが 1 件以上あれば、`node packages/schemas/bin/validate-recipe.mjs` で検証してから
+   使う（version が新しすぎて read-only 停止したレシピは無視して続行する — recall の失敗は
+   工程を止めない。契約 §5 の劣化規約）
+4. 検証を通ったレシピの `confirmed` を、**出所（`provenance[].confirmed_by` / `at`）を名乗る
+   推奨**としてチャットで提示する。例:
+   「前回の **<名前>**（<source_project>）では <aspect> / <target_duration_band> 等を
+   採用していました。今回も同じにしますか、それとも今回用に決め直しますか」
+5. 提示は**現在の依頼を上書きしない**。人間が明示的に「<名前>でもう一本」「前回と同じで」と
+   採用を宣言したときだけ、対応する `confirmed` フィールドを今回の方針・素材計画へ**一括で**
+   反映してよい（契約 §3 規律 3）。採用宣言が無ければ、レシピは参考情報のまま通常の
+   Checkpoint 1〜3（[approvals-and-generation.md](approvals-and-generation.md)）を進める
+6. レシピの提示は **intake の進め方フォーム等、必須質問をスキップさせる理由にしない**。
+   レシピが見つかっても intake は通常どおり提出させる（契約 §3 規律 2）
+7. 複数の `workflow: "edit"` レシピが見つかった場合は、`frozen_at` が新しいものを先頭にして
+   候補一覧として提示する（自動選択しない。どれを使うか、あるいは使わないかは人間が選ぶ）
+
+## 2. freeze 手順（完了処理で一度だけ申し出る）
+
+Checkpoint 3（実行）の承認を得て `edit.json` と最終 overlay を作った後、**そのプロジェクトで
+まだ freeze を提案していなければ**、一度だけ（offer-once）レシピ化をチャットで申し出る。
+既に同一プロジェクト内で申し出済み（採用・却下いずれの回答でも）なら、二度と申し出ない
+（契約 §3 規律 4）。
+
+1. **確認済みの値だけを集める**。`confirmed` に書いてよいのは、人間が明示承認した
+   チェックポイントを実際に通過した値だけである。推測やデフォルト採用で埋まった値は
+   **確認済みのみ記録**の契約に反するため、たとえ最終出力に含まれていても記録しない
+   （契約 §3 規律 1）。値ごとの出所は次のように対応させる（契約 §4）:
+   - `intake`: 進め方フォーム（`intake.json`）提出で決まった値
+   - `structure-confirm`: 研究/構成の確定決定カードで決まった値（edit-plan では通常発生しない。
+     素材ゼロで plan.json 経由の企画確定を経た場合のみ該当）
+   - `edit-approval`: Checkpoint 1（方針）/ Checkpoint 2（素材計画）の明示承認で決まった値
+     （`caption_style_ref` / `bgm_profile` / `overlay_kinds` / `narration` は多くの場合ここ）
+   - `render-approval`: Checkpoint 3（実行 manifest）の明示承認で決まった値
+     （出力 `aspect` は多くの場合ここ）
+2. 対象は `confirmed.aspect` / `target_duration_band` / `caption_style_ref` / `bgm_profile` /
+   `overlay_kinds[]` / `narration`（`engine`/`voice`）のうち、実際に確認済みのものだけ。
+   1 件も確認済みが無ければ freeze を申し出ない
+3. 名前（kebab-case）を人間に確認する。既存の同名レシピがあれば上書きしてよいか確認する
+   （無言上書きをしない）
+4. `~/.akari/recipes/<name>.json` を組み立て、`node packages/schemas/bin/validate-recipe.mjs`
+   で検証する（exit 0 を確認するまで保存済みとして扱わない）
+5. 検証を通ったら `~/.akari/recipes/` に保存し（ディレクトリが無ければ作成する）、
+   人間に次の定型文で確認する（呼び出し方まで教える。名前はシステムが思い出させるものであり
+   ユーザーが暗記するものではない）:
+
+   > **<名前>** として保存しました。今後のために記憶します。次回は『<名前>でもう一本』か『前回と同じで』と言ってください。
+
+6. これでそのプロジェクトの freeze 申し出は完了（offer-once）。同じプロジェクト内で
+   再度申し出ない。別プロジェクトで再び完了処理に到達したときは、新しい申し出として扱う
+
+## よくある間違い
+
+- 推測やデフォルト採用の値を `confirmed` に書く（人間が明示承認した値だけが確認済み）
+- レシピの推奨値で今回の依頼を上書きする、または intake 等の必須質問をスキップする
+- 同一プロジェクトで freeze を何度も申し出る（offer-once 違反）
+- レシピ採用の明示宣言（「前回と同じで」等）が無いのに `confirmed` を無言で今回の計画へ流用する
+- `~/.akari/recipes/` 以外（プロジェクト内 `planning/` 等）にレシピを保存する
+- `validate-recipe.mjs` を通さずに freeze 完了として報告する

package/vendor/skills/edit-plan/references/asset.decisions.example.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "asset": "assets/interview.mp4",
+  "decisions": [
+    {
+      "id": "opening-hook",
+      "summary": "冒頭の結論を先に見せる",
+      "status": "approved",
+      "updatedAt": "2026-07-15T12:00:00.000Z"
+    }
+  ]
+}

package/vendor/skills/edit-plan/references/event.example.json

@@ -0,0 +1,7 @@
+{
+  "version": 1,
+  "id": "2026-07-15T12-00-00-000Z-report-approved-example",
+  "type": "report-approved",
+  "occurredAt": "2026-07-15T12:00:00.000Z",
+  "artifact": "planning/report.md"
+}