hyperframes

HyperFrames エントリポイント

HyperFrames は HTML からビデオをレンダリングします。コンポジションは、data-* 属性で DOM のタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生がフレームワークによって所有される 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 のテーブルを使用して一度ルーティングします。

新しいリクエストが主題や入力を特定しない場合は、ルーティングする前にビデオが何に関するものかを尋ねます。何かを尋ねる前に、設定とレシピを確認してください (references/intent-interview.md、ステップ1)。figma.com 入力または名前付きレシピはインテークを変更しますが、ルーティングは変更しません。インタビューの「直交入力を適応する」セクションが両方を処理します。

プロジェクトの CLI を最新に保つ

スキャフォールディングされたプロジェクトは、package.json のスクリプトに hyperframes@<version> をピン留めして、レンダリングが再現可能になるようにします。ピンは自動的に更新されることはなく、古い CLI のピン留めされた実行はそれに関する警告を表示しません。スクリプトにピンが含まれているプロジェクトを再開する場合、最初のレンダリング影響コマンドの前に一度プローブします。

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	PR リファレンスから GitHub プルリクエストまたはコード変更を説明する	/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 を選択します。背景音楽として使用される音楽は、主題に一致したルートをオーバーライドしません。
• 「ストーリーボードが欲しい」は、ワークフローではなくレビュープロセスを変更します。他のルーティングシグナルがない場合は /general-video を使用します。確認されたスケッチされたボード自体が要求された成果物である場合があります。レビューループがその停止点を定義します。
• 特殊なナラティブワークフローは最大約3分までサポートし、30〜90秒で最も強力です。明らかに長い作品は /general-video にルーティングします。長さは、明示的な移植、デッキ、キャプション、オーバーレイ、または音楽駆動の成果物を決してオーバーライドしません。

3. 一度ルーティングしたら、その後は変更しない

新規作成の場合、インテントレイヤー (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
ボイスオーバーカーブ、オーディオエフェクトチェーン、またはトラック上のオートメーションエンベロープ	/hyperframes-audio
Init、lint、check、スナップショット、比較、バッチレンダリング、Studio、レンダリング、公開、または診断	/hyperframes-cli
レジストリブロックとコンポーネント	/hyperframes-registry
Figma アセット、トークン、コンポーネント、または再構築されたモーションとしてのストーリーボードフレーム	/figma

クリエイター編集フレーズはクロスドメインリクエストです。一致する行にリストされているすべてのスキルをロードします。

クリエイターリクエスト	必要なドメイン
「この映像をカットする」、ハードカット、トリム、スプライス、並べ替え、またはソース範囲を使用する	/general-video + /hyperframes-core; core は data-start、data-duration、data-media-start、およびトラックレイアウトを所有します。
ここをズームイン、パンチイン/パンチアウト、スムーズなマルチステートズームまたはリフレーム、ケンブリッジ効果、またはカメラムーブ	/general-video + /hyperframes-core + /hyperframes-keyframes; タイムドクリップではなく、内側のビジュアル/クロップラッパーをアニメーション化します。
マッチカットまたはウィップパンカメラトランジション	/general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry; 手動で作成する前にトランジションプリミティブを検索/インストールします。
フェード、クロスフェード、トラックゲイン/ボリューム、オートメーション、ダック/カーブ、またはオーディオエフェクト	/general-video + /hyperframes-core + /hyperframes-audio; core はクリップを配置し、audio は配置されたトラックをミックスします。
カットとカメラモーションまたはミキシングを組み合わせたピクチャーアンドサウンド編集	/general-video + /hyperframes-core + ビジュアルモーションがある場合は /hyperframes-keyframes + サウンドがフェード、ミックス、ダック、自動化、または処理されている場合は /hyperframes-audio。
メディアをソースまたは生成する、またはサポートされていないスピードランプ/ミッドソースフリーズを前処理する	/media-use; ソーシング/生成/前処理のみ。配置されたトラックのミックスは行いません。

定数 data-playback-rate は、ピクチャーとピッチ保存されたサウンドに対してレンダリングセーフです。ソーススピードランプをキーフレーム可能にはしません。ランプは前処理してください。 コピー可能な編集契約については、/hyperframes-core → references/creator-editing-recipes.md をロードしてください。

写真メディアの見た目や動作に関する広範なフィードバックも、ユーザーが「カラーグレーディング」や「エフェクト」と言わない場合でも、/media-use にルーティングされます。

...

[翻訳のため一部省略]