movie-builder-mcp 0.1.0

package/README.md

@@ -0,0 +1,33 @@
+# movie-builder-mcp
+
+台本から動画を自動生成する MCP サーバー（stdio）の配布パッケージです。
+
+## インストール
+
+**ストア経由でのインストールが正規ルートです。** このパッケージを直接 `npm install` して使うことは想定していません（起動パッケージ・設定はストアが配布します）。
+
+## 前提
+
+- **Node.js 22 以上**
+- **ffmpeg / ffprobe**（音声・動画の結合。`brew install ffmpeg`）
+- **Codex CLI**（`codex` コマンド）＋ ChatGPT サブスクリプションでのログイン（画像生成に使用）
+- **Google Chrome**（スライドの組版・PNG 書き出しに使用）
+- **uv + Python 3.12**（字幕の強制アラインメントに使用。`scripts/setup-whisper.sh` で構築）
+
+導入状態は MCP ツール `check_health` で確認できます。
+
+## 構成
+
+- `dist-obf/mcp.cjs` — MCP サーバー本体（stdio）。起動すると確認用 Web UI（`http://127.0.0.1:3763`）も自動で立ち上がります
+- `dist-obf/api.cjs` — 確認用 Web UI の単体起動口
+- `viewer/` — 確認用 Web UI の静的ファイル
+- `chains/` / `templates/` — 生成に使う定義・テンプレート
+- `scripts/` — 字幕アラインメント用のセットアップスクリプトと実行スクリプト
+
+## データの置き場所
+
+既定で `~/.movie-builder/`（`MB_DATA_DIR` で変更可）。SQLite と生成物の実体はすべてローカルに置かれ、外部へ送信されません。
+
+## ライセンス
+
+本パッケージは難読化ビルドのみを含みます。無断での解析・再配布を禁じます。

package/chains//343/202/273/343/203/274/343/203/253/343/202/271/343/203/273/350/252/254/345/276/227.md

