Communitygithub.com

RamonsDka/the-architect-overlay

Stripe、Linear、Apple、Vercel スタイルのプロダクトグレードなモーションアニメーションを設計・実装するためのスキル。モーションの原則、イージング/デュレーションのデフォルト、コレオグラフィパターン、スクロール/ホバー操作、パフォーマンス、アクセシビリティ(動きの軽減)、実装ガイダンスをカバーします。

the-architect-overlay とは?

このスキルは、Stripe、Linear、Apple、Vercel といったトッププロダクトが採用する、洗練されたプロダクトグレードの Web モーションを設計・実装するための包括的なガイドです。単にアニメーションを増やすのではなく、**より良いアニメーション**(明確さ、階層、フィードバック、そしてジャンクのない美しさ)を実現することに焦点を当てています。モーションの5つの目的(階層の説明、アクションの確認、注意の誘導、連続性の維持、洗練の付加)を定義し、これらに基づいてアニメーションを取捨選択する判断基準を提供します。具体的なモーションプリミティブ(フェード+ライズ、スケール+フェードなど)、デフォルトのデュレーション(120ms~1600ms)とイージング(イージーアウトを基本とした安全なセット)、要素間のスタッガー値(40~90ms)など、実用的な数値とパターンを提示します。また、transform と opacity のみをアニメーションさせるパフォーマンスルールや、prefers-reduced-motion への対応(必須)など、アクセシビリティに関する非妥協のルールも含まれています。さらに、ライブラリ非依存の実装ガイダンス(CSS トランジションと GSAP/Framer Motion の使い分け、モーショントークンの作成)や、出力形式(モーションの目標、トークン、コレオグラフィ計画、実装ノート、コードレシピ)も提供し、開発者がすぐに Stripe/Linear スタイルのアニメーションを適用できるように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RamonsDka/the-architect-overlay/tree/HEAD/skills/animation-systems

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

アニメーションシステム(Stripe × Linear × Apple × Vercel)

このスキルは、洗練されたプロダクトグレードのモーションを実現するのに役立ちます。 単に「アニメーションを増やす」のではなく、より良いアニメーション、すなわち明確さ、階層、フィードバック、そしてジャンクのない美しさを追求します。


目標(なぜモーションが存在するのか)

アニメーションは次の目的に使用します:

  1. 階層を説明する(何が重要か)
  2. アクションを確認する(フィードバック)
  3. 注意を誘導する(次にどこを見るか)
  4. 連続性を維持する(空間的な関係性)
  5. 洗練を加える(クラフトのシグナル)

アニメーションがこれらのいずれも満たさない場合は、削除してください。


Stripe/Linear/Apple/Vercel スタイル(共通の特徴)

1) 抑制

  • アニメーションの数を減らし、厳選する。
  • 1つの強力なヒーローモーメントを設け、残りは補助的な動きに留める。

2) 明確なコレオグラフィ(動作の振り付け)

  • 主要な要素が最初に動く。
  • 二次的な要素は小さなスタッガー(ずらし)を伴って続く。
  • モーションによって「読みの順序」が確立される。

3) 物理的だが、漫画的ではない

  • 人間らしさを感じさせるイージング(ソフトな加速+穏やかな落ち着き)を使用する。
  • シリアスなプロダクトUIでは、バウンスしすぎるデフォルトは避ける。

4) テクスチャと奥行き(控えめに)

  • 小さなパララックス、ソフトなシャドウ、ブラーを使ったフェード、ライトビーム。
  • ヒーロー表現でない限り、重厚な3Dは避ける。

モーションプリミティブ(まずこれらを構築する)

どこでも再利用できるプリミティブを考えましょう。

A) フェード+ライズ(デフォルトの出現)

テキストブロック、カード、モーダルに使用。

  • 不透明度: 0 → 1
  • Y: 12~24px → 0
  • 継続時間: サイズに応じて300~700ms

B) スケール+フェード(マイクロ強調)

ポップオーバー、トースト、選択状態に使用。

  • スケール: 0.98 → 1
  • 不透明度: 0 → 1

C) スライド(ナビゲーション)

ドロワー、ステップ遷移に使用。

  • transform: translate を使用し、レイアウトのアニメーションは避ける。

D) モーフィング/共有要素(高クラフト)

タブインジケーター、展開するカードに使用。

  • 一貫したジオメトリと測定されたレイアウトが必要。

