gusto-ui-skills

Gusto UI スキル

AI エージェントで Gusto スタイルのインターフェースを構築するための、独自の制約です。

適用する場面

以下の場合に、これらのガイドラインを参照してください。

• ライトモードのインターフェースを構築する場合
• Gusto に着想を得たデザインシステムを作成する場合
• Inter フォントと 4px グリッドを使用して UI を実装する場合

色

• 主なサーフェスには、ライトな背景を使用するべきです
• ページの背景（surface-base）には、#116D6Cを使用する必要があります
• 主なアクションとフォーカス状態（accent）には、#116D6Cを使用する必要があります
• カラーパレットを縮小するべきです（現在、23 色が検出されています）
• アクセシビリティのため、テキストのコントラスト比を少なくとも 4.5:1 に維持する必要があります

セマンティックトークン

トークン	HEX	RGB	用途
surface-base	#116D6C	rgb(17,109,108)	ページの背景
surface-raised	#FFFFFF	rgb(255,255,255)	カード、モーダル、盛り上がったサーフェス
surface-overlay	#063E82	rgb(6,62,130)	オーバーレイ、ツールチップ、ドロップダウン
text-primary	#606060	rgb(96,96,96)	見出し、本文テキスト
text-secondary	#717171	rgb(113,113,113)	セカンダリテキスト、控えめなテキスト
text-tertiary	#898989	rgb(137,137,137)	その他のテキスト
border-default	#E3ECED	rgb(227,236,237)	控えめな境界線、区切り線
accent	#116D6C	rgb(17,109,108)	主なアクション、リンク、フォーカス
destructive	#DA6966	rgb(218,105,102)	エラー状態、削除アクション

タイポグラフィ

• プライマリフォントファミリーには、Interを使用する必要があります
• 一貫性を保つため、単一のフォントファミリーを使用するべきです
• 主な見出しには、51px / extra_boldを使用する必要があります
• 本文テキストには、15px / 400を使用する必要があります
• フォントウェイトを減らすべきです（現在、6 種類が検出されています）
• 見出しにはtext-balanceを、本文テキストにはtext-prettyを使用する必要があります
• 数値データにはtabular-numsを使用するべきです
• 明示的に要求されない限り、letter-spacing を変更してはいけません

テキストスタイル

スタイル	フォント	サイズ	ウェイト	色	件数
heading-1	Inter	51px	extra_bold	#353636	1
text-35px	Inter	35px	700	#E0554C	1
text-32px	Inter	32px	extra_bold	#D62833	1
text-30px	Inter	30px	semi_bold	#343434	1
text-28px	Inter	28px	extra_bold	#FADAD3	1
text-25px	Inter	25px	extra_bold	#2E2E2E	1
text-23px	Inter	23px	semi_bold	#DA6966	1
text-22px	Inter	22px	500	#323232	1
text-18px	Inter	18px	500	#575757	1
text-18px	Inter	18px	400	#5B677E	1

タイポグラフィのリファレンス

フォントファミリー：

• Inter（80 回使用）

フォントサイズ： 6px、7px、8px、9px、10px、11px、12px、13px、14px、15px、17px、18px、22px、23px、25px、28px、30px、32px、35px、51px

余白

• 余白には 4px グリッドを使用する必要があります
• 次のスケールの余白を使用するべきです：1px、2px、3px、4px、5px、6px、7px、9px
• 要素間のデフォルトの間隔には 5px を使用するべきです
• 任意の余白値を使用してはいけません（デザインスケールを使用してください）
• コンテナ内のパディングを一貫させるべきです

境界線

• 次のスケールから境界線の角丸を使用する必要があります：4px、6px、7px、9px、10px、15px、16px、22px、23px
• ピル型の要素には 22px 以上の角丸を使用するべきです
• 境界線の幅は1px、2pxに制限するべきです
• デフォルトの境界線の角丸には7pxを使用するべきです
• 任意の角丸値を使用してはいけません（デザインスケールを使用してください）
• 要素を区切るには、控えめな境界線（1px）を使用するべきです

角丸のリファレンス

スケール： 4px、6px、7px、9px、10px、15px、16px、22px、23px

レイアウト

• ベースのビューポート幅を1920pxとして設計する必要があります
• 要素の幅は一貫させるべきです：15px、24px、23px、48px、11px
• 明確な階層を持つ、テキスト主体のレイアウトを維持するべきです
• h-screenは使用せず、ビューポート全体の高さにはh-dvhを使用してください
• 固定要素ではsafe-area-insetを考慮する必要があります
• 正方形の要素にはw-*とh-*の代わりにsize-*を使用するべきです

検出されたレイアウトパターン

• メインコンテンツ：幅：1920px、高さ：864px
• メインコンテンツ：幅：1920px、高さ：789px
• ヘッダー：高さ：76px
• ヘッダー：高さ：51px

コンポーネント

ボタン

バリアント	背景	テキスト	枠線	高さ	角丸
ゴースト	透明	#807F7D	なし	-	-

インタラクティブな状態

フォーカス

• アクセントカラー（#116D6C）の 2px のアウトラインを必ず使用します
• 2px のアウトラインオフセットを必ず使用します
• フォーカスインジケーターを削除してはいけません

ホバー

• ボタン（プライマリ）：背景を 10% 明るくします
• ボタン（セカンダリ）：#FFFFFF の背景を使用します
• リスト項目：#FFFFFF の背景を使用します

無効状態

• opacity: 0.5 を必ず使用します
• cursor: not-allowed を必ず使用します

インタラクション

• 破壊的または取り消せない操作には、必ず AlertDialog を使用します
• ローディング状態には、構造を反映したスケルトンを使用することを推奨します
• エラーは、操作が行われる場所の近くに必ず表示します
• input または textarea 要素での貼り付けをブロックしてはいけません
• アイコンのみのボタンには、必ず aria-label を追加します

アニメーション

• 明示的に要求されていない限り、アニメーションを追加してはいけません
• コンポジターのプロパティ（transform、opacity）のみをアニメーションさせます
• レイアウトプロパティ（width、height、top、left、margin、padding）をアニメーションさせてはいけません
• 表示時のアニメーションには ease-out を使用することを推奨します
• インタラクションのフィードバックは 200ms を超えてはいけません
• prefers-reduced-motion を尊重することを推奨します

パフォーマンス

• 大きな blur() または backdrop-filter のサーフェスをアニメーションさせてはいけません
• アニメーションの実行中以外に will-change を適用してはいけません
• レンダリングロジックで表現できる処理に useEffect を使用してはいけません