Direct answer
何を決めるための項目ですか？
canonical archive向けに、同じAnimation Projectを再現可能な実装ファイルへ変換するAdapterです。
canonical archive向けに、project.json / compiled-timeline.json / validation-report.json / catalog-lock.jsonを生成します。依存関係、warning、loss、確認方法、rollbackも同じartifactへ残します。
Reference facts
固定値・入力・判定結果
- Audience（利用先）
- canonical archive
- Files（生成物）
- project.json / compiled-timeline.json / validation-report.json / catalog-lock.json
- Dependencies（依存）
- AdapterごとのREADMEとartifact reportへ明記
- Quality evidence（品質証拠）
- warning / loss / tested GSAP / verify / rollback
Install and rollback
生成物を安全に導入する手順
- 対象サイトと実装ファイルをバックアップし、GSAP・ScrollTriggerの導入versionとCSPを確認します。
- artifact reportのdependencies、warnings、lossesを読み、対象外の機能を手作業へ分離します。
- scope付きのrootで導入し、Desktop・Mobile・Reduced Motion・200%表示・キーボードを確認します。
- font・image loadとresize後にScrollTriggerの位置を再確認し、性能を計測します。
- 問題時は生成物を無効化・削除し、記録されたROLLBACK手順で直前の状態へ戻します。
Safe workflow
本番へ入れる前の共通確認
- TimelineをPlay・Pause・Reverse・Restart・Seekし、開始・終了時間とlabelを確認します。
- Scroll Storyはstart・end marker、scene範囲、pin、scrub、snapをDesktopとMobileで確認します。
- Reduced Motionでpin・scrubが無効になり、本文と操作要素が見える最終状態になることを確認します。
- Quality FindingのRule ID、evidence、severity、warning、lossを解消または記録します。
- 実サイト上でbrowser、resize、font・image load、性能、cleanup、rollbackを確認します。
Terms
英語表記の意味
Target（ターゲット）は動かす対象、Track（トラック）は対象ごとの時間レーン、Tween（トゥイーン）は値の変化、Scene（シーン）はScroll Storyの場面、Evidence（エビデンス）は判定根拠、Loss（ロス）は出力先で完全に表現できない差、Cleanup（クリーンアップ）はanimationとScrollTriggerを破棄する処理、Rollback（ロールバック）は元に戻す手順です。