スキル: ガバナンス
システムが成長しても一貫性を保ちます。バージョニング、コントリビューション、非推奨ルールを適用します。
手順
workflows/governance.md(SemVerテーブル、コントリビューションワークフロー、非推奨ポリシー、変更通知)を読みます。- 変更を分類します: major(破壊的 — トークンやプロパティの名前変更/削除、アナトミー/デフォルトの変更)、minor(追加的 — 新しいトークン/コンポーネント/バリアント/オプショナルプロパティ)、patch(修正 — コントラスト/バグ/ドキュメント/値の微調整(許容範囲内))。
- 新しいコンポーネント/トークンの場合: それが本当に繰り返し発生するニーズ(2箇所以上)に応えることを確認してから、product → candidate → core に昇格させます。完全な品質基準(
.claude/rules/components.md→ コンポーネント品質基準)に従って設計します。 - 非推奨の場合: 理由 + 代替手段 + 削除バージョンを明示し、最低1つのマイナーサイクルは動作を維持します。移行マップ(
design-systems/crosswalk.mdスタイル)を提供し、メジャーバージョンでのみ削除します。 - 新しいファイルを
CLAUDE.md(ファイル参照マップ + 該当テーブル/ルーター)に紐付け、changelogエントリを追加します。
検証(完了の定義)
- 変更に SemVer レベル と changelogエントリがあること。
- 削除に非推奨期間、代替手段、移行テーブルがあること。
- 新しい仕様が8状態 + a11y + トークンマッピングの基準を満たし、ルーターから到達可能であること。
python3 scripts/validate_tokens.pyがパスすること。色が変わった場合はコントラストを再確認すること。