general-video — 汎用構成オーサリング
ルートを確認してから構築すること。 これはカスタム構成オーサリングのためのフォールバックです。入力が明らかに専門ワークフローに適合する場合は、そちらを優先してください:マーケティング製品 →
/product-launch-video;一般的なサイト →/website-to-video;トピック解説 →/faceless-explainer;GitHub PR →/pr-to-video;既存フッテージ →/embedded-captions·/graphic-overlays;短いナレーションなしモーショングラフィック →/motion-graphics;Remotion移植 →/remotion-to-hyperframes。対象外: ライブ/レンダリング時データ、完成動画のNLEスタイル編集、またはHyperFramesがキャプチャできないフッテージの制作。不明な場合は、最初に/hyperframesを読んでください。
要求されたものを正確に構築すること。 タイトルカードはタイトルカードであって、タイトルカード+3つの追加シーン+アンビエント音楽+キャプションではありません。追加のシーンや要素が作品を真に向上させる場合は_提案_すること;黙って追加しないでください。小さな編集(色の修正、1つの長さの調整、1つの要素の追加)の場合は、計画ステップをスキップして直接構築に進んでください。
アプローチ
発見 — オープンエンドなリクエストのみ
漠然とした探索的なリクエスト(「ブランド用に何か作って」「かっこいいイントロ」)の場合 — 色を選ぶ前に意図を理解する:
- オーディエンス — 誰が見るのか? 開発者 / 役員 / 一般消費者?
- プラットフォーム — どこで再生されるのか? ソーシャル(15秒) / ウェブサイトヒーロー / 製品デモ / 社内?
- 優先順位 — 何が最も重要か? モーション品質 / コンテンツ正確性 / ブランド忠実度 / スピード?
- バリエーション — ベストな1案、または意味のある異なる2〜3案(異なるテンポ、エネルギー、構造 — 単なる色替えではない)?
具体的なリクエスト(「タイトルカードを追加して」「シーン3のタイミングを修正して」)の場合は、発見をスキップしてください。
ステップ 1 — デザインシステム → hyperframes-creative
まずビジュアルアイデンティティを確立します。プロジェクトにデザイン仕様がある場合はそれを読んでください(優先順位 frame.md → design.md → DESIGN.md;正確な色、フォント、制約をブランドの真実として扱います)。
仕様がない場合、色やフォントを選ぶ前に hyperframes-creative/references/house-style.md と hyperframes-creative/references/video-composition.md の両方を読まなければなりません。 house-style.md は「プロンプトを解釈し実際のコンテンツを生成する」オープナー、レイジーデフォルトリスト、レイヤーレシピを提供します; video-composition.md は「生成された」ものから「制作された」ものを区別するビデオメディアの密度/スケール/ フォアグラウンド詳細化(データバー、登録マーク、モノスペースメタデータ、「ユーザーが要求しなかった8〜10要素」)を提供します。片方だけを読むことは最も一般的なミスです — video-composition.md こそエージェントがスキップするものであり、平坦で中央揃えのウェブページ的な出力を防ぐものなのです。独自にパレットを考案してこれらをスキップしないでください; hyperframes-creative への移行はここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて名前付きスタイル/ムード → references/visual-styles.md、またはインタラクティブピッカー → references/design-picker.md も取得してください。仕様/スタイルはブランドを定義するものであり、構成ルールではありません。
アングルを見つける(曖昧な概要、仕様なし): 色を選ぶ前に、一文を書いてください — この名前/言葉/トピックは何を喚起し、どのような視覚的_世界_(メタファー、設定、楽器、モチーフ)がそれを表現するのか? 例:サイバーセキュリティツール → 金庫室の扉 / 境界線スキャン線 / ロックタンブラー;瞑想アプリ → 潮汐、呼吸、ゆっくりとした光のブルーム。被写体の_意味_を読み、単なる文字だけではないように;文字通りのリスタイルよりも具体的なアングルを選んでください。これは、拡張が正しくスキップされる単一シーン作品において、プロンプト拡張(ステップ2)の安価な代替であり、「デザインされたコンセプト」と「グラデーション上の汎用ロゴ」を分けるものです。
ステップ 2 — プロンプト拡張 → hyperframes-creative
複数シーン構成のすべてで実行します(単一シーン作品と些細な編集はスキップ)。リクエストをデザイン仕様+ハウススタイルに基づいて、下流の作業が同じように読める一貫した中間表現に落とし込みます。hyperframes-creative/references/prompt-expansion.md を参照してください。
ステップ 3 — 計画
HTMLを書く前に、高レベルで考えます:
- 何を — 視聴者体験:物語のアーク、キーモーメント、感情のビート。
- 構造 — いくつのコンポジションか、サブコンプかインラインか、どのトラックがビデオ/オーディオ/オーバーレイ/キャプションを運ぶか。モノリシック単一ファイル vs モジュラーサブコンプの判断については、
hyperframes-core/references/composition-patterns.md§ 2つのアーキテクチャ(経験則:3回以上のハードシーンカット、または再利用されるシーンがある場合はモジュラー化;短い単一シーン作品は1ファイルのまま)を参照してください。 - リズム — 実装前にパターンに名前を付ける(例:
fast-fast-SLOW-SHADER-hold);hyperframes-creative/references/beat-direction.mdを参照。 - タイミング — どのクリップが長さを決め、トランジションの位置、ペーシング。
- レイアウト — 最初にエンド状態を構築(下記参照)。
- アニメーション — その後、
hyperframes-animationを介してモーションを追加。
アニメーションの前にレイアウト
すべての要素を、最も可視性の高い瞬間に配置します — 完全に入場し、正しく配置され、まだ退場していない状態。最初に静的なHTML+CSSとして記述します。まだGSAPは使わないでください。
理由: 要素をアニメーション開始状態(画面外、スケール0、透明度0)に配置し、そこから着地すると_思う_場所にトゥイーンすると、実際のレイアウトを推測していることになり、重なりはレンダリングまで見えません。最初にエンド状態を構築すれば、モーションを追加する前にレイアウト問題を見つけて修正できます。
- 各シーンのヒーローフレームを特定 — 最も多くの要素が同時に表示される瞬間。それが構築するレイアウトです。
- そのフレームの静的CSSを記述。コンテンツコンテナは絶対オフセットではなくパディングでシーンを埋める必要があります:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* パディングがコンテンツを配置;あらゆるシーンサイズに対応 */
gap: 24px;
box-sizing: border-box;
}
コンテンツコンテナに position: absolute; top: Npx を決して使用しないでください — コンテンツがスペースより高い場合にあふれます。絶対配置は装飾要素のために予約してください。
⚠ 上記の
width/height: 100%は、すべての祖先が解決された高さを持つ場合のみ機能します。 ルートの<div data-composition-id>およびそれと.scene-contentの間のラッパーはサイズ指定が必要です(ルートにposition: relative; width: 1920px; height: 1080px—hyperframes-core→ 「Root must be sized」を参照)。これをスキップするとflexコンテナは約0に縮み、コンテンツは左上隅に積み重なり、最初のグリフは x=0 でクリップされます — その間lint/inspectは0問題と報告します。また、.scene-contentのパディングを常に保持してください(≥80px):それはタイトルセーフマージンです。これを単なるgapに置き換えないでください。
- エントランスを追加 — 画面外/不可視からCSS位置へ
gsap.from()でアニメーション(サブコンポジションではgsap.fromTo()を推奨、開始状態が明示的になるため;hyperframes-core/references/sub-compositions.mdを参照)。CSS位置がグラウンドトゥルースであり、トゥイーンはそこへの旅です。 - 退場はトランジションで処理 —
hyperframes-animation/transitions/のシーントランジションルールに従い、最終シーンのみが要素を退場アニメーションします;シーン間ではトランジション自体が退場です。
時間を超えた共有スペース: 要素Aが要素Bが同じエリアに入場する前に退場する場合、両方ともそれぞれのヒーローフレームに対して正しいCSS位置が必要です — タイムラインの順序付けにより共存を防ぎ、レイアウトステップが偶発的な重なりをキャッチします。レイヤー化されたグロー/シャドウとzスタック深度は_意図的な_重なりです;このステップは_意図しない_衝突(2つの見出しが重なる、コンテンツがフレームからはみ出す)をキャッチするためのものです。
構築 — ドメインスキルに委譲
これはスキルの全表面(description を参照)をそのリファレンスにマッピングします — 網羅的ではありません;意図がリストにない場合、hyperframes-creative(見た目/コンセプト)、hyperframes-animation(モーション)、hyperframes-core(契約)、hyperframes-media(オーディオ/キャプション)を経由してください。最初の行は追加です — それと以下の意図行の両方を読み、どちらか一方ではありません。
| 構築対象… | 最初に読むもの(順序通り) |
|---|---|
| 常に — すべての非自明な作品において、以下の意図行に加えて | hyperframes-creative/references/house-style.md + references/video-composition.md(ステップ1 / HARD-GATEでもゲート;「生成されたものではなく、制作された」フォアグラウンド詳細化) |
| キネティックタイポグラフィ / テキスト主体 | hyperframes-animation/techniques.md(キネティックタイプ) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| タイトルカード / ローワーサード / オーバーレイ / PiP / テキスト背景 | hyperframes-creative/references/composition-patterns.md +(中央揃え/サイズ指定フレーム用)hyperframes-core → 「Root must be sized」 |
| ロゴ / ブランドマークリビール | hyperframes-animation/rules/svg-path-draw.md(描画オン) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| データ / 統計 / 数値 | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| 製品 / アプリ / UIデモ | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| オーディオリアクティブ / 音楽駆動 | hyperframes-creative/references/audio-reactive.md(事前バンド抽出;モーションにマッピング) |
| ナレーション / ボイスオーバー / キャプション / 字幕 | hyperframes-media(tts、transcribe、キャプションオーサリング) → hyperframes-core 経由でアセット配置 |
| 複数シーン / トランジション | hyperframes-animation/transitions/overview.md 次に transitions/catalog.md(概要だけでは完了しません — GSAPレシピはカタログにあります) |
| モジュラー / サブコンポジション | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
出力チェックリスト → hyperframes-cli
-
npx hyperframes lintとnpx hyperframes validateがパスする(結果をブロック) - 仕様(
frame.md/design.md)が存在する場合、デザイン準拠を確認 — チェックリストはhyperframes-creative/references/design-adherence.md -
npx hyperframes inspectがパスする、またはすべてのオーバーフローが意図的にマークされている - コントラスト警告に対処;複数シーン作品の場合はアニメーションマップをレビュー(
hyperframes-animation/scripts/animation-map.mjs) - プレビューを提供;MP4へのレンダリングは明示的なリクエストがあった場合のみ
- プレビューはハンドオフ時のみ表示(安定した最終プレビューです);構築途中に表示しない — 構築フェーズのスナップショットはヘッドレス
このワークフローではないもの
- 特定の製品 / 会社 / SaaS / ウェブサイトをマーケティング、ローンチ、プロモーションする場合 →
/product-launch-video - コンセプト / トピック / 記事 / 仕組みの解説、製品なし →
/faceless-explainer - GitHub PR / コード変更 →
/pr-to-video - 既存のトーキングヘッド動画にキャプションを追加する場合 →
/embedded-captions - 既存のRemotion構成を移植する場合 →
/remotion-to-hyperframes - 完成動画ファイルをNLEのようにカット/編集する場合 → 対象外(HyperFramesはHTMLとメディアを決定論的タイムラインに合成します;フッテージを編集しません)