汎用動画 — 汎用動画ワークフロー
構築する前にルートを確認してください。 これはカスタムコンポジション作成のためのフォールバックです。入力が専用ワークフローに明らかに適合する場合は、そちらを優先してください。トピック解説→
/faceless-explainer、GitHub PR→/pr-to-video、既存映像→/embedded-captions·/talking-head-recut、短いナレーションなしモーショングラフィック→/motion-graphics。対象外: ライブ/レンダリング時のデータ、完成動画のNLE編集、HyperFramesでキャプチャできない映像の生成。不明な場合は、まず/hyperframesを読んでください。
要求されたものだけを正確に構築してください。 タイトルカードはタイトルカードであり、タイトルカード+3つの補助シーン+キャプションではありません。追加のシーンや要素が作品を真に向上させる場合は、それを_提案_してください。黙って追加してはいけません。小さな編集(色の修正、1つの長さの調整、1つの要素の追加)の場合は、計画ステップをスキップして直接構築に進んでください。
アプローチ
発見 — 自由形式のリクエストのみ
漠然とした探索的なリクエスト(「弊社ブランド向けに何か作って」「クールなイントロを」)の場合 — 色を選ぶ前に意図を理解してください。
- オーディエンス — 誰が見るのか? 開発者/経営幹部/一般消費者?
- プラットフォーム — どこで再生されるのか? ソーシャル(15秒)/Webサイトヒーロー/製品デモ/社内?
- 優先順位 — 何が最も重要か? モーション品質/コンテンツ正確性/ブランド忠実度/速度?
- バリエーション — 最良の1つ、または2〜3の意味のある異なるオプション(単なる色変更ではなく、異なるペース、エネルギー、構造)?
具体的なリクエスト(「タイトルカードを追加」「シーン3のタイミングを修正」)の場合は、発見をスキップしてください。
ステップ 1 — デザインシステム → hyperframes-design
最初に視覚的アイデンティティを確立します。プロジェクトにデザイン仕様がある場合は、それを読んでください(優先順位 frame.md → design.md → DESIGN.md;正確な色、フォント、制約をブランドの真実として扱います)。
仕様がない場合は、色やフォントを選ぶ前に、必ずhyperframes-design/references/house-style.mdとhyperframes-design/references/video-composition.mdの両方を読まなければなりません。 house-style.mdは「プロンプトの解釈/実際のコンテンツ生成」の開始部分、レイジーデフォルトリスト、レイヤーレシピを提供します。video-composition.mdは、「制作された」ものと「生成された」ものを区別する、動画メディアの密度/スケール/フォアグラウンド詳細(データバー、レジストレーションマーク、等幅メタデータ、「ユーザーが要求していない要素が8〜10個」)を提供します。片方だけを読むのが最も一般的なミスです — エージェントが見逃すのはvideo-composition.mdの方であり、まさにそれが平坦で中央揃えのWebページ的な出力を防ぐものです。自分でパレットを発明してこれらをスキップしないでください。hyperframes-designへの移行はここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて名前付きスタイル/ムード → references/visual-styles.mdも取得します。仕様/スタイルはブランドを定義するものであり、コンポジションルールを定義するものではありません。
アングルを見つける(曖昧な指示、仕様なし): 色を選ぶ前に、1文を書いてください — この名前/言葉/トピックは何を想起させ、どのような視覚的な_世界_(メタファー、設定、楽器、モチーフ)がそれを表現するか? 例:サイバーセキュリティツール → 金庫の扉/境界スキャンライン/ロックタンブラー;瞑想アプリ → 潮の満ち引き、呼吸、ゆっくりとした光の広がり。被写体の_意味_を読み取ってください。文字通りの再スタイルではなく、具体的なアングルを選んでください。これは、シングルシーン作品(拡張が正しくスキップされる)に対するプロンプト拡張(ステップ2)の安価な代替手段であり、設計されたコンセプトと、グラデーション上の一般的なロゴとの違いです。
ステップ 2 — プロンプト拡張 → hyperframes-design
すべてのマルチシーンコンポジションで実行します(シングルシーン作品と些細な編集ではスキップ)。リクエストをデザイン仕様+ハウススタイルに基づいて、ダウンストリーム作業が同じように読み取る一貫した中間表現に落とし込みます。hyperframes-design/references/prompt-expansion.mdを参照してください。
ステップ 3 — 計画
HTMLを書く前に、高いレベルで考えます。
- 何を — 視聴者体験:物語の弧、重要な瞬間、感情のビート。
- 構造 — いくつのコンポジション、サブコンポジションかインラインか、どのトラックがビデオ/オーバーレイ/キャプションを運ぶか。モノリシック単一ファイルとモジュラーサブコンポジションの判断については、
/hyperframes/core/references/composition-patterns.md§ 2つのアーキテクチャ(経験則:3つ以上のハードシーンカット、または再利用されるシーンがある → モジュール化;短いシングルシーン作品は1ファイルのまま)。 - リズム — 実装する前にパターンに名前を付けます(例:
fast-fast-SLOW-SHADER-hold);hyperframes-design/references/beat-direction.mdを参照。 - タイミング — どのクリップが長さを決定し、トランジションがどこに配置され、ペーシングはどうか。
- レイアウト — 最初に最終状態を構築します(下記参照)。
- アニメーション — 次に
hyperframes-motionを介してモーションを追加します。
アニメーションの前にレイアウト
すべての要素を、最も目立つ瞬間に配置される位置に配置します — 完全に入場し、正しく配置され、まだ退場していない状態。それをまず静的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→ 「ルートはサイズ設定されている必要があります」を参照)。これをスキップすると、flexコンテナは約0に collapse し、コンテンツは左上隅に積み重なり、最初のグリフはx=0でクリップされます — その間lint/inspectは依然として0件の問題を報告します。そして、.scene-contentのpadding(≥80px)は常に維持してください:それはタイトルセーフマージンです。これを単なるgapに置き換えないでください。
- エントランスを追加 —
gsap.from()を使用して、画面外/非表示からCSSの位置へアニメーションします(サブコンポジションでは、開始状態を明示するためにgsap.fromTo()を推奨;/hyperframes/core/references/sub-compositions.mdを参照)。CSSの位置が真実であり、トゥイーンはそこへの旅です。 - 退場はトランジションで処理 —
hyperframes-motion/transitions/のシーントランジションルールに従い、最終シーンのみが要素を外にアニメーションします。シーン間では、トランジション自体が退場です。
時間を共有する空間: 要素Aが要素Bと同じエリアに入る前に退場する場合でも、両方ともそれぞれのヒーローフレームに対して正しいCSS位置が必要です — タイムラインの順序付けによって共存が防止され、レイアウトステップで偶発的なオーバーラップをキャッチします。レイヤー化されたグロー/シャドウとzスタック深度は_意図的な_オーバーラップです。このステップは_意図しない_衝突(2つの見出しが重なる、コンテンツがフレーム外に溢れる)をキャッチすることです。
構築 — ドメインスキルに委譲
これは、スキルの全表面(descriptionを参照)をそのリファレンスにマッピングします — 網羅的ではありません。意図がリストにない場合は、hyperframes-design(ルック/コンセプト)、hyperframes-motion(モーション)、/hyperframes/core(契約)を経由してルーティングします。最初の行はADDITIVEです — 以下の意図行と合わせて読み、どちらか一方だけではありません。
| 構築内容… | 最初に読むもの(順序) |
|---|---|
| 常に — すべての非自明な作品において、下記の意図行に加えて | hyperframes-design/references/house-style.md + references/video-composition.md(ステップ1 / HARD-GATEでもゲートされています;「制作された、生成されていない」フォアグラウンド詳細) |
| キネティックタイポグラフィ/テキスト主体 | hyperframes-motion/techniques.md(キネティックタイプ) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| タイトルカード/ローワーサード/オーバーレイ/PiP/被写体背面テキスト | hyperframes-design/references/composition-patterns.md + (中央揃え/サイズ調整フレーム用) /hyperframes/core → 「ルートはサイズ設定されている必要があります」 |
| ロゴ/ブランドマークのリビール | hyperframes-motion/rules/svg-path-draw.md(描画) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| データ/統計/数字 | hyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md |
| 製品/アプリ/UIデモ | hyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| マルチシーン/トランジション | hyperframes-motion/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-design/references/design-adherence.mdのチェックリスト -
npx hyperframes inspectが成功する、またはすべてのオーバーフローが意図的にマークされている - コントラスト警告に対処済み。マルチシーン作品の場合は、アニメーションマップをレビューする(
hyperframes-motion/scripts/animation-map.mjs) - プレビューを提供。明示的なリクエストがあった場合のみMP4にレンダリングする
- プレビューはハンドオフ時のみ提示する(安定した最終プレビューです)。構築途中にプレビューを表示しない — 構築フェーズのスナップショットはヘッドレスで行う