@@ -0,0 +1,465 @@
+# チェーン定義: セールス・説得
+
+> ⚠️ **このファイルの依存エージェント一覧（変更時は全員を点検すること）**
+> - **CUE本体**（`agents/映像構築.md`・マイエージェント登録）── カテゴリ「セールス・説得」が選択された案件で本ファイルを読み込み、STEP1〜STEP3を自分自身（Claude Code）が直接実行する。ステップ名・入力欄・プロンプト骨格・検証項目の変更はここに直結する。
+> - **movie-builder-mcp チェーンローダ**（Phase 8実装・T-002 `create_project` の入力欄定義／T-004 `save_sheet` の stage 別検証門番）── `category=セールス・説得` の案件でチェーン定義データとして本ファイルを参照する。「## 1. カテゴリ属性」の stage マッピング・枚数レンジ・「## 4. 台本(IR)への接続」の致命/警告基準は、ローダの実装契約と一字一句食い違わないこと。
+>
+> 本ファイルはコードではなくデータである（`docs/requirements.md` §3-2 の設計方針）。プロンプト骨格・検証項目を変更したら、上記2箇所に矛盾が生じないか必ず点検してから確定する。
+
+---
+
+## 1. カテゴリ属性
+
+| 属性 | 値 |
+|---|---|
+| カテゴリ名 | セールス・説得 |
+| 段数 | **3段**（素材抽出 → 構成設計 → 台本作成）。研修・教育系にある「拡張情報（内容深堀り）」段は**使わない**（本カテゴリは文字起こしという実データが起点であり、事実にない内容を広げて深掘りする工程は事実補完のリスクを生むため、構造上省く） |
+| stageマッピング（`save_sheet` 保存先） | STEP1（素材抽出）→ `requirements` ／ STEP2（構成設計）→ `structure` ／ STEP3（台本作成）→ `script`。`expansion` 段は**存在しない**（本カテゴリで `expansion` に保存する処理を実装・呼び出ししてはならない） |
+| 性格型 | **説得型**（文字起こし起点。数字・実績は事実のみを拾い、語られていないことを補完しない。訴求意図として読み取れるものは「推定される意図」として事実と分離して整理する） |
+| 初期入力欄 | 文字起こしデータ＊（営業トーク・説明会等の逐語または要約）／訴求する商品・サービス＊／ターゲット＊／してほしい行動＊（CTA）／自由入力（お客様の声・実績・数字、価格・特典、必ず入れたい訴求や避けたいNG表現）。＊は必須 |
+| 枚数レンジ | **30〜50枚・5〜7フェーズ**（研修・教育系の6〜20枚・つかみ→基礎理解→具体例→応用・注意→まとめとは枚数・フェーズ密度が大きく異なる。この差を薄めて教育系に寄せてはならない） |
+| フェーズ基本形 | 7フェーズ（① ツカミ・共感 → ② 問題提起・深掘り → ③ 解決策 → ④ 証拠・信頼 → ⑤ 価値の再確認 → ⑥ オファー → ⑦ 不安の解消・行動喚起）。オファー（⑥）の直前に価値再確認スライド（⑤）を**1回だけ**置く。フェーズの境目はブリッジ（引き）でつなぎ、独立完結させない |
+| 概要欄 | **STEP2の出力には無し**（研修・教育／紹介／告知カテゴリと違い、構成設計の出力に概要欄相当のセクションを追加しないこと）。ただし**納品プロファイルが「投稿1本ぶん一式」のときだけ、独立した概要欄段（§7・stage `description`）で新規に作る**（v2）。`structure` には書き戻さない |
+| 図解パターン語彙 | 13種（「## 3. 図解パターン語彙」参照。教育系10種とは異なり、実績グラフ型・お客様の声カード型・料金表型・チェックリスト型・ステップ型・ケーススタディ型を含む） |
+| 法令配慮 | 誇大・虚偽・誤認を招く表現や根拠のない断定を避ける。景品表示法・薬機法など関連法令への配慮を STEP2・STEP3 のプロンプト骨格に明文で組み込む（省略不可） |
+| 抽出8観点（STEP1） | ①ターゲットと悩み ②ベネフィット・提供価値 ③商品・サービス（特徴・差別化） ④証拠・信頼 ⑤不安・反論とその解消 ⑥オファー ⑦行動喚起 ⑧感情・コピー素材 |
+| コピペ工程 | **なし**。外部AIへのコピペ往復は行わない。Claude Code（CUE本体）自身が各STEPのプロンプト骨格に沿って成果物を生成し、`T-004 save_sheet` で直接保存する |
+| シリーズ（v2） | 企画段＝§6（`save_series_sheet` stage:`plan`・完結型/連載型の2モード）／概要欄段＝§7（`save_sheet` stage:`description`）。**§2 のカテゴリ別チェーン本体は v1 から変えていない**（1件だけ作る経路はそのまま） |
+
+---
+
+## 2. STEP定義
+
+### STEP1: 素材抽出（保存先stage: `requirements`）
+
+**目的**: 文字起こしデータおよび周辺情報から、視聴者の意思決定を動かす説得要素を漏れなく抽出し、STEP2（構成設計）・STEP3（台本作成）の土台となる事実ベースの棚卸しを作る。
+
+**入力**（案件作成時 `T-002 create_project` の `raw_input` として受領。本ステップ実行前に全て埋まっていること。未入力の必須項目があれば実行せず、CUE本体が人間にヒアリングして埋める）:
+- 文字起こしデータ＊（営業トーク・説明会・セミナー音源の逐語または要約）
+- 訴求する商品・サービス＊
+- ターゲット＊
+- してほしい行動＊（CTA）
+- 自由入力（お客様の声・実績・数字、価格・特典、必ず入れたい訴求、避けたいNG表現）
+
+**プロンプト骨格**（Claude Code 自身が以下の役割・ルールに沿って分析し、そのまま成果物を生成する。外部AIへの送信・貼り戻しは行わない）:
+
+```
+あなたは、営業トーク・商品情報・お客様の声などの素材から、視聴者を購入・申込・問い合わせへ動かす
+説得要素を抽出する、セールスコンテンツ分析の専門家として振る舞う。
+
+# 目的
+入力素材から、視聴者の意思決定を動かす要素（悩み・欲求／ベネフィット／証拠／差別化／不安と解消／
+オファー／行動喚起）を漏れなく抽出し、後続の構成設計・台本作成の土台をつくる。
+
+# 分析ルール
+- 重要そうな部分だけでなく、余談・例え話・言い換えも、訴求に使えるものは抽出する
+- 数字・実績・効果は文字起こしデータおよび自由入力に事実として記載されているものだけを拾い、
+  語られていないことを一切補完しない
+- 訴求の意図として読み取れるもの（話者が明言していない狙い）は「推定される意図」として、
+  事実の抽出と明確に分けて整理する
+- 重複は削除せず、一度すべて拾ったうえで整理段階でまとめる
+- 抽象的な話は「誰のどんな悩みに効くか」「どんな結果につながるか」に分解する
+
+# 抽出ルール（8観点。すべてを網羅すること）
+1. ターゲットと悩み
+2. ベネフィット・提供価値（Before→After・感情的価値/機能的価値）
+3. 商品・サービス（特徴・仕組み・差別化ポイント）
+4. 証拠・信頼（実績・事例・お客様の声・権威性・保証）
+5. 不安・反論とその解消
+6. オファー（価格・特典・限定性・返金保証など、入力情報にあるもののみ）
+7. 行動喚起（CTA文言候補）
+8. 感情・コピー素材（刺さるフレーズ・キラーコピー・ストーリー要素）
+
+# 入力情報
+- 文字起こしデータ：《文字起こしデータの実値》
+- 訴求する商品・サービス：《訴求する商品・サービスの実値》
+- ターゲット：《ターゲットの実値》
+- してほしい行動：《してほしい行動の実値》
+- 自由入力：《自由入力の実値（お客様の声・実績・価格・特典・NG表現等）》
+
+# 出力フォーマット
+## 1. 全体の概要
+（商品・サービス／ターゲット／中心メッセージ1〜3文／CTA）
+## 2. 説得要素の整理（8観点それぞれを箇条書き）
+## 3. センテンス単位の詳細抽出
+| No. | 原文または要約 | 抽出できる要素 | 種類（悩み/ベネフィット/証拠/差別化/反論処理/オファー/CTA/感情・コピー） | 活用方法 |
+
+# 確認ルール
+出力前に、8観点すべてに1件以上の抽出があるか自己確認する。抽出が0件の観点があれば、
+「入力情報に該当記述なし」と明記し、存在しない事実を創作して埋めない。
+```
+
+> 《...》は本ファイル上のプレースホルダ表記であり、実行時は必ず `raw_input` の実値へ置換すること。実行時に生成する成果物シートに `《...》` および `{{...}}` の残留があってはならない（`save_sheet` は `{{...}}` 残留を致命として保存を拒否する。`《...》` も同様に自己検証で必ず除去してから保存すること）。
+
+**出力フォーマット**: 上記プロンプト骨格の「# 出力フォーマット」節に従うMarkdown（全体の概要／説得要素の整理／センテンス単位の詳細抽出表）。
+
+**検証項目**（`T-004 save_sheet` へ送る前の自己検証チェックリスト）:
+- [ ] 8観点（ターゲットと悩み／ベネフィット／商品・差別化／証拠・信頼／不安・反論と解消／オファー／行動喚起／感情・コピー素材）すべてに記述があるか、「該当記述なし」の明記があるか
+- [ ] 数字・実績の記述はすべて入力情報（文字起こしデータ・自由入力）に根拠があるか（補完・創作が混入していないか）
+- [ ] 「推定される意図」が事実の抽出と明確に区別されているか
+- [ ] センテンス単位の詳細抽出表に、原文または要約・抽出要素・種類・活用方法の4列が揃っているか
+- [ ] `《...》` `{{...}}` の残留がないか
+- [ ] 固有名（人名・社名・実在商品名）が地の文にそのまま書かれていないか（入力情報に含まれる場合も、地の文での多用を避け、必要な引用は原文引用として扱う）
+
+---
+
+### STEP2: 構成設計（保存先stage: `structure`）
+
+**目的**: STEP1で抽出した説得要素をもとに、視聴者を購入・申込・問い合わせへ導く1本のセールス動画のシナリオ構成（フェーズ構成＋全体スライド構成）を設計する。
+
+**入力**: STEP1成果物（`requirements` stage の保存済みMarkdown全文）。
+
+**プロンプト骨格**:
+
+```
+あなたは、抽出済みの説得要素をもとに、視聴者を購入・申込へ導く1本のセールス動画のシナリオ構成を
+設計する構成作家として振る舞う。
+
+# 目的
+共感 → 問題提起 → 解決 → 証拠 → オファー → 行動喚起の流れで、最後まで視聴させ、
+視聴者が無理なく行動に至るスライド構成案をつくる。
+
+# 構成条件
+- ターゲットに最適化し、CTAへの着地に向けて全体を設計する
+- 一本の流れとして設計する。フェーズはラベルであり、各フェーズを独立完結させない
+- 導入は冒頭1回（ツカミ）、締めは最後1回（CTA）のみ
+- フェーズの境目はブリッジ（引き）でつなぐ
+- オファー直前に1回だけ、価値を再確認するスライドを置く
+- 全体は5〜7フェーズ、合計30〜50枚程度とする（教育系の6〜20枚とは異なるレンジであることに注意）
+- 1スライド1メッセージ
+
+# フェーズルール（7フェーズ基本形）
+1. ツカミ・共感
+2. 問題提起・深掘り（放置リスク・なぜ今か）
+3. 解決策（商品・差別化）
+4. 証拠・信頼
+5. 価値の再確認
+6. オファー（価格・特典・限定性・リスク軽減）
+7. 不安の解消・行動喚起
+
+# スライド設計ルール
+- タイトルは「自分ごと」化し続きを見たくなる表現にする（例:「なぜ今か」「知らないと損する」等の型）
+- 図解指示は Before・After、比較表、実績グラフ、お客様の声カード、料金表など、
+  「## 3. 図解パターン語彙」の13種から具体的に選ぶ
+
+# 情報の扱い方（法令配慮・必須）
+- 効果・実績・数字は STEP1 で抽出された事実に基づき、誇大・虚偽・誤認を招く表現や
+  根拠のない断定は避ける
+- 景品表示法・薬機法など関連法令への配慮を前提とする（業種・商材によって規制対象が異なるため、
+  断定的な効能表現・最上級表現は入力情報に明記された事実の範囲を超えて使わない）
+
+# 入力情報
+- STEP1成果物（素材抽出シート全文）：《requirements stage 保存済み本文》
+
+# 出力フォーマット
+## 1. 動画全体のタイトル案
+## 2. コンセプト（200文字程度）
+## 3. ターゲット視聴者
+## 4. CTA
+## 5. フェーズ構成
+| フェーズ | フェーズ名 | 目的（視聴者の心理変化） | 扱う主な訴求要素 | 想定スライド枚数 |
+## 6. 全体スライド構成（通し番号）
+| スライド番号 | フェーズ | スライドタイトル | 伝える1メッセージ | 画面に表示する主な内容 | 図解・ビジュアル指示 | 話す内容の方向性 |
+
+※概要欄テキストはこの段では作らない（本カテゴリの structure に概要欄は存在しない。納品プロファイルが「投稿1本ぶん一式」のときだけ §7 概要欄段で別に作る）
+```
+
+**出力フォーマット**: 上記「# 出力フォーマット」節のMarkdown（動画全体のタイトル案／コンセプト／ターゲット視聴者／CTA／フェーズ構成表／全体スライド構成表）。
+
+**検証項目**（自己検証チェックリスト）:
+- [ ] フェーズ数が5〜7、合計スライド枚数が30〜50枚の範囲内か
+- [ ] フェーズ構成が7フェーズ基本形（ツカミ・共感→問題提起・深掘り→解決策→証拠・信頼→価値の再確認→オファー→不安の解消・行動喚起）に沿っているか、逸脱する場合は理由が説明できるか
+- [ ] オファー直前に価値再確認スライドが1回だけ置かれているか（複数回・0回になっていないか）
+- [ ] 導入（ツカミ）が冒頭1回、締め（CTA）が最後1回のみか
+- [ ] 各フェーズの境目にブリッジ（引き）の設計意図があるか
+- [ ] 図解・ビジュアル指示が「## 3. 図解パターン語彙」13種の名称で具体的に書かれているか
+- [ ] 効果・実績・数字の表現が STEP1 の事実の範囲を超えて誇張されていないか（法令配慮）
+- [ ] 概要欄テキストを structure に追加していないか（必要な場合は §7 概要欄段で別に作る）
+- [ ] `《...》` `{{...}}` の残留がないか
+
+---
+
+### STEP3: 台本作成（保存先stage: `script`）
+
+**目的**: STEP2の構成案をもとに、視聴者を行動へ導く1本のセールス動画のスライド台本を、`■■■■■` IR（中間表現）形式で作成する。
+
+**入力**: STEP2成果物（`structure` stage の保存済みMarkdown全文）。
+
+**プロンプト骨格**:
+
+```
+あなたは、構成案をもとに、視聴者を行動へ導く1本のセールス動画のスライド台本を作成する
+構成作家兼セールスコピーライターとして振る舞う。
+
+# 構成ルール
+- 構成案（STEP2成果物）を最優先する
+- 指定がなければ 共感→問題提起→解決→証拠→価値の再確認→オファー→行動喚起 の流れに従う
+- 各フェーズの境目はブリッジ（引き）でつなぐ。オファー直前で価値を一度束ねる
+
+# 台本ルール
+- ターゲットに語りかけ、CTAへ自然に導く
+- 機能の説明より「得られる結果・変化」を中心に語る
+- 証拠・実績は具体的な数字や事例で補強する。ただし STEP1・STEP2 に事実として存在するものに限る
+- 不安・反論には先回りして安心材料を示す
+- 各フェーズの境目は「次が見たくなる引き」でつなぐ
+- CTAは「何を・どうすればよいか」を具体的に示す
+- 誇大・虚偽・根拠のない断定は避け、緊急性・限定性は事実の範囲でのみ扱う
+  （景品表示法・薬機法など関連法令への配慮を前提とする）
+- です・ます調、読み上げやすいリズムで書く
+
+# 図解ルール（セールス専用13種・「## 3. 図解パターン語彙」を参照し、レイアウトパターン名を必ず記載する）
+中央メッセージ型／左右比較型／Before・After型／問いかけ型／3要素分解型／原因と結果型／
+キーワード整理型／実績グラフ型／お客様の声カード型／料金表型／チェックリスト型／ステップ型／
+ケーススタディ型
+（＋配置・要素・強調キーワード・余白・入れない方がよい情報を具体的に書く。色・配色は指定しない）
+
+# 画面表示ルール
+- 表示テキストは短く（見出し・短い説明・箇条書き）
+- 画面には骨格を置き、台本では意味・背景・感情を補う
+
+# 内部作業ルール（出力には含めない思考整理）
+商品・ターゲット・中心メッセージ・CTA・各フェーズ目的の把握 → 各スライド1メッセージの決定 →
+図解と台本の役割分担 → フェーズ境目の調整
+
+# 入力情報
+- STEP2成果物（構成設計シート全文）：《structure stage 保存済み本文》
+
+# 表記・出力フォーマット（共通 ■■■■■ IR。枚数が30〜50枚でも書式は同一）
+■■■■■
+# タイトル
+（20文字以内）
+# 図解説明
+（200文字以上。「## 3. 図解パターン語彙」13種のいずれかのレイアウトパターン名を必ず記載する）
+# 台本
+（120〜300文字。話し言葉のナレーション）
+# オプション {avatar: on}        ← 拡張行（省略可・省略時は既定値=アバターなし）
+■■■■■
+
+上記ブロックを、STEP2「全体スライド構成」の枚数分（30〜50枚）繰り返し出力する。
+```
+
+**出力フォーマット**: `■■■■■` 区切りのIRブロックを、STEP2で確定したスライド枚数分（30〜50枚）連続して出力する。書式の詳細は「## 4. 台本(IR)への接続」を参照。
+
+**検証項目**（`T-004 save_sheet` へ送る前の自己検証チェックリスト。8観点の反映確認を含む）:
+- [ ] `■■■■■` 区切りの数とスライド数が一致しているか（開始・終了が対になっているか）
+- [ ] 各スライドに「タイトル」「図解説明」「台本」の3見出しが揃っているか
+- [ ] タイトルが20文字以内か（超過は警告扱いだが、可能な限り遵守する）
+- [ ] 図解説明が200文字以上あり、「## 3. 図解パターン語彙」13種のいずれかのレイアウトパターン名が明記されているか
+- [ ] 台本が120〜300文字の範囲内か
+- [ ] スライド総数が30〜50枚の範囲内か
+- [ ] STEP1の抽出8観点（ターゲットと悩み／ベネフィット／商品・差別化／証拠・信頼／不安・反論と解消／オファー／行動喚起／感情・コピー素材）が台本全体を通じて漏れなく反映されているか
+- [ ] オファー直前の価値再確認スライドが維持されているか
+- [ ] 数字・実績・効果の記述が誇張されていないか、緊急性・限定性が事実の範囲で扱われているか（景表法・薬機法配慮）
+- [ ] `{{...}}` `《...》` の残留が一切ないか（`save_sheet` は `{{...}}` 残留を致命として保存を拒否する）
+- [ ] 固有名（人名・社名・実在商品名）が地の文に露出していないか
+
+---
+
+## 3. 図解パターン語彙（セールス専用13種）
+
+| # | パターン名 | 定義・使い所 |
+|---|---|---|
+| 1 | 中央メッセージ型 | 画面中央に1つの強いメッセージ・キーコピーを大きく配置。ツカミ・締めなど、最も伝えたい1文を印象づけたいスライドに使う |
+| 2 | 左右比較型 | 画面を左右に分割し2つの対象（旧来のやり方 vs 提案する方法など）を並置。差別化・選択肢比較を見せる場面に使う |
+| 3 | Before・After型 | 変化の前後を上下または左右で対比。ベネフィット（Before→After）を視覚的に見せる場面に使う。証拠として使う場合は事実に基づく変化のみ扱う |
+| 4 | 問いかけ型 | 視聴者への問いを画面に大きく提示。ツカミ・問題提起で「自分ごと」化させたい場面に使う |
+| 5 | 3要素分解型 | 1つの概念・特徴を3つの要素に分解して並べる。商品・サービスの仕組みや差別化ポイントを整理する場面に使う |
+| 6 | 原因と結果型 | 原因→結果の矢印構造。問題提起の深掘り（放置リスクの構造）や解決策の効果説明に使う |
+| 7 | キーワード整理型 | 複数のキーワードを整理して並べる。ベネフィットや訴求ポイントを箇条書き的に見せる場面に使う |
+| 8 | 実績グラフ型 | 数値実績をグラフ・チャートで視覚化。証拠・信頼のスライドで、入力情報にある実際の数字のみを使って作る |
+| 9 | お客様の声カード型 | 顧客の声・レビューをカード状に配置。証拠・信頼のスライドで、自由入力にある実際の声のみを使う（創作しない） |
+| 10 | 料金表型 | 価格・プラン・特典を表形式で整理。オファーのスライドで、入力情報にある価格・特典のみを使う |
+| 11 | チェックリスト型 | チェックマーク付きの箇条書き。オファーに含まれる内容の一覧や、不安解消のための確認事項提示に使う |
+| 12 | ステップ型 | 番号付きのステップ・手順で提示。行動喚起で「何を・どうすればよいか」を具体的に示す場面に使う |
+| 13 | ケーススタディ型 | 特定の事例（誰が・どう使って・どうなったか）を1つのまとまりとして提示。証拠・信頼、または解決策の具体イメージを見せる場面に使う。事例内の固有名は「例（ある◯◯商材の場合）」のように一般化して扱う |
+
+図解説明（STEP3の「図解説明」見出し）には、上記13種から選んだレイアウトパターン名を必ず明記したうえで、配置・要素・強調キーワード・余白・入れない方がよい情報を具体的に書く。色・配色はここでは指定しない（デザイン仕様シート・skinの責務）。
+
+---
+
+## 4. 台本(IR)への接続
+
+STEP3の出力は、`movie-builder-mcp` の共通 `■■■■■` IR 形式にそのまま合流する（`docs/requirements.md` §3-1）。**枚数が30〜50枚と多い本カテゴリでも、書式はカテゴリ間で完全に同一**である。
+
+```markdown
+■■■■■
+# タイトル
+（20文字以内）
+# 図解説明
+（200文字以上。レイアウトパターン名を必ず記載: 「## 3. 図解パターン語彙」13種のいずれか）
+# 台本
+（120〜300文字。話し言葉）
+# オプション {avatar: on}        ← 拡張行（省略可）
+■■■■■
+```
+
+**`T-004 save_sheet`（stage: `script`）の判定基準**（`docs/SCOPE_PROGRESS.md` バックエンド実装計画 §5 準拠。要約）:
+
+| 区分 | 内容 | 結果 |
+|---|---|---|
+| 致命（保存拒否） | `■■■■■` 区切り不整合 | 保存されない。violations列挙で返る |
+| 致命（保存拒否） | 「タイトル・図解説明・台本」いずれかの見出し欠落 | 同上 |
+| 致命（保存拒否） | `{{...}}` テンプレ変数残留 | 同上（本カテゴリでは加えて `《...》` の残留も自己検証段階で必ず除去し、致命扱いと同等に扱う） |
+| 致命（保存拒否） | スライド0枚 | 同上 |
+| 警告（保存はされる） | タイトル20字超 | warningsで返る |
+| 警告（保存はされる） | 図解説明200字未満（レイアウトパターン名未記載を含む） | 同上 |
+| 警告（保存はされる） | 台本120〜300字逸脱 | 同上 |
+
+本カテゴリ固有の追加自己検証（`save_sheet` 呼び出し前にエージェント側で行う。ツール側の機械検証を補完する）:
+- スライド総数が30〜50枚の範囲内か（範囲外は `save_sheet` の機械検証対象外のため、エージェント自身が確認し逸脱時はSTEP2に差し戻す）
+- STEP1の抽出8観点が台本全体に反映されているか
+- オファー直前の価値再確認スライドが1枚だけ存在するか
+
+---
+
+## 5. このカテゴリの禁則
+
+1. **事実の範囲を超えない**: 数字・実績・効果・お客様の声は、STEP1で抽出した入力情報（文字起こしデータ・自由入力）にある事実のみを使う。語られていないことを補完・創作しない。訴求意図として読み取れるものは「推定される意図」として事実と明確に分離する。
+2. **緊急性・限定性は事実の範囲でのみ扱う**: 「今だけ」「残りわずか」等の表現は、入力情報に実際にそう記載されている場合のみ使い、演出目的で創作しない。
+3. **法令配慮を省略しない**: 誇大・虚偽・誤認を招く表現、根拠のない断定を避け、景品表示法・薬機法など関連法令への配慮をSTEP2・STEP3の生成物に必ず反映する。業種・商材によって規制対象が異なるため、断定的な効能表現・最上級表現は特に注意して事実の範囲を超えないか自己確認する。
+4. **枚数レンジ・概要欄を教育系に寄せない**: 本カテゴリは30〜50枚・5〜7フェーズであり、教育系（6〜20枚）とは別属性である。**STEP2（構成設計）の出力に概要欄テキストを追加しない**（概要欄が要るのは納品プロファイルが「投稿1本ぶん一式」のときだけで、その場合は独立した概要欄段 §7＝stage `description` で作る。`structure` 段には混ぜない）。
+5. **`{{...}}` `《...》` を成果物に残さない**: 本ファイル内のプレースホルダは `《...》` 表記で示しているが、実行時は必ず実値に置換し、保存する成果物シートに `《...》` も `{{...}}` も一切残さない。`save_sheet` は `{{...}}` 残留を致命として保存を拒否する。
+6. **コピペ工程を作らない**: 外部AI（ChatGPT/Claude/Gemini等のWeb版）へのコピペ往復を一切行わない。各STEPはClaude Code（CUE本体）自身が直接生成し、`T-004 save_sheet` で保存する。
+7. **固有名を地の文に入れない**: 入力情報に実在の人名・社名・商品名が含まれていても、STEP2・STEP3の地の文にそのまま書かない。事例として言及する場合は「例（ある◯◯商材の場合）」のように一般化したラベルの中でのみ扱う。
+8. **`expansion` stageを使わない**: 本カテゴリのチェーンは3段（requirements→structure→script）であり、`expansion` stageへの保存処理を呼び出してはならない。
+
+---
+
+## 6. 企画段（シリーズ・v2）
+
+> **この段はシリーズで「まとめて N 本作る」ときにだけ使う。** プロジェクトを1件だけ作るなら §2 の STEP定義から始めてよい（v1 の経路は一切変わらない）。
+> 保存先は `T-023 save_series_sheet(series_id, stage: 'plan', markdown)` — **シリーズのシートであって、プロジェクトのシートではない**。`save_sheet` に渡さない。
+
+### 6-1 2つのモード（シリーズの型で切り替わる）
+
+| 型 | この段でやること | 出力の範囲 |
+|---|---|---|
+| **完結型**（全体像が事前に決まる） | **全体像を設計する** | 全回ぶんを一度に書く。回をまたいだ重複・欠落をこの段で潰す |
+| **連載型**（終わりが決まらず増え続ける） | **既に出した回を踏まえ、次に出すものを提案する** | 次に足す1〜数本だけを追記する。**全体像を先に確定させない** |
+
+- **連載型で企画シートを強制しない。** 企画シートは任意であり、無くても `T-024 add_videos(from:'manual')` で1本ずつ足せる
+- 既存の構成表をユーザーが持っている場合は、AIが書き直さず**同じ書式で受ける**（AI提案は既定であって強制ではない）
+
+### 6-2 書式（台本IRと同じ ■■■■■ 区切り・1本＝1ブロック）
+
+```
+■■■■■
+# タイトル
+（30文字以内）
+# ねらい
+（100文字以上。この回で視聴者が何を得るか）
+# 扱う内容
+（箇条書き。この回の §2 STEP1 への入力になる）
+# オプション {avatar: on, section: 《セクションラベル》}     ← 拡張行（省略可）
+■■■■■
+```
+
+- `# オプション` の `avatar: on` は**その回の全スライドの既定値**になる（スライド単位の上書きは台本IRで従来どおり可能）
+- `section` は任意テキストのラベル（一覧の見出し・書き出しのフォルダ分けに使う）。順序はラベルではなく回の並びが決めるので、ラベル文字列に番号を埋め込まない
+- 《...》 は実行時に必ず実値へ置換する。`{{...}}` 記法は使わない
+
+### 6-3 このカテゴリでの「ねらい」「扱う内容」の書き方
+
+- **ねらい**は「その回で視聴者に**取ってほしい行動**と、そこへ運ぶ**説得上の役割**」で書く。「商品を紹介する」で終わらせない
+- **扱う内容**は「**元の文字起こしのどの部分を使うか**」で書く。説得型は実データが起点であり、**企画段で語られていない訴求を作らない**（§2 STEP1 の8観点のどれに当たるかを添えると各回の STEP1 が速い）
+- **1シリーズ内で同じ証拠・同じ実績を使い回して水増ししない**。同じ証拠しか無いなら、その回は作らずシリーズを短くする
+- **法令配慮は企画段のねらい文にも及ぶ**。誇大・虚偽・誤認を招く表現、根拠のない断定を企画段で書かない（景品表示法・薬機法など関連法令への配慮）
+- **完結型**: 7フェーズの基本形をシリーズ全体へ引き伸ばす（商品理解 → 問題提起 → 解決策 → 証拠・信頼 → 価値の再確認 → オファー → 不安の解消）。オファー回の直前に価値再確認を1回だけ置く
+- **連載型**: **1本1訴求**。回ごとに独立した訴求で完結させ、CTA は毎回同じでよい
+- 本カテゴリは1本あたり30〜50枚と重い。**まとめて作る前の実費・所要時間の提示を特に丁寧に行う**（1本あたりの台本文字数が教育系より多く、音声実費が比例して増える）
+
+### 6-4 検証項目（`save_series_sheet` 前の自己検証）
+
+**致命（保存が拒否される）**:
+- [ ] ■■■■■ の区切りが整合している
+- [ ] 全ブロックに「タイトル・ねらい・扱う内容」の3見出しがある
+- [ ] `{{...}}` 相当の未置換プレースホルダが残っていない
+- [ ] 1件以上あり、**61件以上ではない**（設計上限60件。超えるならシリーズを分けることを提案する）
+
+**警告（保存はされる・`warnings[]` を読んで整える）**:
+- [ ] タイトルが30字以内 ／ ねらいが100字以上 ／ 扱う内容が箇条書きになっている
+
+**このカテゴリ固有**:
+- [ ] 各回のねらいに「取ってほしい行動」と「説得上の役割」が入っている
+- [ ] 扱う内容が文字起こしの実データに紐づいている（語られていない訴求を作っていない）
+- [ ] 同じ証拠・実績を複数回で使い回して水増ししていない
+- [ ] 誇大・虚偽・誤認を招く表現、根拠のない断定が無い（法令配慮）
+- [ ] 固有名（人名・社名・実在商品名）が地の文に出ていない（例示ラベル内のみ許可）
+
+### 6-5 この段のあと
+
+`T-024 add_videos(series_id, from: 'plan')` でプロジェクトを一括作成する。
+
+- 企画シートから**消えたプロジェクトは自動削除されない**。`orphans[]` として返るので、勝手に消さず人間に確認し、`T-027 manage_series(action:'remove_video')` の明示指示でのみ削除する（実費のかかった素材を表記ゆれで失わせないための設計）
+- 各プロジェクトの台本づくりは、この先 **§2 の STEP定義を1本ずつそのまま実行する**（カテゴリ別チェーン本体は v1 から変えていない）
+
+---
+
+## 7. 概要欄段（保存先 stage: `description`・v2）
+
+> **納品プロファイルが「投稿1本ぶん一式」のとき、概要欄は必須素材である。** サムネイル（`T-019 generate_thumbnail`）と概要欄が揃っていないと `T-015 export` が書き出しを**拒否する**（足りないものを名指しで返す。フォールバックで埋めない）。
+> 「連番ファイル一式」「動画のみ」では必須ではないが、作っておいて損はない。
+
+### 7-1 素になる出力
+
+⚠️ **本カテゴリの §2 STEP2（構成設計）は概要欄を出力しない**（§5 禁則4）。その禁則は**構成設計の出力に概要欄セクションを混ぜない**という意味であり、v2 で追加された概要欄段（`description`）とは別物である。
+
+- 納品プロファイルが **「連番ファイル一式」「動画のみ」** のとき: 本カテゴリに概要欄は不要。**この段を実行しない**
+- 納品プロファイルが **「投稿1本ぶん一式」** のとき: 概要欄は必須素材であるため、**この段で新規に作る**。素になるのは §2 STEP2 の出力（動画タイトル案・コンセプト・ターゲット・CTA・フェーズ構成）と STEP3 の台本であり、**STEP2 のシートには書き戻さない**（`structure` 段を汚さない）
+
+### 7-2 保存の手順
+
+1. 上記の出力から概要欄本文を取り出す（**新しく書き起こさない**。台本・構成と食い違う概要欄を作らないため）
+2. 固定パースフォーマット（区切り線・見出し・記号・項目構成）を**一字も変えずに**整える
+3. `T-004 save_sheet(project_id, stage: 'description', markdown)` で保存する
+4. 公開時の検索語（5〜10語）を本文末尾に `# タグ` 見出しで添える
+
+- **`structure` 段を書き換えない。** 各段は自分の stage にのみ書く（上流を破壊しない）
+- 概要欄は**書き出しの入力であって結合の入力ではない**ため、保存しても下流の素材は stale にならない（作り直しは起きない）
+- `《...》` / `{{...}}` の未置換が残っていたら致命として保存が拒否される
+
+### 7-3 固定パースフォーマット
+
+全カテゴリ共通の固定パースフォーマット。**区切り線・見出し・記号・項目構成は変更禁止**（システムがパースする）:
+
+```
+=====レッスン：《タイトル》=====
+【このレッスンの目的】
+【このレッスンで学ぶこと】
+【解説】
+▼小見出し1／▼小見出し2／▼小見出し3
+▼ポイント表
+▼比喩・例え話
+
+=====振り返り・理解度チェック=====
+【チェック1】理解度確認
+▼質問
+▼回答の目安
+【チェック2】自分ごと化
+▼問いかけ
+▼考えるヒント
+
+=====講座のまとめ=====
+【よくある疑問と回答】
+Q1／Q2／Q3
+【この講座で理解したこと】
+1／2／3
+【覚えておくべきキーワード】
+（表）
+```
+
+見出し語が「レッスン」なのは**パーサ仕様**であり、セールス動画でも変更しない。本カテゴリでは
+【この動画の目的】相当＝視聴後に取ってほしい行動、【解説】＝訴求内容（8観点のうち扱ったもの）、
+【チェック1】＝不安・反論への回答、【チェック2】＝自分の状況への当てはめ、【よくある疑問と回答】＝
+STEP1 で抽出した「⑤不安・反論とその解消」、として中身を埋める。
+
+### 7-4 検証項目
+
+- [ ] 区切り線（`=====`）・`【】`見出し・`▼`小見出しの**構成と記号を一切変えていない**
+- [ ] `《タイトル》` が実際のタイトルへ置換されている
+- [ ] 台本・構成と矛盾する内容を書いていない（概要欄で新しい主張を足さない）
+- [ ] タグが5〜10語あり、固有名を地の文に含めていない
+- [ ] 概要欄に、文字起こしに無い訴求・数字・実績を書いていない
+- [ ] 誇大・虚偽・誤認を招く表現、根拠のない断定が無い（法令配慮は概要欄にも及ぶ）
+- [ ] CTA が §2 STEP2 の「## 4. CTA」と一致している
+- [ ] 価格・特典の条件を省略していない（誤認の芽を作らない）