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-* — 上記の機能マップを参照)、または技術リファレンスを読み込むことはありません。
決定表
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;デザインされたグラフィックオーバーレイ / パッケージング — ローワーサード、データコールアウト、タイトルカード、プルクォート — → /graphic-overlays。どちらもクリップにオーバーレイし、クリップはそのまま再生されます;どちらも映像自体を編集しません。
ジャンルショートカット(表に優先します)。 短い(約10秒未満)、ナレーションなし、デザイン主導のモーショングラフィック — キネティックタイポグラフィ、統計/チャートのヒット、ロゴスティング、ローワーサード/オーバーレイ、またはアニメーション化されたツイート/見出し/キャプチャされたページのハイライト — は、入力に関係なく /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タイプ(意図)で選択します;長さは上限であり、ゲートではありません。
- 短いデザイン主導のモーショングラフィック(ジャンルショートカット、入力表に優先) — モーション自体がメッセージです:キネティックタイポグラフィ、統計/数字のカウントアップ、チャートのヒット、ロゴスティング、ローワーサード/オーバーレイ、またはアニメーション化されたツイート/見出し/キャプチャされたページのハイライト;通常は約10秒未満、ナレーション/音声なし →
/motion-graphics。これは入力タイプではなくOUTPUTジャンルです — リクエストが明らかに短く、ナレーションなしのデザイン主導のモーションピースである場合、入力に関係なくここにルーティングします。同じ素材のより長いまたはナレーション付きの処理はこれに該当しません(入力タイプ、または/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;それ以外のWebサイトURLは意図によって分割されます — 特定の製品やSaaSのマーケティング/ローンチ/プロモーション →/product-launch-video;一般的なサイト → 動画(サイトツアー、ポートフォリオ/ブログ/ランディングページのショーケース、サイト自身のビジュアルからのソーシャルクリップ、または単に「このサイトを動画に」) →/website-to-video。どちらもヘッドレスChromeでクロールします;PR URLは…
- URLの種類 + 意図 — URLはもはやPLV(製品ローンチ動画)に自動的にはなりません;その_種類_、次に_意図_が決定します:GitHub PRリンク(
… [翻訳のため省略]