Tailwind CSS Class Hygiene Review

Pattern declaration

Primary pattern: Reviewer Secondary patterns: Inversion Why: Tailwind の utility class 構文（arbitrary value / クラス競合）をチェックリスト型で検査し、診断材料が無ければゲートで止める。

Goal / 目的

• スケール/トークンを迂回する任意値（w-[437px] mt-[13px] text-[#1a2b3c] 等）の濫用を検出し、テーマのスペーシング/カラースケールへの寄せを促す。
• 同一要素に併存する競合・重複ユーティリティ（px-2 px-4、flex block、mt-2 mt-4 等、互いに打ち消すクラス）を検出する。
• デザイントークン（bg-white / theme color）で表現すべき色の任意カラー直書き（bg-[#fff] 等）を検出する。

Non-goals / 扱わないこと

• デザイントークン体系全般の是非（命名・粒度・採用方針）は design-token-enforcement のスコープ。本スキルは Tailwind の utility class 構文レベルの衛生に限定する。
• Tailwind か素の CSS かといった採用技術の選定。
• レスポンシブ/状態 variant（md: hover: 等）の設計妥当性。

Pre-execution Gate / 実行前ゲート

このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。

• 差分に className / class への Tailwind utility の追加・変更が含まれている
• diff コンテキストが利用可能である

ゲート不成立時の出力: NO_REVIEW: tailwind-class-hygiene — className/class への Tailwind utility 変更なし

False-positive guards / 抑制条件

• 設計上スケール外が必要な正当ケース（例: 1px ボーダー border-[0.5px]、外部デザイン由来の固定値で theme.extend 済み等）で、コメントによる正当化または theme 拡張が確認できる場合は指摘しない。
• 動的クラス（テンプレートリテラル内で実行時計算される値、例: w-[${width}px]）は別スコープとして扱い、静的な任意値と同列に断定しない（慎重に、必要なら質問に留める）。
• theme に存在しない CSS（grid template など）を表現する arbitrary value が公式に推奨される稀なケースは、断定せず質問に留める。
• 同一クラスに見えても variant prefix が異なる場合（px-2 md:px-4 等）は競合ではないため指摘しない。

Rule / ルール

• 任意値（[...]）でスケール/トークンに対応物がある値（スペーシング・サイズ・カラー）を直書きしている場合は、theme のスケール/トークンへ寄せる修正を提案する。
• 同一要素の同一プロパティに作用する複数ユーティリティが併存（px-2 px-4、mt-2 mt-4、flex block 等）し、後勝ちで前者が無効化される場合は重複/競合として指摘する。
• 任意カラー直書き（bg-[#fff] text-[#000] 等）でデザイントークン（bg-white / theme color）に対応物がある場合はトークン利用を提案する。
• "nit" を濫発しない。明確に theme で代替できるものに絞り、判断が割れるものは質問に留める。

Evidence / 根拠の取り方

• 指摘は <file>:<line> で差分に紐づけ、どのクラスが問題か（任意値 / 競合 / 任意カラー）を 1 行で添える。
• theme 対応物の有無が diff だけで確証できない場合は断定せず「可能性」として書く。

Output / 出力（短文版の推奨）

コメントは日本語で返す。

• Finding: どのクラス衛生に反しているか（任意値濫用 / 競合 / 任意カラー、1文）
• Impact: スケール逸脱で一貫性低下 / 後勝ちで意図しない値 / トークン迂回で一括変更不能 等
• Fix: theme スケール（w- 系）/ 競合解消（片方削除）/ トークン（bg-white 等）への最小修正案

Sources / 出典

• Tailwind CSS — Theme: https://tailwindcss.com/docs/theme
• Tailwind CSS — Using arbitrary values: https://tailwindcss.com/docs/adding-custom-styles#using-arbitrary-values