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はデザインされたグラフィックカード(ローワーサード、データコールアウト、タイトル)を追加します — クリップはそのまま下で再生されますが、エンコードされたビデオストリームを後処理することはありません。映像自体(タイミング、色、フレーミング、順序、オーディオ)を変更することはNLEスタイルの編集であり、スコープ外です。 - Remotionのインポートは一方向です。
/remotion-to-hyperframesは_Remotionフレームワーク_のソースをHyperFramesに変換します。逆方向(HyperFrames → Remotion、または他のフレームワークへ)はありません(スコープ外)。また、非RemotionのReact/Webアニメーションソースには変換すべきRemotionソースがありません —/general-videoで再作成してください。 - 持っていない入力は生成できません。 画面/セッション録画、カメラキャプチャ、AIトーキングヘッド/リップシンクアバター生成はできません。映像やアセットがまだ存在しない場合、HyperFramesはそれを生成できません — ユーザーに提供を依頼するか(または適切なキャプチャツールを使用して)ください。
それ以外 — URL、概要、トピック、PR、注釈付き映像、またはアニメーション化する単一要素からの動画 — はすべてスコープ内です。以下でルーティングしてください。
動画ルーティング
このセクションは最上位のワークフローのみを認識します。ワークフロー内部のフェーズ、ドメインスキル(hyperframes-* — 上記の機能マップ参照)、または技術リファレンスは読み込みません。
決定表
入力タイプ(意図)が主軸です。出力長さは上限であり、ゲートではありません。 一致する入力に対して、特化ワークフローは 約3分まで を処理します — どのワークフローに入るかは、意図(入力タイプ、テキストの場合は主題)によって決まり、長さではありません。長さが意味を持つのは上限のみです: 本当に長い作品(3〜5分のチュートリアル、5分以上の深掘り)は別のレジスタであり、/general-video にルーティングされます。約3分以内の帯域内では、3番目の軸が2つのテキスト駆動ワークフローを分割します — 主題: マーケティング対象の製品 対 説明対象のトピック(下記ステップ3の曖昧性解消ルール参照)。
| 長さ / 入力 | 製品ローンチ(URL / 概要 / スクリプト) | 一般ウェブサイト / 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分以内の帯域には、製品ローンチ / 一般ウェブサイト / GitHub PR / トピック 入力向けの専用ワークフローがあります(URLは_種類_で分割され、次に_意図_で分割 — ステップ3参照)。また、既存動画列は任意の長さでカバーされています — /embedded-captions(キャプション/字幕)または /graphic-overlays(デザインされたグラフィックオーバーレイ)により、意図で分割されます(ステップ2参照)。他のすべてのセルは /general-video — 汎用HTMLコンポジションオーサリングフロー(入力・長さ非依存): 約3分を超えるすべて(3〜5分 / 5分以上の行)およびすべての静止画 / ループ形式。ルーターは作成可能な動画で行き止まりになることはありません。唯一の本当の「一般/該当なし」の回答は、HyperFrames自体の範囲外のリクエスト(例: 完成動画ファイルのNLEスタイル編集 — 再タイミング、再着色、再フレーミング、並べ替え、オーディオ編集)です。
† 既存映像は意図で分割され、長さでは分割されません。 キャプション/字幕 → /embedded-captions; デザインされたグラフィックオーバーレイ/パッケージング — ローワーサード、データコールアウト、タイトルカード、プルクオート → /graphic-overlays。どちらもクリップにオーバーレイし、クリップはそのまま下で再生されます。どちらも映像自体を編集しません。
ジャンルショートカット(表に優先)。短い(約10秒未満)、ナレーションなし、デザイン主導のモーショングラフィック — キネティックタイポグラフィ、統計/チャートヒット、ロゴスティング、ローワーサード/オーバーレイ、またはアニメーション化されたツイート/見出し/キャプチャページハイライト — は入力に関係なく /motion-graphics にルーティングされます。これは出力ジャンルであり、入力タイプではないため、依頼が明らかにモーション優先でナレーションがない場合(ステップ2参照)、上記の入力タイプ表よりも優先されます。長い、またはナレーション付きの処理は入力タイプでルーティングされるか、/general-video になります。
既存コンポジションの移行(特殊ケース)
上記の表は入力から動画を作成するためのものです。これとは別に1つのワークフローがあります: ユーザーが明示的に既存の Remotion (React) コンポジション をHyperFramesに移植/変換/移行するよう依頼した場合 → /remotion-to-hyperframes。これはソース変換であり、入力からの作成ではないため、入力×長さのセルはありません。明示的な移行言語(「Remotionプロジェクトを移植して」「このRemotionコンポを変換して」「これをHyperFramesに書き直して」)がある場合のみここにルーティングしてください — Remotionへの軽い言及はトリガーではありません。デフォルトでは作成表または /hyperframes-core にルーティングします。
ルーティング手順
- 入力タイプ + 目標長さを決定します。 ルーティングでは動画が何についてか — その主題と入力を知る必要があります。主題自体が未指定の場合(例: URL、名前付き製品、トピック、または作業対象アセットなしで「私たちのものについて動画を作って」)、または入力タイプが不明な場合は、どのワークフローに入る前に質問してください — まず明確にし、ワークフロースキルを呼び出してから質問しないでください。ワークフローにコミットすること自体がルーティングの決定だからです。最大2つの明確化質問をしてください:
- 「入力は何ですか? — 製品(URLまたは概要)、一般ウェブサイト/URL、GitHub PR/コード変更、説明するトピックや記事、またはキャプションを追加する既存のトーキングヘッド動画?」
- 「目標の長さは? — 約3分以下、またはそれ以上(3〜5分のチュートリアル / 5分以上の深掘り)?」
- 仕様のデフォルト — 述べる、質問しない(これらはルートに影響しないため、ルーティングをブロックしないでください): アスペクト比 16:9(エンジンは9:16縦長もサポート — ユーザーがTikTok/Reels/Shortsなどの縦長配信先を指定した場合のみ切り替え)、ナレーション/キャプション言語 = ユーザーの言語。ユーザーが異議を唱えた場合のみ確認してください。選択されたワークフローはステップ0で独自の詳細を再確認します。
- 最初に入力タイプ(意図)で選択します。長さは上限であり、ゲートではありません。
- 短いデザイン主導のモーショングラフィック(ジャンルショートカット、入力表に優先) — モーション自体がメッセージ: キネティックタイポグラフィ、統計/数字カウントアップ、チャートヒット、ロゴスティング、ローワーサード/オーバーレイ、またはアニメーション化されたツイート/見出し/キャプチャページハイライト。通常約10秒未満、ナレーション/音声なし →
/motion-graphics。これは出力ジャンルであり、入力タイプではない — 依頼が明らかにクイックでナレーションなしのデザイン主導モーションピースである場合、入力に関係なくここにルーティングします。同じ素材のより長い、またはナレーション付きの処理はこれではありません(入力タイプでルーティングするか、/general-video)。 - 既存のトーキングヘッド動画(ユーザーがクリップを持っており、それに何かを追加したい) → 意図で分割、任意の長さ(入力タイプが長さに勝つ): キャプション/字幕(話し言葉を読みやすいテキストとして) →
/embedded-captions; デザインされたグラフィックオーバーレイ — ローワーサード、データコールアウト、タイトル情報カード、プルクオート、グラフィックパッケージ編集 →/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秒の説明動画はどちらも意図でルーティングされ、長さではルーティングされません。目標が明らかに約3分より長い場合(3〜5分のチュートリアル、5分以上の深掘り)のみ
/general-video(長さ非依存のフォールバック — ステップ4参照)にルーティングします。本当に長い作品を強制的に約3分以内のワークフローに入れないでください — 意図が帯域内で決定し、/general-videoが残りをカバーします。
- 短いデザイン主導のモーショングラフィック(ジャンルショートカット、入力表に優先) — モーション自体がメッセージ: キネティックタイポグラフィ、統計/数字カウントアップ、チャートヒット、ロゴスティング、ローワーサード/オーバーレイ、またはアニメーション化されたツイート/見出し/キャプチャページハイライト。通常約10秒未満、ナレーション/音声なし →
- 約3分以内のURL / テキスト入力の曖昧性を解消します(意図分割)。 2つの分割:
- URLの種類 + 意図 — URLはもはや自動的にPLVになりません。_種類_が最初に決定し、次に_意図_が決定します: GitHub PR リンク(
.../pull/<N>、owner/repo#N、「このPR」) →/pr-to-video; それ以外のウェブサイトURLは意図で分割 — 特定の製品やSaaSのマーケティング/ローンチ/プロモーション →/product-launch-video; 一般サイト → 動画(サイトツアー、ポートフォリオ/ブログ/ランディングページのショーケース、サイトのビジュアルからのソーシャルクリップ、または単に「このサイトを動画にしたい」) →/website-to-video。両方ともヘッドレスChromeでクロールします。PR URLはghで読み取ります。サイトURLが製品ローンチか一般サイト動画かが本当に不明確な場合、1つの質問をしてください。 - 製品 vs トピック(テキスト、URLなし) — 決定的な質問は動画が何についてかであり、入力形式ではありません:
- 特定の製品/企業/SaaS/アプリ/ウェブサイトがマーケティング、ローンチ、またはプロモーションされている →
/product-launch-video。 - コンセプト/トピック/記事/仕組みが説明されており、製品もURLもない →
/faceless-explainer。 - タイブレーカー: 「プロモート/ローンチ/販売/私たちの製品」という表現 → PLV。「説明/教える/どう動くか / Xとは何か」で製品なし → faceless。facelessの出荷スタイルは常に
pin-and-paper。 - URLが貼られていなくても、名前付きサイトはPLVです。 製品やそのウェブサイトに言及するスクリプト(「私たちのサイトはacme.ioです」「<ブランド>をプロモートして」)は、クリック可能なリンクがなくてもPLVにルーティングされます — PLVはサイトをウェブ検索し、ブランドアセットをクロールできます(ユーザーがオプトアウトしない限り → キャプチャなしプリセットモード)。URLを貼らなかったからといって、それがfaceless/キャプチャなしの仕事になるわけではありません。提供されたスクリプトに対する逐語対再構成の選択はPLV内部のものであり、ルートを変更することはありません。
- 矛盾する手がかり → 推測せず質問してください。 提供されたソースが製品の自社マーケティング(そのランディングページ、_自社プラットフォーム_に関するプロモーションブログ)であるにもかかわらず、ユーザーが明示的にプロモーションを削除するよう依頼した場合 — 基礎にあるコンセプトの_中立的な_説明であり、広告ではない — それを本当に曖昧として扱います(動画は…
- 特定の製品/企業/SaaS/アプリ/ウェブサイトがマーケティング、ローンチ、またはプロモーションされている →
- URLの種類 + 意図 — URLはもはや自動的にPLVになりません。_種類_が最初に決定し、次に_意図_が決定します: GitHub PR リンク(