governance

スキル：ガバナンス

ステップ 0：キットはありますか？ このスキルはキット内のファイルを読み取ります。一度だけ確認してください： ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING KIT_MISSING の場合、インストールされているのはスキルフォルダーだけです。これは npx skills add の動作です。その旨を明確に伝え、 npx ux-ui-agent-skills init またはプラグインのインストールを案内して、そこで終了してください。 開けなかったファイルの内容を推測してはいけません。

システムの成長に合わせて一貫性を保ちます。バージョニング、コントリビューション、非推奨化のルールを適用します。

手順

1. ${CLAUDE_SKILL_DIR}/../../../workflows/governance.md を読みます（SemVer の表、コントリビューションのワークフロー、非推奨化ポリシー、変更に関する連絡）。
2. 変更を分類します：major（破壊的変更：トークンや prop の名前変更・削除、構造やデフォルトの変更）、minor（追加的変更：トークン・コンポーネント・バリアント・任意の prop の追加）、patch（修正：許容範囲内のコントラスト・バグ・ドキュメント・値の調整）。
3. 新しいコンポーネント／トークンの場合：製品から候補、コアへと昇格させる前に、実際に繰り返し発生するニーズ（2 か所以上）に応えることを確認します。コンポーネント品質基準（${CLAUDE_SKILL_DIR}/../../../.claude/rules/components.md → Component Quality Bar）を満たすように設計します。
4. 非推奨化の場合：理由、代替項目、削除バージョンを明記します。少なくとも 1 回の minor サイクル期間は引き続き動作させ、マイグレーションマップ（${CLAUDE_SKILL_DIR}/../../../design-systems/crosswalk.md の形式）を用意します。削除は major でのみ行います。
5. 新しいファイルを CLAUDE.md（File Reference Map および関連する表／ルーター）に登録し、変更履歴を追加します。

検証（完了の定義）

• 変更に SemVer のレベルが指定され、変更履歴の項目が追加されていること。
• 削除には非推奨期間、代替項目、マイグレーション表があること。
• 新しい仕様が 8 状態 + アクセシビリティ + トークンマッピングの基準を満たし、ルーターから参照できること。
• python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_tokens.py が成功すること。色を変更した場合はコントラストも再確認すること。