HyperFrames エントリーポイント は何をしますか？
HyperFrames は HTML からビデオをレンダリングします — コンポジションは、data-* 属性でタイミングを宣言する HTML ファイルであり、アニメーションランタイムはシーク可能で、メディア再生はフレームワークが管理します。完全なオーサリング契約は /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 のテーブルを使用して 1 回ルーティングする。 |
新規リクエストが対象や入力を特定しない場合、ルーティングする前にビデオの内容を質問してください。何か質問する前に、設定とレシピを確認してください (references/intent-interview.md、手順 1)。figma.com の入力や名前付きレシピは、ルーティングではなく受け入れ方法を変更します — インタビューの「異種入力の適応」セクションが両方を処理します。
プロジェクトの CLI を最新に保つ
スキャフォールドされたプロジェクトは、package.json スクリプトに hyperframes@<version> をピン留めして、レンダリングの再現性を確保します。ピンは自動的に更新されることはありません。古い CLI のピン留めされた実行は、それに関する警告を出力しません。ピンが設定されたスクリプトを持つプロジェクトを再開する場合、最初のレンダリング影響コマンドの前に 1 回プローブします。
npx hyperframes@latest upgrade --project . --check
プローブは読み取り専用で、最新リリースに対するピンの状態を報告します。明示的に . を指定してください — 古い CLI リリースでは、--project の後に別のフラグがあると、そのフラグがディレクトリ値として消費されます。プロジェクトが遅れていると報告された場合、または CLI の出力がすでにそのことを示している場合 (stderr 通知「This project pins hyperframes@… (latest …)」や、ピン留めされたスクリプトからの --json 結果の _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 | 音楽トラックからビート同期ビデオを作成する（ナレーションやウェブサイトキャプチャなし） | /music-to-video |
| 6 | 明示的に短く、ナレーションなしでモーション中心のユニットを作成する（通常 10 秒未満） | /motion-graphics |
| 7 | GitHub プルリクエストまたはコード変更を PR 参照から説明する | /pr-to-video |
| 8 | URL またはサイト固有のブリーフから、ウェブサイト、製品サイト、アプリ、または企業をマーケティングまたは紹介する | /product-launch-video |
| 9 | 発明されたビジュアルを使用してトピック、記事、またはメモを説明する（製品やサイトのキャプチャなし） | /faceless-explainer |
| 10 | その他のカスタムビデオまたはコンポジション | /general-video |
ルートを確定する前に、references/routes/<workflow>.md を読んでください — ルートごとに 1 つの小さなファイルです。これには、標準の入力/出力/トリガー契約（遅延インストールされるワークフロースキルが存在する前に利用可能）と、そのルートのインタビューのエントリが含まれています。候補がその契約を満たさない場合は、強制的に一致させるのではなく、ルーティングを続行してください。一致したルートのファイルのみを読んでください。
よくある曖昧さを解決する
- 短いアニメーションタイトル、ロゴスティング、統計ヒット、チャートヒット、マップヒット、またはスタンドアロンの lower-third は、ナレーションがなくモーションがメッセージである場合は
/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. 1 回ルーティングしたら、あとは任せる
新規作成の場合、インテント層 (references/intent-interview.md) が完全な会話を実行します — メモリ、トリアージ、ピッチラウンド、必須条件、実行形状、引き継ぎ — そして BRIEF.md を書き込んで終了します。ブリーフはワークフローが読み取る唯一のルーティング成果物です。後でこのスキルやインタビューを再度開くことはありません。その後の「ルートは何を要求したか？」という質問にはすべて BRIEF.md から答えてください。
4. ワークフローをインストールして入る
選択したワークフローを読む前に、ワークフローとコアドメインスキルをインストールまたは更新します。
npx hyperframes skills update <workflow-name>
/ なしのベアネームを使用してください。コマンドが失敗した場合は、エラーを表示してください。メモリからワークフローを再構築しないでください。インストールに関するその他のすべて — コアと遅延の分割、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 |
| Init、lint、check、スナップショット、比較、バッチレンダリング、Studio、レンダリング、公開、または診断 | /hyperframes-cli |
| レジストリブロックとコンポーネント | /hyperframes-registry |
| 復元されたモーションとしての Figma アセット、トークン、コンポーネント、またはストーリーボードフレーム | /figma |
写真メディアの見た目や動作に関する広範なフィードバックも、ユーザーが「カラーグレーディング」や「エフェクト」と言わなくても、/media-use にルーティングされます。暗い/平坦/退屈な映像を修正する、クリップにスタイルを適用する、顔を隠す、またはメディアリビールを改善するなどです。トリートメントを編集する前に ../media-use/references/media-treatments.md を読んでください。これは映像の扱い方を規定するものであり、メディアを使用してよいかどうかを規定するものではありません。既存の標準的なトリートメントプリミティブを、汎用的な LUT、CSS フィルター/オーバーレイ、または不透明度トゥイーンで代用しないでください。テキスト/レイアウト/モーションのみの編集は、それぞれのドメインに留めておいてください。
重要な写真メディアを含むビルド中は、最終品質パスに 1 回の根拠のあるメディアポリッシュスキャンを含めてください。適切なメディアを変更しないままにするのは有効な結果です。
ドメインスキルは、エンドツーエンドの成果物の所有権を取得することはありません。アクティブなワークフローが必要とするものだけをロードしてください。