Promptory Web Build
3つのツール、1つのスタック、それぞれに1つの役割:
| ツール | 役割 | 経験則 |
|---|---|---|
| Lenis | スクロールエンジン — ネイティブスクロール上でのスムーズな慣性スクロール | 一度だけグローバルにインストール。セクションごとにはしない。 |
| GSAP (+ ScrollTrigger) | アニメーションエンジン — カスタムタイムライン、スクロール駆動アニメーション、ピン留め | このサイトのデザインに特化したものすべて。 |
| React Bits | 既製のアニメーションコンポーネント(テキスト、背景、カーソル、カード、ボタン) | カタログコンポーネントがすでにそのエフェクトを備えている場合は、まずそれを試す。 |
これらは1つのアニメーションループを共有します。GSAPのティッカーがLenisを駆動し、ScrollTriggerがLenisのスクロールを読み取ります。この配線を正しく行うことが、このスキルにおいて最も重要なことです(§3)。
範囲: リアルタイムウェブ/DOMのみ。ビデオレンダリング(Remotion、リールなど)には、このスキルは適用されません。
0. 黄金律 — リデザイン禁止
ユーザーから依頼されたデザインとエフェクトを実装してください。レイアウト、色、フォント、スペーシング、コピーを自分で変更してはいけません。また、誰もリクエストしていない追加のセクションや「おまけ」のエフェクトを追加してはいけません。もしエフェクトや修正が明らかに何かを改善する場合は、1行で提案し、承諾を待ってください。モーションと品質チェックは既存のデザインに奉仕するものであり、それを置き換えるものではありません。
0.5 インテイク質問票 — 新しいウェブサイトリクエストの最初のステップ
新しいサイトのコードを書く前に、references/intake-questionnaire.mdのインテイク質問票を実行します:
- リクエストを読み、既に回答されている項目をスキップします。
- 残りの質問を最大3ラウンド(プロジェクト → モーション → 納品)に分けて質問します。可能な場合はClaude Codeの
AskUserQuestionツールを使用します(クリック可能なオプション + 自動「その他」自由記述ボックス)。そうでない場合は、各ラウンドを1つのコードブロックとして、各質問に選択肢の文字と空の「✎ أخرى」行を付けて表示します。 - プロジェクト概要を1つのコードブロックで表示し、ゴーサインを待ちます。
- その後、回答に正確に従ってビルドします。
ユーザーが「ابدأ على طول」/「skip」と言った場合は、⭐ デフォルト値を使用し、それを概要に記載します。既存サイトへの小さな編集の場合は、リクエストがあいまいでない限り質問票をスキップします。
概要には以下を記録する必要があります: 言語と方向(アラビア語/RTL、英語/LTR、またはその両方)、アクセシビリティ目標(デフォルトWCAG 2.2 AA)、フォームとそのバックエンド、および分析ツール(存在する場合)。
0.6 ビジュアルリファレンス — Prompt Motion
https://prompt-motion.com/ はモーションディレクションのためのビジュアルライブラリです(キネティックタイプ、プロダクトUI、パーティクル、シェイプ、チャート…それぞれの背後にはプロンプトがあります)。ユーザーがインスピレーションを求めた場合、質問票で「提案が必要」/「大胆なモーション」を選択した場合、またはライブラリへのリンクを共有した場合にのみ使用します。モーションのアイデアを借用し、GSAP / Lenis / React Bitsで再構築し、クライアントのデザインは維持します。ワークフロー、カテゴリ→コンポーネントマップ、モーションスペックテンプレート: references/visual-references.md。
0.7 品質バー — 表示前に確認
ビルドをスキャンして、一般的な出力の兆候(デフォルトのインディゴアクセント、絵文字アイコン、でっち上げられた指標、lorem ipsum、テンプレートのセクションなど)を探します。自分のコードにあるものは修正し、クライアントのデザインにあるものは1行の修正を提案します。完全なリスト: references/quality-bar.md。
0.8 デザインディレクション — すべてのサイトは異なる見た目にする
クライアントが独自のデザインを持っていない場合、コードを書く前に方向性を選択します。references/design-styles.mdを読み、以下の手順に従います:
- 概要の業種とオーディエンスに適したFitガイドから3つの方向性を候補として絞り込みます。
- このチャットまたはプロジェクトで直近3つのサイトで使用された方向性をスキップします(スタイルログ)。
- プロジェクト概要に1行で記載します:
方向性: <名前> — <理由>、代替案も1つ記載します。 - その方向性の特徴的な選択でビルドし、多様性チェックを実行します: 6つの軸のうち少なくとも4つが前のサイトと異なる必要があります。
方向性は構造と雰囲気のためのリファレンスです。リファレンスのブランド、写真、コピー、正確なレイアウトを決してコピーしないでください。クライアントがデザインを提供した場合は、それに従い、このステップをスキップします(§0 黄金律)。
0.9 特徴的なビジュアルデザイン(概要が未指定の場合)
出典: anthropics/skills、スキルfrontend-design(Apache-2.0、そのLICENSE.txtを参照)。概要がビジュアルディレクションを未指定にしている場合にのみ適用されます。§0が優先されます: クライアントのデザインと概要の文言に従います。概要が以下のリストのいずれかの外観を求めている場合も同様です。
- まず主題を特定する: 製品、オーディエンス、主要な役割。概要に記載がない場合は、1つ提案して確認する。業界と素材は、特徴的な選択を行う起点となる。
- ヒーローは、主題の世界で最も特徴的なもの(見出し、画像、ライブデモ、またはインタラクション)で始める。大きな数字、小さなラベル、グラデーションアクセントというデフォルトは、それが明らかに最良の選択肢でない限り避ける。
- タイポグラフィ: 1ファミリー、または明確に区別できる2つ。明確なタイプスケールを設定する。見出しでは、タイプの扱い自体がデザインの一部である。
- 行の長さは80文字未満。セリフ体の本文はサンセリフよりも若干大きめの行間が必要。
- タイポグラフィの決まり文句を避ける: 見出しの中の1語だけイタリックや色付き、すべて大文字のラベル、見出しの上にあり何も追加しないラベル。
- 番号付きマーカー(01 / 02 / 03)は、コンテンツが本当にシーケンスである場合のみ使用する。
- モーション: 1つの演出された瞬間(ページロード時または1つのリビール)。すべてのセクションにフェード&スライド、すべてのカードにホバートランジションは不要。ユーザーのアクション(開く、展開する、確認する)に応答するモーションは問題ない。
- コードの前に計画する: 4~6個の名前付き16進色、タイプの役割、レイアウトコンセプト(ASCIIワイヤーフレーム可)、および原則。計画を概要と照らし合わせてレビューする。任意の類似ページの一般的なデフォルトのように読める部分があれば、それを修正し、何を変更したかを述べる。
- 概要で指定がない限り避けるべきデフォルトの外観: テラコッタアクセントのクリーム背景; アシッドグリーンまたはバーミリオンアクセントのニアブラック; ヘアライン罫線とゼロ半径の大判スタイル; 同一の角丸SaaSカードと1つのグレーのシャドウ; すべての見出しの上のすべて大文字のアイブロウ; 中点で区切られたメタ文字列('A · B · C'); 'WORD — fragment'ラベル; #0B0B0B や #111 を黒の代わりに使用; 小さなラベルにモノスペース; すべてのリンクに '→'。
- 大胆さは1箇所に集中させる。その周りはすべて控えめに。概要に貢献しない装飾は削除する。
- 品質の最低基準: モバイル対応、フォーカスの可視化、 reduced motion の尊重、アクセシブルなコントラスト。
- CSSセレクタの詳細度に注意する。特にセクション間のパディングとマージンでは、ルールが互いに打ち消し合う可能性がある。
- コピー: エンドユーザーには平易な言葉、能動態、文頭以外は小文字。フローを通じて1つの動詞を使い続ける(「公開する」は「公開済み」につながる)。エラーメッセージは何が起こったかとその修正方法を、謝罪なしに伝える。空の状態は次のアクションを促す。
1. 意思決定フロー — リクエストに応じたツール選択
- アラビア語、バイリンガル、またはRTLサイト → レイアウトを書く前に
references/rtl-arabic.mdを読む。方向性は構造的な問題であり、後からの修正はコストがかかる。 - サイトのどこかにスムーズスクロールが必要 → Lenis(グローバルプロバイダー、§3)。スクロールアニメーションが存在する場合、プロジェクトセットアップ時に一度だけ行う。
- そのエフェクトを既に実現するReact Bitsコンポーネントはあるか? →
references/react-bits-catalog.mdを確認 → インストールする(§4)。典型的なヒット: 分割/ぼかし/スクランブルテキスト、スクロールリビールテキスト、アニメーション背景(オーロラ、パーティクル、グリッド、シェーダー)、カスタムカーソル、マグネット/チルトカード、マーキー、ギャラリー、ドック/メニュー、アニメーションボタン/カウンター。 - エフェクトがこのデザインに特化している場合(ヒーローイントロシーケンス、ピン留めストーリーテリングセクション、水平スクロールセクション、同期マルチ要素リビール) → GSAP タイムライン / ScrollTrigger(§5、詳細は
references/gsap.md)。 - プロジェクトがReactではない(プレーンHTML/バニラ)場合 → React Bitsは使用不可。Lenis + GSAPのみを使用(
assets/vanilla-setup.js)。 - フォーム、リスト、予約、データ駆動セクションがある場合 →
references/forms-and-states.md(ラベル、エラー、5つの状態)。 - サードパーティサービス(フォント、フォームバックエンド、分析、ホスティング、画像)を選択する場合 →
references/free-services.mdを読み、現在の制限を確認する。 - クライアントのデザインがない新しいサイト → まず方向性を選ぶ(§0.8、
references/design-styles.md)。
2. インストール
npm install gsap @gsap/react lenis
@gsap/react→ Reactプロジェクトのみ(useGSAPを提供)。lenis/reactとlenis/snapはlenisに同梱 — 追加パッケージは不要。- すべてのGSAPプラグイン(ScrollTrigger, SplitText, Flip, ScrollSmoother, Draggable…)は
gsapに同梱。 - React BitsコンポーネントはCLI経由で個別に追加(§4)。一部は独自の依存関係(
motion,three,ogl,matter-js…)を引き込む — CLIがインストールするが、選択前にカタログのDeps列を確認し、バンドルサイズが肥大化しないようにする。
絶対に GSAPのScrollSmootherをLenisと一緒に使用しないでください。これらは競合する2つのスムーズスクロールエンジンです。このスタックではLenisがスクロールエンジンです。
3. Lenis + GSAP + ScrollTrigger の配線(この通りに正確に行う)
React / Next.js
assets/SmoothScroll.jsx をプロジェクトにコピーし(例: components/SmoothScroll.jsx)、アプリを一度ラップします:
// app/layout.jsx (Next.js App Router)
import SmoothScroll from '@/components/SmoothScroll';
import ScrollToTopOnRoute from '@/components/ScrollToTopOnRoute';
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<SmoothScroll>
<ScrollToTopOnRoute />
{children}
</SmoothScroll>
</body>
</html>
);
}
アラビア語の場合は、ロケールに基づいて <html> に lang と dir を設定します(references/rtl-arabic.md §1を参照)。
Vite/Reactの場合は、main.jsx で <App /> を同様にラップし、ScrollToTopOnRoute はスキップします(next/navigation を使用するため)。
プロバイダーが行うことと、各行が重要な理由:
<ReactLenis root options={{ autoRaf: false }}>→<html>上の1つのグローバルインスタンス。autoRaf: falseはGSAPがそれを駆動するため。lenis.on('scroll', ScrollTrigger.update)→ ScrollTriggerがスムーズスクロールのフレームごとに再計算される。これがないとアニメーションが遅れたり、間違った位置で発火したりする。gsap.ticker.add(t => lenis.raf(t * 1000))→ 1つの共有ループ(GSAPの時間は秒、Lenisはミリ秒が必要)。gsap.ticker.lagSmoothing(0)→ タブ切り替え後の追いつきによるスタッターを防ぐ。- フォントと読み込み後に
ScrollTrigger.refresh()→ トリガー位置が最終的なレイアウトと一致する。
Vanilla HTML/JS
assets/vanilla-setup.js をエントリモジュールとして使用し、必要な場所から lenis をインポートします。
4. React Bits — コンポーネントの選択とインストール
references/react-bits-catalog.mdでコンポーネントを見つける(グループ: テキストアニメーション、アニメーション、コンポーネント、マイクロ、背景 — 名前、機能、依存関係)。- プロジェクトに合ったフレーバーを選択:
JSまたはTS、次にCSSまたはTW(Tailwind)。 - インストール:
npx shadcn@latest add @react-bits/SplitText-TS-TW@react-bits/のショートハンドを使用するには、プロジェクトのcomponents.jsonに以下が含まれている必要があります:{ "registries": { "@react-bits": "https://reactbits.dev/r/{name}.json" } }components.jsonがない / shadcnプロジェクトではない場合? 代わりに直接URLを使用:npx shadcn@latest add https://reactbits.dev/r/SplitText-TS-TW.json # または npx jsrepo@latest add https://reactbits.dev/r/SplitText-TS-TW - インストールされたファイルを開き、使用前にそのプロパティを読む — すべてのコンポーネントは設定可能(色、速度、遅延、イージング、トリガー)。デモのデフォルトのままにせず、サイトの既存のデザイントークン(色、フォント)に合わせてプロパティを設定する。
- ユーザーがエージェントワークフローを希望する場合:
npx shadcn@latest mcp init --client claudeでClaude CodeをMCP経由でレジストリに接続する。
統合に関する注意:
- スクロール時にアニメーションするReact Bitsコンポーネント(ScrollReveal, ScrollFloat, AnimatedContent, SplitText…)は内部的にGSAP ScrollTriggerまたはIntersectionObserverを使用する → §3が設定されていれば、Lenisと自動的に動作する。
- コンポーネントはクライアントコンポーネント(
'use client')です。Next.jsでは、クライアントコンポーネントまたはそれを許可するページ内でレンダリングします。 - WebGL/シェーダー背景(依存関係
three,ogl,vgpu)は重い: ページごとに最大1つまたは2つ、スクロールして見えるようになるまでフォールド以下のものはレイジーロードする(next/dynamicとssr: false、またはReact.lazy)。固定サイズのコンテナを指定する。オフスクリーン時またはタブが非表示のときは一時停止する。 - 同じビューポートに2つのカーソルエフェクトや2つの背景を重ねない。
- 5秒以上ループする各コンポーネントに一時停止制御があるか確認する(
references/accessibility-motion.md§5参照)。 - ライセンス: React BitsはMIT + Commons Clause — クライアントのウェブサイト内での使用(有償のクライアントワークを含む)は無料ですが、コンポーネント自体をパック/テンプレートとして再販売または再配布することはできません。React Bitsのソースをこのスキルや共有ライブラリに貼り付けないでください。常にレジストリからインストールしてください。
5. GSAP 基本(カスタムアニメーション)
Reactでは常に useGSAP を scope と共に使用 — 生の useEffect は使わない:
'use client';
import { useRef } from 'react';
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
import { useGSAP } from '@gsap/react';
gsap.registerPlugin(ScrollTrigger, useGSAP);
export default function Story() {
const root = useRef(null);
useGSAP(() => {
const tl = gsap.timeline({
scrollTrigger: { trigger: root.current, start: 'top top', end: '+=150%', scrub: 1, pin: true },
});
tl.from('.line', { yPercent: 100, autoAlpha: 0, stagger: 0.15 })
.to('.image', { scale: 1.15 }, '<');
}, { scope: root });
return <section ref={root}>…</section>;
}
コアパターン(詳細、レスポンシブ matchMedia、バッチ処理、FOUC、チェックリストは references/gsap.md にあります):
- 複数要素の場合はタイムラインを使用。繰り返しカードには
ScrollTrigger.batch()。 - スクロール連動モーションには
scrub(Lenisではscrub: trueで既にスムーズ。scrub: 1はさらに遅延を追加)。 pin: trueはネイティブスクロール上のLenisで動作 — Lenisがrootを使用する場合、pinTypeのハックは不要。- 水平スクロールセクション: ラッパーをピン留めし、トラックの
xを-(track.scrollWidth - innerWidth)にトゥイーン。scrub: true。invalidateOnRefresh: true。RTLの場合は方向を逆にする(references/rtl-arabic.md§6参照)。 - 装飾的なブロックを
gsap.matchMedia()でラップして、モーション軽減ユーザーに代替を提供する(references/accessibility-motion.md§4)。prefers-reduced-motion: reduceの場合はタイムライン全体をスキップし、CSSフェードインだけを残す。 - ページ読み込み時のFOUCを防ぐため、スプラッシュまたは
opacity: 0で始め、useGSAP内でフェードインする。useGSAPはDOMの準備ができた後に実行される。
6. フォームと状態
references/forms-and-states.md を参照。すべてのフォームで実装が必要な内容:
- 各入力のラベル(プレースホルダーはラベルの代わりにならない)。
- 5つの状態: デフォルト、フォーカス、入力中、エラー、成功。読みやすく、アクセシブル。
- フォーム全体のエラーバナー。
- ローディング中のスピナー + ボタン無効化。
- 二重送信防止。
- 成功状態(「ありがとうございました」の画面またはインライン確認)。
7. 自由なサービス
references/free-services.md を参照。24時間年中無休の無料利用枠があるオプション: フォント(Google Fonts, Fontsource)、フォームバックエンド(Web3Forms, Formspree)、分析(Plausible CE, Umami, PostHog)、ホスティング(Vercel, Netlify, Cloudflare Pages)、画像(Cloudinary, Imgix, Unsplash)。選択する前に現在の制限を確認。コストのかかる共有/アカウント登録を避ける。
8. アラビア語 / RTL
references/rtl-arabic.md を読む。重要なポイント:
- ロケールに基づいて
<html dir="rtl" lang="ar">またはlang="en"を設定。 - CSS論理プロパティを使用(
margin-inline-start、padding-inline-end)。 - RTLのフレックス/グリッド方向:
flexDirection: 'row-reverse'などのインラインスタイルではなく、CSSのdirection: rtlで対応。RTLでは水平スクロールアニメーションを反転。 - 英語とアラビア語の間のフォントウェイトの調整(アラビア語は通常、同じ見た目の重さを実現するために太めのウェイトが必要)。
付録: 参照ファイル
references/intake-questionnaire.mdreferences/visual-references.mdreferences/quality-bar.mdreferences/design-styles.mdreferences/react-bits-catalog.mdreferences/gsap.mdreferences/rtl-arabic.mdreferences/forms-and-states.mdreferences/free-services.mdreferences/accessibility-motion.mdassets/SmoothScroll.jsxassets/vanilla-setup.js