HyperFrames エントリポイント
HyperFrames は HTML から動画をレンダリングします。コンポジションは HTML ファイルであり、その DOM は data-* 属性を使用してタイミングを宣言し、アニメーションランタイムはシーク可能で、メディア再生はフレームワークが所有します。完全なオーサリングコントラクトは /hyperframes-core にあります。コンポジション HTML を作成する前にこれを読んでください。
1. プロジェクトの状態から開始する
最初に一致する行を適用します。下位の状態行は評価しないでください。
| 状態 | アクション |
|---|---|
| 既存の Remotion ソースを HyperFrames に明示的に移植 | references/routes/remotion-to-hyperframes.md を読み、そのワークフローに直接ルーティングします。インテントレイヤーはスキップします。 |
| 既存の HyperFrames プロジェクトに対する特定の操作：検査、診断、検証、プレビュー、レンダリング、公開、またはバッチレンダリング | その操作のみを実行します。インテントとワークフロールーティングはスキップします。/hyperframes-cli と必要なドメインスキルをロードします。 |
| 既存のプロジェクトへの特定の編集 | 編集を行います。インテントレイヤーは実行しないでください。 |
BRIEF.md が存在する | workflow と flow を読みます。そのワークフローを実行します。flow: companion は常に /general-video で実行されます。ブリーフに関する質問はしないでください。 |
ブリーフはないが、hyperframes.json または STORYBOARD.md が存在する | プロジェクトファイルと記録された設定から再開します。既存のアーティファクトから所有するワークフローを推測します。一意に決定できない場合は、ルーティングのみに関する質問を1つ行います。インテントインタビューは実行しないでください。 |
| 新規作成 | インテントレイヤー（references/intent-interview.md）を実行し、§2のテーブルを使用してルーティングします。 |
新規リクエストが主題または入力を特定しない場合は、ルーティングする前に動画の内容を尋ねてください。何かを尋ねる前に、設定とレシピを確認してください（references/intent-interview.md、ステップ1）。figma.com 入力または名前付きレシピはルーティングではなくインテークを変更します。インタビューの「直交入力を適応させる」セクションで両方を処理します。
プロジェクトの CLI を最新に保つ
スキャフォールドされたプロジェクトは、package.json スクリプトに hyperframes@<バージョン> をピン留めして、レンダリングの再現性を確保します。ピンは自動的に進みません。また、ピン留めされた古い CLI の実行では警告は表示されません。スクリプトにピンが含まれているプロジェクトを再開する場合、最初のレンダリング影響コマンドの前に1回プローブします。
npx hyperframes@latest upgrade --project . --check
プローブは読み取り専用で、最新リリースに対するピンを報告します。明示的な . を保持してください。古い CLI リリースでは、ベアの --project の後に別のフラグが続くと、そのフラグがディレクトリ値として消費されます。プロジェクトが遅れていると報告された場合、または CLI 出力にすでに表示されている場合（ピン留めされたスクリプトからの --json 結果における stderr 通知 This project pins hyperframes@… (latest …) または _meta.updateAvailable: true）、npx hyperframes@latest upgrade --project . で適用し、次に npx hyperframes check で検証します。チェックが成功すると、プロジェクトのコンポジションが新しいバージョンでも検証されることが確認されます（レンダリング出力が古いピンとフレーム同一であることではありません）。したがって、バンプが成功した場合は決して黙っていてはいけません。実行のサマリーで古いバージョンと新しいバージョンの名前を述べてください。まだコンポジションがないプロジェクトは検証不要です。チェックが失敗した場合は、package.json の変更を元に戻し、ピン留めされたバージョンを続行し、プロジェクトがどのバージョンに留まるか、その理由を報告してください。信号をユーザーに中継するのではなく、それに基づいて行動してください。バンプされたピンを未検証のままにしないでください。
2. 新規作成をルーティングする
最初に一致する行を使用します。リクエストされた デリバラブル に一致させます。単語やファイルタイプがたまたま言及されただけでは一致させません。
| 優先度 | リクエスト | ワークフロー |
|---|---|---|
| 1 | 既存の Remotion ソースを明示的に移植 | /remotion-to-hyperframes |
| 2 | プレゼンテーション、ピッチデッキ、またはナビゲーション可能なインタラクティブデッキを作成 | /slideshow |
| 3 | 既存のトーキングヘッド映像にプレーンなキャプションまたは字幕を追加（映像は変更しない） | /embedded-captions |
| 4 | 既存のトーキングヘッド、インタビュー、ポッドキャスト映像にデザインされたグラフィックオーバーレイを追加（映像は変更しない） | /talking-head-recut |
| 5 | 音楽トラックからビート同期動画を構築（ナレーションやWebサイトキャプチャなし） | /music-to-video |
| 6 | 明示的に短く、ナレーションなし、モーションファーストのユニットを作成（通常10秒未満） | /motion-graphics |
| 7 | GitHub プルリクエストまたはPR参照からのコード変更を説明 | /pr-to-video |
| 8 | URLまたはサイト固有の概要からWebサイト、プロダクトサイト、アプリ、または会社をマーケティングまたは紹介 | /product-launch-video |
| 9 | 製品やサイトのキャプチャなしで、発明されたビジュアルを使用してトピック、記事、メモを説明 | /faceless-explainer |
| 10 | その他のカスタム動画またはコンポジション | /general-video |
ルートを確定する前に、references/routes/<ワークフロー>.md を読んでください。ルートごとに1つの小さなファイルで、標準の入出力/トリガーコントラクト（遅延インストールされるワークフロースキルが存在する前に利用可能）とそのルートのインタビューエントリが含まれます。候補がそのコントラクトを満たさない場合は、一致を強制せずにルーティングを続けてください。一致したルートのファイルのみを読んでください。
一般的なあいまいさを解決する
- 短いアニメーションタイトル、ロゴスティング、スタッツヒット、チャートヒット、マップヒット、またはスタンドアロンのローワーサードは、ナレーションがなくモーションがメッセージである場合、
/motion-graphicsです。静的タイトルカード、ナレーション付きシーケンス、長いモンタージュ、またはカスタムループは/general-videoです。 - 明示的に短いモーショングラフィックは、ソース素材としてURL、ツイート、記事、スクリーンショットを使用する場合があります。「このサイトから動画を作成する」という一般的なリクエストは
/product-launch-videoです。 - キャプション付きの既存映像は
/embedded-captionsにルーティングされます。デザインされた情報カード付きの映像は/talking-head-recutにルーティングされます。映像の再タイミング、並べ替え、色変更、フレーム変更、またはリミックスはカスタム編集であり、/general-videoにフォールスルーします。 - 音楽ファイルは、そのビートグリッドが作品を駆動する場合にのみ
/music-to-videoを選択します。BGMとして使用される音楽は、主題一致ルートをオーバーライドしません。 - 「ストーリーボードが欲しい」は、ワークフローではなくレビュープロセスを変更します。他にルーティング信号がない場合は、
/general-videoを使用します。確認されたスケッチボード自体が要求されたデリバラブルである場合があります。レビューループがその停止ポイントを定義します。 - 特殊なナラティブワークフローは最大約3分までサポートし、30〜90秒で最も強力です。明らかに長い作品は
/general-videoにルーティングします。長さは、明示的な移植、デッキ、キャプション、オーバーレイ、または音楽駆動のデリバラブルを決してオーバーライドしません。
3. 一度ルーティングしたら、そのままにする
新規作成の場合、インテントレイヤー（references/intent-interview.md）は完全な会話を実行します（メモリ、トリアージ、ピッチラウンド、必須要件、実行形状、ハンドオフ）。そして BRIEF.md を書き込んで終了します。ブリーフはワークフローが読み取る唯一のルーティングアーティファクトです。その後はこのスキルやインタビューを再度開くことはありません。「ルートが必要としたもの」に関する後続の質問にはすべて BRIEF.md から答えてください。
4. ワークフローをインストールして開始する
選択したワークフローを読む前に、ワークフローとコアドメインスキルをインストールまたは更新します。
npx hyperframes skills update <ワークフロー名>
ベア名（/ なし）を使用してください。コマンドが失敗した場合は、エラーを表示します。メモリからワークフローを再構築しないでください。インストールに関するその他のすべて（コアとレイジーの分割、init が更新するもの、診断、CIオプトアウト、CLIなしのフォールバック）は references/skill-lifecycle.md にあります。
5. オンデマンドでドメインスキルをロードする
| 必要とするもの | スキル |
|---|---|
| コンポジション構造、タイミング属性、トラック、変数、決定論 | /hyperframes-core |
| モーションルール、シーンブループリント、トランジション、ランタイムアダプター | /hyperframes-animation |
シークセーフな GSAP、CSS、Anime.js、WAAPI、FLIP、パス、マスク、SVG、3D キーフレーム、または hyperframes keyframes 診断 | /hyperframes-keyframes |
| デザイン仕様、コンセプト、パレット、タイポグラフィ、ナレーション、ビート計画 | /hyperframes-creative |
| 画像、アイコン、ロゴ、オーディオ、キャプション、グレーディング、LUT、再利用可能なメディア | /media-use |
| ナレーションカーブ、オーディオエフェクトチェーン、またはトラック上の自動化エンベロープ | /hyperframes-audio |
| init、lint、check、スナップショット、比較、バッチレンダリング、Studio、レンダリング、公開、または診断 | /hyperframes-cli |
| レジストリブロックとコンポーネント | /hyperframes-registry |
| Figma アセット、トークン、コンポーネント、または再構築されたモーションとしてのストーリーボードフレーム | /figma |
写真メディアの見た目や動作に関する幅広いフィードバックも、ユーザーが「カラーグレーディング」や「エフェクト」と言わなくても /media-use にルーティングされます。暗い/平坦/退屈な映像を修正する、クリップをスタイライズする、顔を隠す、またはメディアリビールを改善するなどです。トリートメントを編集する前に ../media-use/references/media-treatments.md を読んでください。これにより、映像の処理方法が規定されますが、メディアを使用してよいかどうかは決めません。汎用的な LUT、CSSフィルター/オーバーレイ、または不透明度トゥイーンを既存の標準的なトリートメントプリミティブの代わりに使用しないでください。テキスト/レイアウト/モーションのみの編集は、それぞれの所有ドメインに残してください。
重要な写真メディアを含むビルド中は、最終品質パスに1つの根拠のあるメディアポリッシュスキャンを含めてください。適切なメディアを変更しないままにすることは有効な結果です。
ドメインスキルは、エンドツーエンドのデリバラブルの所有権を取得することはありません。アクティブなワークフローが必要とするものだけをロードしてください。