シネマティック・スクラブ・ランディングページ — 黄金テンプレート
プレミアムでブランドを意識したランディングページを構築します。ヒーロービデオがマウスに反応し、ページの残りの部分は視聴者を5ビートのナラティブアークに導きます。ユーザーはビデオ、オプションでロゴ + 製品写真 + ブランドコンテキストを提供します。このスキルは、パレット抽出、タイポグラフィ選択、RTL/LTR、スキャフォールド、オールキーフレームビデオ再エンコード、マウススクラブ効果、セクションライブラリ、および検証を処理します。
なぜこのスキルが存在するのか
参考実装は https://github.com/hoodini/bamba にあります。これはイスラエルのスナック「במבה」向けのRTLサイトで、ベビービデオがページ全体でカーソルを追跡し、その下の4つの異なるセクション(明るい黄色のレシピ、クリーム色の郷愁アルバム、暗い物思いの価格設定、赤いアクションのフィナーレ)が視聴者を 憧れ → 喜び → 郷愁 → 物思い → アクション へと導きます。

このスキルのすべてのルールはそのビルドから抽出されました。ハードルールセクションの箇条書きはすべて貴重な経験則であり、一般的な「良いコード」のデフォルトを上書きします。
セクションギャラリー(あなたが構築するもの)
ヒーローは上部に留まります。その下に、ライブラリから4つのセクションを選択し、ナラティブアークに従って順序付けます。各セクションは完全に不透明(ビデオの透けなし)で、独自のブランドアイデンティティを持ちます。
| ビート | タイプ | リファレンス |
|---|---|---|
| 1 — 憧れ | ヒーロー (マウススクラブビデオ) | ![]() |
| 2 — 喜び | Sun — 明るいプライマリアクセントグラデーション、浮遊するモチーフSVG、巨大なゴーストタイポグラフィ、統計カード | ![]() |
| 3 — 郷愁 | アルバム — クリーム色の紙、点線のマイクロパターン、実際の製品写真を使ったポラロイド弁当箱 | ![]() |
| 4 — 物思い | Roast — ラジアルアクセントグローのある暗色、3つの価格カード(それぞれ異なるビジュアル処理) | ![]() |
| 5 — アクション | Signal — フルブリードの強いアクセント(赤/オレンジ/緑)、巨大な見出し + CTA、ガラスで囲まれたパネル | ![]() |
技術/SaaSブランドの場合は、必要に応じてセクションタイプを交換します(以下のセクションライブラリを参照)。ただし、常にSignalセクションで終了します。
このスキルの使い方
-
アセットを配置 クリーンな作業ディレクトリに:
- ヒーロービデオ(任意のコンテナ —
.mp4、.mov、.webm) - ロゴ(SVGを強く推奨。透明PNGも可)
- 1〜3枚の製品/サブジェクト画像(JPG/PNG、透明が理想的)
- ヒーロービデオ(任意のコンテナ —
-
ユーザーと確認(簡単に — デフォルトを提案して先に進む):
- 製品名 + メタタグライン
- 言語コード(RTL/LTR + フォント選択を決定)
- ブランドコンテキスト — 時代、オーディエンス、感情的核心、パレットの雰囲気
- オプション:明示的なパレット16進数コード、ナラティブアークビート
-
以下のワークフローを順に実行します。 すべてのフェーズが必須です。ffmpegの再エンコードをスキップしないでください — それがスクラブを滑らかにする魔法です。
-
報告する前に検証します。 フェーズ9には12のチェックがあります。すべて実行してください。
入力 — ユーザーからこれらを収集します
PRODUCT_NAME: "<例: Bamba / Bamba / Hope the Cheetah / Acme CRM>"
TAGLINE: "<メタメッセージ — 例: 'it's not a snack, it's lifelong memories'>"
LANGUAGE: "<he | en | ar | es | fr | ja | ...>"
IS_RTL: "<true | false>" # he/ar/fa = true; それ以外 = false
HERO_VIDEO_FILE: "<cwd内の正確なファイル名 — 例: baby2.mp4>"
LOGO_FILE: "<正確なファイル名 — ない場合は空白のまま>"
PRODUCT_IMAGE_FILE: "<正確なファイル名 — ない場合は空白のまま>"
BRAND_CONTEXT: |
<2〜4文: 想起させる時代、オーディエンス、感情的核心、ビジュアルアイデンティティ(暖かい/冷たい/遊び心/真面目)。パレット+モチーフを決定します。>
PALETTE: "<オプション — 上書きする場合はカンマ区切りの16進数>"
NARRATIVE_ARC: "<オプション — 5つの感情ビート。空白の場合はAIが提案>"
完全なテキストテンプレート(同じYAMLブロックとプロンプト本文)は references/GOLDEN_PROMPT.md にあります。スキルランタイムに直接アクセスできない場合は、YAMLを入力してClaudeに貼り付けてください。
フェーズ0 — デザインを計画する(コーディング前に200語以下の概要を出力)
コードを書く前に、以下を出力します。
-
抽出された5色パレット:
background(最も深いインク)、cream(暖かみのあるオフホワイトのテキスト — 絶対に#FFFFFFは使用不可)、accent(プライマリブランドカラー)、accent2(セカンダリブランドカラー)、support(ターシャリトーン)。 -
言語に適したタイポグラフィの3つ組(ディスプレイ / 本文 / 手書きアクセント):
he: Rubik (ディスプレイ) + Assistant (本文) + Suez One (アクセント)en: Anton (ディスプレイ) + Inter (本文) + Caveat (アクセント)ar: Cairo (ディスプレイ) + Tajawal (本文) + Reem Kufi (アクセント)es/fr/it/de: Anton または Bebas Neue (ディスプレイ) + Inter (本文) + Caveat (アクセント)ja: Noto Sans JP weight 900 (ディスプレイ) + Noto Sans JP (本文) + Yusei Magic (アクセント)- その他: スクリプトに合った3つのGoogleフォントを選択。同じ
display-black / body-clean / handwritten-scriptの役割で。
-
ナラティブアーク —
BRAND_CONTEXTにマッピングされる5つの感情ビート。各ビートをセクションライブラリのセクションタイプに一致させます。
その後実行 — 確認を求めないでください。
フェーズ1 — アセット準備(魔法のステップ)
1a. ffmpegの確認
which ffmpeg # または: Get-Command ffmpeg (PowerShell)
存在しない場合、停止してユーザーにインストールを伝えます(brew install ffmpeg / Windows: http://ffmpeg.org)。
1b. すべてのフレームをキーフレームとしてヒーロービデオを再エンコード
ブラウザはキーフレームにしか瞬時にシークできません — 標準的なビデオには約250フレームに1つのキーフレームしかなく、マウススクラブがひどくぎこちなくなります。この単一のコマンドが、プレミアムとアマチュアの違いです。
ffmpeg -y -i <HERO_VIDEO_FILE> -g 1 -keyint_min 1 -c:v libx264 -preset slow -crf 20 -pix_fmt yuv420p -an hero.mp4
出力を確認: hero.mp4 は5〜50 MBである必要があります。> 50 MBの場合は -crf 25 で再実行。> 80 MBの場合は -crf 28 で再実行。音声を削除(-an)— ヒーローは無音です。
1c. ロゴ + 製品画像をコピー
cp <LOGO_FILE> public/logo.<ext>
cp <PRODUCT_IMAGE_FILE> public/product.<ext> # 提供されている場合
フェーズ2 — スキャフォールド
npm create vite@latest site -- --template react-ts
cd site
npm install
npm install lucide-react
npm install -D tailwindcss@3 postcss autoprefixer
npx tailwindcss init -p
mkdir -p public
mv ../hero.mp4 public/hero.mp4
# ロゴと製品画像も public/ に移動
フェーズ3 — Tailwind設定
tailwind.config.js を完全に置き換えます。抽出されたパレットと言語に適したフォントを使用します。
/** @type {import('tailwindcss').Config} */
export default {
content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"],
theme: {
extend: {
colors: {
background: '<インク/ダーク>',
cream: '<暖かみのあるオフホワイト — 絶対に #FFFFFF は使用不可>',
accent: '<プライマリブランドカラー>',
accent2: '<セカンダリ>',
support: '<ターシャリ>',
},
fontFamily: {
sans: ['<本文フォント>', 'system-ui', 'sans-serif'],
display: ['<ディスプレイフォント>', 'sans-serif'],
accent: ['"<手書きフォント>"', 'cursive'],
},
},
},
plugins: [],
}
フェーズ4 — index.html
完全に置き換えます。IS_RTL を尊重します。常にファビコンリンクをロゴに向けて含めます。
<!DOCTYPE html>
<html lang="<LANGUAGE>" dir="<rtl|ltr>">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/logo.svg" />
<link rel="apple-touch-icon" href="/logo.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="<選択した3つのフォントのGoogle Fonts URL>" rel="stylesheet">
<title><PRODUCT_NAME> — <TAGLINE></title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>
フェーズ5 — index.css(デザインシステム)
完全に置き換えます。以下のすべてのユーティリティは重要です。
html { scroll-behavior: smooth; }+section[id] { scroll-margin-top: 90px; }アンカーされたセクションが固定ナビの下にこないようにします。body背景 =backgroundカラー(ビデオが失敗した場合のフォールバック)。カーソル =crosshair。デフォルトフォント = 本文sans。.liquid-glass/.liquid-glass-strong— backdrop-blur + saturate + 内側の明るい境界線 + マスクされたグラデーションエッジハイライト。Strongバリアントはaccentで着色された内側のグローを使用します。.glass-pill— コンパクトな丸いピルで、ナビゲーションアイテムや小さなバッジに同じガラス処理を適用します。.cta-primary— ブランドCTA:linear-gradient(135deg, accent-light, accent, accent-shade)+ ホバー時に強くなるアクセントカラーのグローシャドウ +translateY(-1px)リフト。.brand-mark— SVGが提供されない場合の小さなロゴマーク用の小さな正方形/円形。.grid-bg— ラジアルフェードマスク付きの微妙な1pxグリッド。ダークセクションの下で使用します。.reveal/.revealed— IntersectionObserver スクロールリビール:opacity 0 → 1+translateY 28 → 0を0.9秒かけてcubic-bezier(0.16, 1, 0.3, 1)で。.scrim-top/.scrim-bottom— ヒーロー専用のグラデーションオーバーレイ。- セクションごとの背景、色ではなく感情で命名:
.sun-section— 明るいプライマリアクセントグラデーション + 微妙な点線テクスチャ(「喜び / 袋を開ける」ビート)。.album-section— 暖かみのあるオフホワイトの紙、ラジアルアクセントティント + 点線マイクロパターン、エッジマスクフェード。.roast-section— ダークで、ラジアルアクセント + accent2 が向かい合うコーナーでグロー + マスクされたグリッドテクスチャ。.signal-section— アクションフィナーレのためのフルブリードの強いアクセント(多くの場合赤/オレンジ/緑)。
.polaroid— 白いカード、パディング14px 14px 44px 14px、ソフトなレイヤードシャドウ、ホバーリフトtranslateY(-6px) rotate(0)。.polaroid-tape= 黄色/アクセントのテープストリップが上部中央に絶対配置、-4°回転、破線のサイドヒント付き。.stamp— アクセントカラーの破線境界線ピル、大文字、文字間隔0.18em。.ribbon— 価格/人気バッジ、clip-path三角形の底面、暗いドロップシャドウ。.highlight-circle—::afterで描かれた手描き風の楕円: インライン<span>の周りに3px回転したアクセントカラーの境界線。大きな見出しの中で最も重要な単語の周囲に使用します(見出しごとに最大1つ)。- 装飾モチーフフィルター:
.peanut-svg/.<motif>-svgにdrop-shadow。 prefers-reduced-motion: reduceを尊重 — メディアクエリ内でリビールアニメーション + スムーズスクロールを無効にします。
フェーズ6 — App.tsx アーキテクチャ
アーキテクチャは譲れません。最初に正しく設定します。
6a. インポート
import { useEffect, useRef, useState } from 'react';
import {
Menu, X, ArrowLeft, ArrowRight, ArrowDown, ArrowUp, MousePointer2,
// …さらに4〜8個のブランドテーマアイコン (Heart, Sparkles, Cookie, PawPrint, Cpu, Leaf, …)
} from 'lucide-react';
6b. App.tsx内で定義される再利用可能なコンポーネント
useReveal<T>()— IntersectionObserverフック、refを返します。最初の交差時にrevealedクラスを追加します(threshold 0.15)。GlassCard— リビールフック付きラッパー、オプションのstrongプロパティ、classNameを受け入れます。Motif—BRAND_CONTEXTをテーマにした単一の装飾SVGコンポーネント(食品はピーナッツ、動物は足跡、テクノロジーは回路、自然は葉、飲料は水滴、エネルギーは稲妻)。暗い/明るいセクションの3〜6箇所に低い不透明度で浮かびます。ScrollToTopButton— RTLではbottom-6 left-6、LTRではbottom-6 right-6に固定。window.scrollY > window.innerHeight * 0.6のときに表示されます。スムーズにトップへスクロール。言語に適した短いラベル("לראש" / "Top" / "أعلى" / "最上部")。
6c. マウススクラブ効果(核心)
const videoRef = useRef<HTMLVideoElement>(null);
const stateRef = useRef({ targetTime: 0, isSeeking: false });
useEffect(() => {
const video = videoRef.current;
if (!video) return;
const handleLoaded = () => {
const mid = video.duration / 2;
video.currentTime = mid;
stateRef.current.targetTime = mid;
};
const handleSeeked = () => {
const s = stateRef.current;
s.isSeeking = false;
if (Math.abs(s.targetTime - video.currentTime) > 0.01) {
s.isSeeking = true;
video.currentTime = s.targetTime;
}
};
const handleMouseMove = (e: MouseEvent) => {
const s = stateRef.current;
const d = video.duration;
if (!d || isNaN(d)) return;
const normalized = e.clientX / window.innerWidth;
// カーソルに対して被写体が「逆方向」に動き、違和感がある場合は、オプションで
// `1 - (e.clientX / window.innerWidth)` を代わりに使用します — 最初にユーザーに確認してください。
s.targetTime = Math.max(0, Math.min(d, normalized * d));
if (!s.isSeeking) { s.isSeeking = true; video.currentTime = s.targetTime; }
};
video.addEventListener('loadedmetadata', handleLoaded);
video.addEventListener('seeked', handleSeeked);
window.addEventListener('mousemove', handleMouseMove);
return () => {
video.removeEventListener('loadedmetadata', handleLoaded);
video.removeEventListener('seeked', handleSeeked);
window.removeEventListener('mousemove', handleMouseMove);
};
}, []);
isSeeking ガードは重要です — これがないと、mousemoveがブラウザのデコード速度より速く発火し、シークキューのオーバーフローと目に見えるスタッターが発生します。
6d. クリック可能なスクロールスパイナビゲーション
const navItems: { label: string; target: string }[] = [
{ label: '<デモ>', target: 'top' },
{ label: '<レシピ>', target: 'joy' },
{ label: '<アルバム>', target: 'nostalgia' },
{ label: '<価格>', target: 'contemplation' },
{ label: '<今すぐ入手>', target: 'action' },
];
ページスクロール位置に基づいてアクティブなナビゲーション項目を強調表示するために、IntersectionObserver で activeSection 状態を使用します。最初のマウント時に scrollIntoView({ behavior: 'instant' }) を top セクションに適用して、初期ギャップを削除します。
6e. 戻る/進むジェスチャー
effect(() => {
const handleKey = (e: KeyboardEvent) => {
if (e.key === 'ArrowRight') scrollToNextSection();
if (e.key === 'ArrowLeft') scrollToPrevSection();
};
window.addEventListener('keydown', handleKey);
return () => window.removeEventListener('keydown', handleKey);
}, []);
RTLでは矢印キーを入れ替えます(ArrowRight = 前へ、ArrowLeft = 次へ)。
6f. メインJSX構造
<main className="relative">
{/* 固定ナビゲーションバー */}
<nav className="fixed top-0 left-0 right-0 z-50 glass-pill">
<div className="container ...">
<img src="/logo.svg" alt="logo" className="h-8" />
<div className="flex gap-4">
{navItems.map(item => (
<button onClick={() => scrollTo(item.target)}>{item.label}</button>
))}
</div>
</div>
</nav>
{/* ヒーローセクション — フルビューポート、固定ビデオ、ガラスオーバーレイ */}
<section id="top" className="relative h-screen overflow-hidden">
<video ref={videoRef} ... >
<div className="relative z-10 ...">
<GlassCard strong>
<h1 className="font-display ...">{PRODUCT_NAME}</h1>
<p className="...">{TAGLINE}</p>
</GlassCard>
</div>
</section>
{/* 4〜5の下層セクション、それぞれが独自のスタイル + リビールアニメーションを持つ */}
<SunSection /> {/* 喜び — 明るい、アクセントグラデーション */}
<AlbumSection /> {/* 郷愁 — クリーム色、ポラロイド */}
<RoastSection /> {/* 物思い — 暗い、価格設定 */}
<SignalSection /> {/* アクション — 強いアクセント、CTA */}
{/* フッター — 著作権 + ソーシャルリンク */}
<footer className="...">
<p>© {new Date().getFullYear()} {PRODUCT_NAME}</p>
</footer>
<ScrollToTopButton />
</main>
Note: 各 <SunSection />、<AlbumSection /> などは、実際のコードではインラインの <section> 要素になります。それぞれの生のJSXは大量になります — Generate > 1000 locales recommended。以下のセクションライブラリを使用してそれぞれを構築してください。
フェーズ7 — セクションライブラリ(ヒーローの後に4〜5つ選択)
ヒーローの後に4つ(最大5つ)のセクションを選択します。これは選択肢です。セクションタイプを感情ビートに合わせます。すべてのセクションは完全に不透明(ビデオの透けなし)で、独自の色 + タイポグラフィの強調 + レイアウトパターンを持ちます。
Sun(喜び / 発見)
- 背景: 明るい
accent → accent-lightグラデーション(例: 黄色から桃色)。上部に浮かぶモチーフSVG。 - タイポグラフィ:
font-displayの巨大なゴーストテキスト(不透明度15%)がセクションタイトルの後ろに。 - コンテンツ: 2〜3枚の統計カード(アイコン + 数字 + 短いラベル)。「製品での喜び」を示す大きな製品写真。引用/証言。
- インタラクション: ホバー時にカードが
translateY(-8px)で持ち上がり、accent2のボックスシャドウが付きます。
アルバム(郷愁 / ストーリー)
- 背景: 暖かみのあるオフホワイト(
cream)+ 効果のないアクセントティント。点線のマイクロパターン(background-image: radial-gradient(circle, accent 1px, transparent 1px); background-size: 20px 20px)。 - タイポグラフィ: セクションタイトルは
font-accent(手書き風)。本文はfont-sans、大きめの行間。 - コンテンツ: 製品写真/ブランドイメージを使ったポラロイド弁当箱グリッド。キャプション付きの「年表」タイムライン。いくつかの曲がった要素(
rotate(-2deg)/rotate(3deg))で手作り感を演出。 - インタラクション: ポラロイドがホバーで回転して浮き上がります。
Roast(物思い / 比較)
- 背景:
backgroundの最も濃い色合いをベースに、ラジアルaccent+accent2グローが向かい合うコーナーから。マスクされたgrid-bgテクスチャ。 - タイポグラフィ:
font-displayの見出しは明るいaccentカラー。本文はcream。 - コンテンツ: 3つの価格/プランカード。各カードは異なるビジュアル処理: 1つ目は標準のガラスカード、2つ目は
.ribbon付き(人気)、3つ目は境界線のみ(目立たない)。機能比較表。 - インタラクション: カードがホバーで拡大(
scale(1.03))+accentのグローシャドウ。
Signal(アクション / フィナーレ)
- 背景: フルブリードの強い
accent(多くの場合赤、オレンジ、蛍光緑)。ラジアルグラデーションのバリエーションで奥行きを演出。 - タイポグラフィ:
font-displayの巨大な白い見出し(カスタムCSSでスケーリング)。CTAボタンは白背景にaccentテキスト。 - コンテンツ: フルガラスパネルにメッセージ + CTAボタン。テキストの中央に
.highlight-circleが1つ。オプション: 下部にソーシャルプルーフロゴの行。 - インタラクション: CTAがホバーで拡大 +
translateY(-3px)+ 明るいドロップシャドウ。
追加セクションタイプ(代替案)
必要に応じてこれらを使用します — Sun、Album、Roastよりも優先されることはありません。
- Flow(プロセス / 仕組み): 関連線で接続された水平/垂直のステップカード。
accentの数字インジケーター。透かしとしてのモチーフ。 - Grid(機能 / チーム): 3列の等しいカード(機能、チームメンバー、お客様の声)。
creamの背景にaccentの角のアクセント。 - Map(場所 / 範囲): 埋め込み地図またはSVGの世界地図。
accent2のピン + 発光パルスアニメーション。 - Quote(権威 / 社会的証明): 大きなブロック引用 + 著者の写真 + ブランドロゴ。
backgroundの上に白いテキスト。引用符はaccent。
フェーズ8 — ハードルール(矛盾するベストプラクティスより優先)
これらは、実際の本番ビルドから抽出された、議論の余地のないルールです。常識に反していても、このルールに従ってください。
-
Tailwindのピクセル値を決して使用しないでください。 CSSの
pxユニットは使用しないでください。rem/em/ Tailwindのスケール(例えばtext-sm、p-8)のみ。Tailwindのデフォルトスケールは絶対的なものです。 -
プレーンな
#FFFFFF(純白)はテキストには決して使用しないでください。 「白」のテキストは常にcreamカラーを使用します — 暖かいブランドの場合は#FDFBF7(または抽出されたクリーム色)、冷たいブランドの場合は#F0F4F8。純白は、すりガラスの境界線(不透明度60%)、スキームの一部としての小さな装飾要素にのみ使用します。理由: 純白は暗い背景に対してきつく見え、カラーパレットの統合感を損ないます。 -
黒影は暗闇ではありません。 影は背景よりも暗い色調(
background)を使用します。決して#000やrgba(0,0,0,…)は使用しないでください。暗いブランドの場合はbackground=#1A1D23、影はrgba(18, 20, 26, …)。中程度のブランドの場合は背景から2段階暗くします。 -
禁止されているCSSプロパティ。
position: stickyは使用しないでください(特にビデオには使用不可)。background-attachment: fixedはモバイルで壊れます。これらはすべての主要ブラウザで安定して動作するマウススクラブに取って代わられています。object-fit: containはヒーロービデオには使用しないでください(空のスペースが発生します)—coverを使用してください。 -
タイポグラフィ: 1つのディスプレイフォント、1つの本文フォント、1つのアクセント(手書き風)フォントのみ。 それ以上は使用しないでください。アクセントフォントはテキストの5%以下に使用します(引用、セクションラベル、1語だけの見出しアクセント)。
-
フォントウェイトは正確に使用してください。 Google Fontsのロード時は、正確なウェイトのみを含めてください —
wght@400;700;900は使用せず、wght@900(ディスプレイ)、wght@400;600(本文)、wght@400(手書き)のように指定します。「…」を使用してすべてをロードするのは避けてください。 -
imgのalt属性は空にしないでください(純粋に装飾的な場合を除く)。 製品写真の場合は説明的なaltを付けます。ロゴはalt="<PRODUCT_NAME> logo"にします。背景画像はaria-hidden="true"または空のalt。 -
モバイル優先。 すべてのセクションは、
flex-colからmd:flex-rowへのブレークポイントで始まります。パディングはp-4 md:p-8 lg:p-16。ビデオモーション設定を尊重します。モバイルではマウスがないため、スクラブ効果はタッチには適応しません — モバイルではビデオを静的な開始フレームにロックするか、controls属性を追加します。 -
Heroは完全にビューポートに収まります。 余白なし、パディングなし。
h-screen+overflow-hidden。下部のスクリムは、下のセクションが始まる場所を示すのに十分なだけの微妙なフェードです。 -
すべてのセクションタグは
<section id="...">にします。idはnavItemsのtargetと正確に一致します。 -
React.StrictMode は削除しないでください。 これにより、クリーンアップと不要なレンダリングの問題が早期に表面化します。
-
エラーバウンダリは入れません。 このページは安定していてシンプルです。入れるとコードが膨らみます。
フェーズ9 — 検証 + 品質チェック
「完了」と報告する前に、12のチェックすべてを実行します。
9a. ビルドが成功する
cd site && npm run build
エラーがあってはなりません。未使用のインポートに対するTypeScriptの警告は許容されます。
9b. ローカルで提供してテストする
cd site && npm run dev
ブラウザで開きます。以下を確認します。
9c. マウススクラブチェック
- マウスを左右にドラッグすると、ビデオがシークし、フレームが変化します。
- ぎこちなさ、黒いフラッシュ、空白のフレームはありません。
- 最初の読み込み時、ビデオは中央のフレーム(duration / 2)から始まります。
9d. スクロールチェック
- 下にスクロールすると、ヒーローから次のセクションにスムーズに移行します。
- 各部分セクションは完全に可視で、透けはありません。
9e. ナビゲーションチェック
- 各ナビゲーション項目をクリックすると、正しいセクションにスムーズにスクロールします。
- アクティブなセクションが強調表示されます(スクロールスパイ)。
- モバイルではハンバーガーメニューが開きます。
9f. パフォーマンスチェック
- ビデオは5〜50 MB(再エンコードに
-crf 20を使用した場合)。 - Lighthouse — パフォーマンス >= 85、アクセシビリティ >= 90。
- アセットサイズが妥当であること。
9g. モバイルレスポンシブチェック
- ビューポート 375pxで開きます。すべてのコンテンツが画面に収まる。はみ出しや水平スクロールはありません。
- フォントサイズが読みやすい/適切に拡大縮小されている。
- ビデオは静的画像として表示されるか、
controls属性がある。
9h. アクセシビリティチェック
- 見出しが適切にネストされている(h1 → h2 → h3)。
- フォーカス可能な要素にフォーカススタイルがある。
- すべてのナビゲーションリンクにaria-labelがある。
9i. クロスブラウザチェック
- Chrome / Firefox / Safari — スクラブが機能する(Safariはvideo要素で最も信頼性が高い)。
9j. prefers-reduced-motion チェック
- OSの設定で「アニメーションを減らす」が有効な場合、スクロールリビール + スムーズスクロールが無効になる。
9k. スクリーンリーダーチェック(簡易)
- Tabキーですべてのインタラクティブ要素を移動できる。
- ビデオ要素に適切なラベルがある(タイトル属性)。
9l. RTL/LTR一貫性チェック
dir属性がindex.htmlで正しい。- すべてのマージン/パディングがRTLで正しく反転されている(
ml-*とmr-*)。 - 矢印キーのナビゲーションがRTLで反転されている。
すべて合格した場合のみ、「完了」と報告します。
トラブルシューティング + 注意事項
- ffmpegの再エンコードに時間がかかりすぎる:
-preset ultrafastを使用してください(品質は低下しますが、作業中は問題ありません)。本番前の最終パスで-preset slowを使用します。 - ビデオがまったく表示されない: パスを再確認します。
hero.mp4がpublic/にあることを確認します。ブラウザの開発者ツールネットワークタブで404エラーを確認します。 - シークが遅れる:
-g 1 -keyint_min 1が実際にビデオに適用されているか確認します。ffprobe hero.mp4 -show_entries frame=pict_type 2>&1 | grep -c pict_type=Iで最初の50フレームを調べます — すべてI(キーフレーム)である必要があります。 - ガラス効果がSafariで機能しない:
-webkit-backdrop-filterが必要かもしれません。Tailwindのbackdrop-blurクラスは通常これを処理します。 - Babel / トランスパイルのエラー:
tsconfig.jsonのtargetがes2020以上に設定されていることを確認します。 - Tailwindクラスが適用されない:
tailwind.config.jsのcontentパスがすべてのソースファイルをカバーしているか確認します。
付録: アセット参照
assets/01-hero-mouse-scrub.png— マウススクラブビデオ + ガラスブランドパネルを備えたHero。assets/02-yellow-recipe.png— Sunセクション: 黄色のグラデーション、浮かぶピーナッツSVG、統計カード。assets/03-cream-album.png— アルバムセクション: クリーム色の背景、ポラロイド写真、製品画像。assets/04-dark-pricing.png— Roastセクション: 暗い背景、ラジアルグロー、3つの価格カード。assets/05-red-cta.png— Signalセクション: 赤い背景、大きな見出し、CTAボタン。references/GOLDEN_PROMPT.md— 埋め込まれたYAML入力と同じスキル説明を含むスタンドアロンプロンプトテンプレート(スキルランタイムがない場合にClaudeに直接貼り付け可能)。references/archive/— 以前の実験とバリエーション。