デフォルト値(実用的な数値)

これらを初期システムとして使用します。

継続時間(目安)

  • マイクロ(ホバー/プレス): 120~200ms
  • UI状態変化(トグル、選択): 180~260ms
  • 小さなトランジション(ポップオーバー、トースト): 220~320ms
  • ページセクション出現: 400~800ms
  • ヒーローシーケンス: 800~1600ms(内部にビートを持つ)

イージング(安全なセット)

少数のセットを選び、使い回す。

  • UI: イージーアウト(穏やかな落ち着き)
  • 強調: やや強いイージング
  • 出現: イージーアウト
  • 消失: イージーイン(やや速く)

実装時は:

  • 使用するアニメーションライブラリの「power2.out / expo.out」相当のものを使用する。
  • ブランドが遊び心のあるものでない限り、弾性/バウンスは避ける。

スタッガー(ずらし時間)

  • 要素あたり40~90ms(テキスト行/カード)
  • モバイルではより小さなスタッガーを使用する

コレオグラフィパターン

1) 「ヒーロー → 補助要素」

  • ヒーロービジュアルが最初にアニメーションインする。
  • 見出しが次に現れる。
  • CTA(行動喚起)が最後に現れる。

2) 「スクロールに合わせたセクション表示」

  • セクションが約20~30%表示されたときにトリガーする。
  • 1度だけアニメーションさせる(小さなスクロールで再生しない)。

3) 「ホバー:リフト+グロー」

  • Y: -2~-6px
  • シャドウ: わずかに増加
  • オプション: ボーダー/グラデーションのグロー

4) 「フォーカスリング+マイクロシフト」

  • フォームフィールド:フォーカスリング+応答性のためのわずかなスケール/トランスレート。

パフォーマンスルール(非妥協)

適切なプロパティをアニメーションさせる

優先するもの:

  • transform(translate/scale/rotate)
  • opacity

避けるもの(必要な場合を除く):

  • width/height/top/left
  • 広い領域に対する高負荷フィルター

GPUを尊重する

  • 負荷の高いキャンバスではデバイスピクセル比を1~2に制限する
  • ブラーは控えめかつ小さく保つ
  • 多数の同時アニメーションシャドウを避ける

リフローを減らす

  • 毎フレームレイアウトを測定しない。
  • スクロールエフェクトには、読み取りと書き込みをバッチ処理するライブラリを使用する。

アクセシビリティ:動きの軽減

常に prefers-reduced-motion をサポートすること。

ポリシー:

  • コンテンツは表示されたままにする。
  • モーションを 瞬時の状態変化 + 控えめな不透明度の変更に置き換える。
  • スクロール連動のスクラブ/ピン留めを無効にする。

ユーザーに問いかける:

  • 「必須でないモーションをすべて無効にする、動きを軽減したモードが必要ですか?」

実装ガイダンス(ライブラリ非依存)

シンプルなサイト向け

  • 小さなホバー/トグルにはCSSトランジションを使用する。
  • 複雑なシーケンスには、1つのモーションライブラリ(GSAPまたはFramer Motion)を使用する。

プロダクトサイト向け

  • モーショントークンセットを作成する:
    • 継続時間
    • イージングカーブ
    • 標準オフセット(8/16/24px)
    • スタッガーデフォルト

ヒーローモーメント向け

  • ラベル付きビートを持つタイムライン(またはキーフレーム)を使用する。
  • 最初にカメラ/シーンの動きを固定し、その上にテキストを重ねる。

ユーザーに尋ねるべきこと

  • ブランドの方向性はどれか:Stripe(洗練)、Linear(ミニマル)、Apple(映画的)、Vercel(デベロッパー/プロダクト)?
  • キーモーメントは何か?(ヒーロー、スクロールストーリー、ホバーカード、ナビ遷移)
  • パフォーマンス上の制約はあるか?(モバイル、ローエンドデバイス)
  • 動きの軽減に関する要件は?

出力形式(「Stripe/Linearスタイルのアニメーションを追加」と依頼された場合)

以下の形式で返す:

  1. モーションの目標(何を伝えたいか)
  2. モーショントークン(継続時間+イージング+オフセット)
  3. コレオグラフィ計画(タイムラインビート)
  4. 実装ノート(パフォーマンス+動きの軽減)
  5. 小さなコードレシピ(スタックに応じてCSS、GSAP、またはFramer Motion)

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

関連スキル