参照動画のミラーリング
参照物の構造とビジュアル文法をコピーし、その内容は決してコピーしません。プロジェクトに関するすべては、発見または質問によって明らかにされ、決して推測されません。
0. まず発見する
プロジェクトの指示ファイル（CLAUDE.md、AGENTS.md、README、docs）を読みます。そこで定義されているものを記録します：デザインシステムとデフォルトルック、スキャフォールドコマンド、リント/レンダリングコマンド、音声ツールとそのコストルール、git-ignoredな生メディア用フォルダ、言語、フォーマット、長さ、CTA、公開ルール。見つからなかった各項目は質問リストに追加します。記憶、別プロジェクト、または「適切なデフォルト」から埋めることは決してしません。
ステップ
- 参照. リンクにログインが必要な場合は、ファイルを依頼します。ファイルとそのコンタクトシートは、プロジェクトが指定するgit-ignoredフォルダ（または質問して決める）にのみ保存します。長さ、サイズ、フレームレートを調べ、プロジェクトのツールでコンタクトシートを作成します。明示的な同意なしに参照をどこにもアップロードせず、言葉で説明します。
- ビートマップ.
beat-map.mdの表を埋めます：各ビートの時間、レイアウト、テキストパターン、モーション、役割。借用したものと借用していないもの（テキスト、ロゴ、映像、音楽、ハンドル、商品）をリストします。 - 決定ラウンド. ステップ0で答えられなかったことだけを質問します。1ラウンドあたり最大4問、必要なラウンド数だけ（ハーネスにaskツールがあればそれを使います）：再構成か再スタイリングか；新しい兄弟動画か既存の動画の置き換えか；フォーマット、長さ、言語、CTA（未定義の場合）；新しいスクリプトか既存のナレーションの再利用か。常に質問：「ルックのデザインコンセプトボードを作りますか？」 いいえ → プロジェクトのデフォルトルックを、プロジェクトが命名する名前で使用します。なければ質問します。はい → ステップ5bへ。
- スキャフォールド プロジェクトのコマンドで行うか、新しい動画の作り方を質問します。
- ブリーフとスクリプト. プロジェクトのファイルに：このバージョンが存在する理由、借用した文法、日付入りの決定事項、次に
beat-map.mdのナレーションとビート表。 5b. ボード. 実行を開始する前に、opendesign-inputs.mdのすべての入力を確認します。空の入力は質問であり、自分で埋めるギャップではありません。その後、そのファイルの実行ステップに従います。 - 承認. ユーザーがスクリプトの文言、ナレーション（可能な場合は音声ツールから読み取り専用で名前を確認）、プロジェクトのコストルールによるコスト見積もり、および5bを実行した場合はコンセプトの選択を承認するまで停止します。
- ナレーション. プロジェクトのツールで生成するか、既存のものを再利用します。ワードタイミングからビート時間を設定します。
- 画面クリップ. 各クリップをカード領域にクロップします。すべてのクロップでデータ漏洩（カウンター、メール、アカウント名、古いテキスト、ナレーションと矛盾するラベル）をスキャンし、結果を報告します。
- コンポーズ. プロジェクトのビデオフレームワークスキルまたはドキュメントを読み込み、プロジェクトのキットとデザインシステムから構築します。
- リントとチェック プロジェクトのコマンドで行います。警告を修正します。各ビートの中央のスナップショットを撮り、レイアウトのバグを修正します。
- レンダリングとレビュー フレームごとに（漏洩、タイプミス、セーフエリア、数値）確認します。オーディオがクリッピングしていないかチェックします。不良レンダリングはプロジェクトの指定場所に移動するか、質問します。絶対に削除しません。
- ハンドオーバー プロジェクトの完了定義に従います：ポストコピー（使用する場合）、合成音声や映像を使用した場合のAIコンテンツラベルのリマインダー、オープンな課題。公開はしません。
同じ動画の長いバージョン：フルナレーションを再利用し、ビートを追加し、ステップ5から繰り返します。
自身の完了済み動画の移植
「参照」が別プロジェクトの自身の完了済み動画である場合、それをターゲットプロジェクトにコピーして適応させます。プロジェクト間でのインポートは行いません。
- 最初にターゲットプロジェクトのファイルを読みます（ステップ0）。古いクロージングをターゲットのデフォルトアウトロまたはエンドカードに置き換えます。
- ブランド変更の一掃：ブランドライン、ハンドル、サムネイル、エンドカード、ポストコピー。古いブランドをgrepし、サムネイルを表示します。
- ナレーションとワードタイミングは変更せずそのままにします。引き継がれるゲート障害（例：長い無音）はタイムスタンプとともにQAレポートに記載します。トリミングするか受け入れるかの判断はユーザーに委ねます。
- ルックがターゲットにまだ存在しない場合、ターゲット自身の規則に従ってスターターテンプレートとデザインドキュメントを追加します。カタログエントリの追加や共有指示ファイルの編集は事前に質問します。
- ブリーフとポストコピーをターゲットのフォーマットに書き換えます。
レッドフラグ：停止して質問
| 考え | 現実 |
|---|---|
| 「前回のルックを使おう」 | プロジェクトのファイルがルックを指定するか、質問する |
| 「縦型、30秒、英語が普通」 | フォーマット、長さ、言語はプロジェクトまたはユーザーから |
| 「クレジットは小さいから、今すぐ生成」 | 承認ステップの前ではない |
| 「参照をアップロードする方が速い」 | 明示的な同意が必要 |
| 「ボードのギャップは自分で埋めよう」 | ギャップは質問である |
よくあるミス
- 絵文字が一行に単独で折り返される：最後の単語に結合する。
- カウントアップが開始前に「0」を表示する：カウントが始まるまで非表示にする。
- 薄いカード上のミュートテキストが読めない：カードのインク色を使用する。
- 接続詞（「または」）が二枚のカードに重なる：その間に小さなバッジとして配置する。
- 固定長の背景が動画の終了前に途切れる：全長に合わせてサイズ調整する。
- 録画されたUIラベルがナレーションと矛盾する（例：異なるナレーター名）：周囲の状態に合った無地のパッチで覆う。代替テキストをでっち上げない。
- 再利用されたナレーションが保持ゲートに失敗する：QAでタイムスタンプとともに報告する。静かにトリミングしない。
- 古いブランドがサムネイルやエンドカードに残っている：レンダリング前にgrepしてサムネイルを表示する。
- CLIがセッション中に解決に失敗する（例：アップデート後のnpx）：キャッシュされたバイナリを直接実行し、ハンドオーバーでその旨を伝える。