HyperFrames — 最初に読んでください
HyperFramesに関するすべてのタスクはここから始めてください — 特にプロジェクトエージェント設定(CLAUDE.md / AGENTS.md / .cursorrules)がない場合。以下に機能マップ+動画ルーターがあります。
機能マップ — どの意図にどのスキルか
| あなたがやりたいこと… | 行き先 |
|---|---|
| 動画を作成する(URL、概要、トピック、GitHub PR、既存の映像、またはアニメーションする単一要素から) | 下の動画ルーター(§ 動画ルーティング) |
HTMLコンポジションを作成・編集する — data-* コントラクト、クリップ、トラック、サブコンポジション、変数 | /hyperframes-core |
| アニメーション — アトミックモーションルール、シーンブループリント、トランジション、ランタイムアダプター(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
クリエイティブディレクション — design.md、パレット、タイポグラフィ、ナレーション、ビート計画、オーディオリアクティブ | /hyperframes-creative |
| メディア前処理 — TTS音声、BGM、文字起こし、背景除去、キャプション | /hyperframes-media |
| CLI開発ループ — init、lint、validate、inspect、preview、render、publish、doctor | /hyperframes-cli |
レジストリブロック/コンポーネントのインストール(hyperframes add) | /hyperframes-registry |
コンポジションの作成コントラクト(すべてのタイミング要素には
data-start/data-duration/data-track-indexが必要、タイミング要素にはclass="clip"が必要、GSAPタイムラインは一時停止しwindow.__timelinesに登録する、決定論的ロジックのみ —Date.now()/Math.random()/ ネットワークは禁止)はここには重複していません —/hyperframes-coreにあります。コンポジションHTMLを書く前にそれを読んでください。
HyperFramesができないこと — 最初に確認
HyperFramesはHTMLコンポジションを作成し、それをコードからMP4にレンダリングします。そのモデルには厳密な外縁があります。これらの境界を超えるリクエストはルーティングの選択ではなく、スコープ外です。そのため、ワークフローに進む代わりに断る(または適切なツールを指す)ようにしてください。これらはアーキテクチャに起因するもので、特定のリクエストによるものではありません。
- レンダリングは決定論的で自己完結的です。 すべての値、アセット、テキストは作成時に焼き付けられます。レンダリングはネットワーク呼び出しも、ライブ/レンダリング時のデータ取得もしません(基本ルール:
Date.now()/Math.random()/ ネットワークは禁止)。「レンダリング時にライブで数字を更新する」は範囲外 — 作成時にデータを一度取得して焼き付けるか、断ってください。 - 既存の動画はオーバーレイされ、編集はされません。 HyperFramesはソースクリップの上にフレームを合成します —
/embedded-captionsはキャプションレイヤーを追加し、/graphic-overlaysはデザインされたグラフィックカード(lower-thirds、データコールアウト、タイトル)を追加します — クリップはそのまま再生されますが、どちらもエンコードされたビデオストリームを後処理しません。映像そのもの(タイミング、色、フレーミング、順序、音声)を変更することはNLEスタイルの編集であり、範囲外です。 - Remotionのインポートは一方通行です。
/remotion-to-hyperframesは_Remotionフレームワークの_ソースをHyperFramesに翻訳します。逆方向(HyperFrames → Remotion、または他のフレームワーク → 範囲外)は存在せず、非RemotionのReact/Webアニメーションソースには翻訳するRemotionソースがありません —/general-videoで再作成してください。 - 持っていない入力を生成できません。 画面/セッション録画、カメラキャプチャ、AIトーキングヘッド/リップシンクアバター生成はできません。映像やアセットがまだ存在しない場合、HyperFramesはそれを呼び出すことはできません — ユーザーにそれを提供してもらうか(または適切なキャプチャツールを使ってください)最初に依頼してください。
それ以外 — URLからの動画、概要、トピック、PR、注釈を付ける映像、またはアニメーションする単一要素 — は範囲内です。以下でルーティングします。
動画ルーティング
このセクションはトップレベルのワークフローのみを認識します。ワークフロー内部のフェーズ、ドメインスキル(hyperframes-* — 上の機能マップを参照)、または技術リファレンスは読み込みません。
決定表
INPUTタイプ(意図)が主軸です。OUTPUTの長さは上限であり、ゲートではありません。 一致する入力に対して、専門ワークフローは最大約3分までを処理します — どのワークフローに入るかは長さではなく意図(入力タイプ、テキストの場合は主題)で決まります。長さが重要になるのは上限側だけです:真に長い作品(3〜5分のチュートリアル、5分以上の深掘り)は別のレジスターであり、/general-video にルーティングされます。約3分以内の帯域内では、3つ目の軸が2つのテキスト供給ワークフローを分割します — 主題:_マーケティング_されている製品 vs _説明_されているトピック(下記のステップ3の曖昧性解消ルールを参照)。
| 長さ / 入力 | 製品ローンチ(URL / 概要 / スクリプト) | 一般的なWebサイト / URL | GitHub PR / コード変更 | トピック / 記事 / メモ(製品なし、URLなし) | 既存動画(トーキングヘッド)† |
|---|---|---|---|---|---|
| 〜3分以内 | /product-launch-video | /website-to-video | /pr-to-video | /faceless-explainer | /embedded-captions · /graphic-overlays † |
| 3〜5分チュートリアル | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| 5分以上の深掘り | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| 静止画 / ループ | /general-video | /general-video | /general-video | /general-video | /general-video |
現在のカバレッジ:約3分以内の帯域には、製品ローンチ / 一般的なWebサイト / GitHub PR / トピック入力専用のワークフローがあります(URLは_種類_、次に_意図_で分割 — ステップ3を参照)。そして既存動画列は任意の長さでカバーされています — /embedded-captions(キャプション/字幕)または /graphic-overlays(デザインされたグラフィックオーバーレイ)で、意図で分割されます(ステップ2を参照)。他のすべてのセルは /general-video — 一般的なHTMLコンポジション作成フロー(入力と長さに依存しない):約3分より長いものすべて(3〜5分 / 5分以上の行)と、すべての静止画 / ループフォーマット。ルーターは作成可能な動画で行き止まりになりません。唯一の真の「一般/該当なし」の答えは、HyperFrames自体の範囲外のリクエストです(例:完成した動画ファイルのNLEスタイル編集 — 再タイミング、再色付け、再フレーミング、並び替え、音声)。
† 既存映像は長さではなく意図で分割。 キャプション/字幕 → /embedded-captions;デザインされたグラフィックオーバーレイ/パッケージング — lower-thirds、データコールアウト、タイトルカード、プルクォート → /graphic-overlays。どちらもクリップをオーバーレイし、クリップはそのまま再生されます。どちらも映像自体は編集しません。
ジャンルショートサーキット(表に先行)。 短い(〜10秒未満)、ナレーションなし、デザイン主導のモーショングラフィック — キネティックタイポ、統計/チャートヒット、ロゴスティング、lower-third/オーバーレイ、またはアニメーション化されたツイート/見出し/ページハイライト — は入力に関係なく /motion-graphics にルーティングされます。これはOUTPUTジャンルであり入力タイプではないため、依頼が明らかにモーション優先でナレーションなしの場合(ステップ2を参照)、上記の入力タイプの表よりも優先されます。長いまたはナレーションのある作品は入力タイプでルーティングされるか、/general-video になります。
既存のコンポジションの移行(特殊ケース)
上の表は入力から動画を作成するためのものです。1つのワークフローがその外側にあります:ユーザーが明示的に既存のRemotion(React)コンポジションをHyperFramesに移植/変換/移行することを依頼した場合 → /remotion-to-hyperframes。これはソース翻訳であり、入力からの作成ではありません。そのため、INPUT × LENGTHのセルはありません。明示的な移行の言葉(「Remotionプロジェクトを移植して」「このRemotionコンポを変換して」「これをHyperFramesとして書き直して」)がある場合のみここにルーティングします — Remotionに軽く触れただけではトリガーになりません。デフォルトは作成テーブルまたは /hyperframes-core です。
ルーティング手順
- INPUTタイプ + 目標長を特定する。 ルーティングは動画が何についてか — その主題と入力を知る必要があります。主題自体が未指定の場合(例:「私たちのものについて動画を作って」 — URL、名前付き製品、トピック、または作業可能なアセットがない)、または入力タイプが不明な場合は、ワークフローに入る前に質問する — まず明確にしてください。ワークフロースキルを呼び出してから質問しないでください。ワークフローにコミットすること自体がルーティングの決定だからです。最大2つの明確化質問をします:
- 「入力は何ですか — 製品(URLまたは概要)、一般的なWebサイト/URL、GitHub PR/コード変更、説明するトピックや記事、またはキャプションを付ける既存のトーキングヘッド動画ですか?」
- 「目標の長さは — 約3分以下、またはそれより長い(3〜5分のチュートリアル / 5分以上の深掘り)ですか?」
- スペックのデフォルト — 述べる、質問しない(これらはルートに影響しないため、ルーティングをブロックしないでください):アスペクト 16:9(エンジンは9:16縦長もサポート — ユーザーがTikTok/Reels/Shortsのような縦長の宛先を指定した場合のみ切り替える);ナレーション/キャプションの言語 = ユーザーの言語。ユーザーが反論してきた場合のみ確認する。選択されたワークフローはステップ0で独自の詳細を再確認します。
- まずINPUTタイプ(意図)で選択する。長さは上限であり、ゲートではありません。
- 短いデザイン主導のモーショングラフィック(ジャンルショートサーキット、入力テーブルに先行) — モーション自体がメッセージ:キネティックタイポ、統計/数字カウントアップ、チャートヒット、ロゴスティング、lower-third/オーバーレイ、またはアニメーション化されたツイート/見出し/ページハイライト。通常は〜10秒未満、ナレーション/音声なし →
/motion-graphics。これはOUTPUTジャンルであり入力タイプではありません — 依頼が明らかに短く、ナレーションなしのデザイン主導のモーションピースである場合、入力に関係なくここにルーティングします。同じ素材の長いまたはナレーションのある作品はこれではありません(入力タイプでルーティングするか、/general-video)。 - 既存のトーキングヘッド動画(ユーザーがクリップを持っていて、その上に何か追加したい場合) → 任意の長さで意図で分割(入力タイプが長さに優先):キャプション/字幕(話し言葉を読みやすいテキストとして) →
/embedded-captions;デザインされたグラフィックオーバーレイ — lower-thirds、データコールアウト、タイトル付き情報カード、プルクォート、グラフィックパッケージ編集 →/graphic-overlays。(映像_自体_の編集 — 再タイミング、色変更、フレーム変更、並び替え、音声 — はNLEスタイルであり範囲外。§ HyperFramesができないこと を参照) - GitHub PR / コード変更(
github.com/<owner>/<repo>/pull/<N>リンク、owner/repo#N参照、または「このPR」) →/pr-to-video(最大約3分)。 - それ以外(製品URL / 概要 / トピックテキスト):意図がステップ3を介してワークフローを選択し、それは最大約3分まで処理します — 短い15〜30秒のプロモーションと約100秒の解説動画の両方を、長さではなく意図でルーティングします。
/general-video(長さに依存しないフォールバック — ステップ4を参照)にルーティングするのは、目標が明らかに約3分より長い場合のみ(3〜5分のチュートリアル、5分以上の深掘り)。真に長い作品を決して約3分以内のワークフローに無理やり入れないでください — 意図は帯域内で決定し、/general-videoが残りをカバーします。
- 短いデザイン主導のモーショングラフィック(ジャンルショートサーキット、入力テーブルに先行) — モーション自体がメッセージ:キネティックタイポ、統計/数字カウントアップ、チャートヒット、ロゴスティング、lower-third/オーバーレイ、またはアニメーション化されたツイート/見出し/ページハイライト。通常は〜10秒未満、ナレーション/音声なし →
- 約3分以内のURL / テキスト入力の曖昧性を解消する(意図の分割)。 2つの分割があります:
- URLの種類 + 意図 — URLはもはや自動的にPLVに勝ちません。その_種類_、次に_意図_が決定します:GitHub PRリンク(
.../pull/<N>、owner/repo#N、「このPR」) →/pr-to-video;それ以外のWebサイトURLは意図で分割 — 特定の製品またはSaaSをマーケティング/ローンチ/プロモーション →/product-launch-video;一般的なサイト→動画(サイトツアー、ポートフォリオ/ブログ/ランディングページショーケース、サイトのビジュアルからのソーシャルクリップ、または単に「このサイトを動画にして」) →/website-to-video。両方ともヘッドレスChromeでクロールします。PR URLはghで読み取ります。サイトURLが製品ローンチか一般的なサイト動画か本当に不明な場合は、1つ質問します。 - 製品 vs トピック(テキスト、URLなし) — 決定的な質問は動画が何についてかであり、入力形式ではありません:
- マーケティング、ローンチ、またはプロモーションされている特定の製品/企業/SaaS/アプリ/Webサイト →
/product-launch-video。 - コンセプト/トピック/記事/仕組みを説明しているもので、製品もURLもなし →
/faceless-explainer。 - タイブレーカー:「プロモーション/ローンチ/販売/私たちの製品」という言葉 → PLV。「説明/教える/仕組み/何がXか」で製品なし → faceless。facelessの出荷スタイルは常に
pin-and-paper。 - URLが貼られていない名前付きサイトでもPLV。 製品やそのWebサイトに言及するスクリプト(「私たちのサイトはacme.ioです」「<ブランド>をプロモーションして」)は、クリック可能なリンクがなくてもPLVにルーティングされます — PLVはWeb検索してサイトをクロールし、ブランドアセットを取得できます(ユーザーがオプトアウトした場合を除く → キャプチャなしプリセットモード)。URLを貼らないことが、それをfaceless/キャプチャなしのジョブにするわけではありません。提供されたスクリプトに対する逐語的 vs 再構成の選択はPLVの内部であり、ルートを変更することはありません。
- 矛盾する手がかり → 推測せず質問する。 提供されたソースが製品の自社マーケティング(そのランディングページ、_自社プラットフォーム_に関するプロモーションブログ)であるにもかかわらず、ユーザーがプロモーションを排除するよう明示的に要求した場合 — 基礎となるコンセプトの_中立的な_解説、広告ではない — それは真に曖昧として扱います(動画は…
- マーケティング、ローンチ、またはプロモーションされている特定の製品/企業/SaaS/アプリ/Webサイト →
- URLの種類 + 意図 — URLはもはや自動的にPLVに勝ちません。その_種類_、次に_意図_が決定します:GitHub PRリンク(
- 残りすべて:長い作品(約3分超)+ 静止画/ループ →
/general-video。 長さによるゲートは一方通行です — 〜3分以内の専用ワークフローは短い作品向けに設計されており、長い作品をそれに入れると結果が悪くなります。約3分超(3〜5分チュートリアル、5分以上の深掘り)または静止画/ループ(単一画像、ロゴループ、無限再生するアニメーションバナー)はすべて/general-videoです。/motion-graphicsのモーショングラフィックは通常10秒未満でナレーションなしなので、ここでは考慮しません(長さゲートはモーショングラフィックには適用されません)。