安定性ポリシー
本番依存していい線引きを明示しています。
GunjoUI の各コンポーネントには安定性ラベルが付与されていて、本番採用していい場所と、まだ形が動く場所を一目で見分けられます。ラベルは各コンポーネントの docs ページのタイトル横と、`/api/specs/manifest` の JSON に出てきます。
レベル
Stable
公開 API は固定済み。本番依存しても安全。破壊的変更にはメジャーバージョン昇格が必要（semver 準拠）。
向いている用途：本番機能を作るとき。マイナーバージョンの範囲で固定すれば十分です。
Beta
機能としては完成し、社内利用も進んでいます。フィードバック次第で API は調整される可能性があります。パッチバンプでは壊れませんが、マイナーで壊れることがあります。
向いている用途：1 度の移行コストを許容できる機能。確実性が必要なら exact version で固定してください。
Experimental
形と振る舞いが任意のリリース（パッチも含む）で変わる可能性があります。まだ正しい primitive を探っている段階です。
向いている用途：プロトタイプ、社内ツール、使い捨てデモ。売上に直結する画面にはまだ載せないでください。
現状
GunjoUI は alpha（0.0.1-alpha.2）です。明示的に分類されていないコンポーネントのデフォルトは Experimental になります。個別のコンポーネントが安定したら段階的に格上げ — 昇格内容は changelog を参照。
昇格条件
- Stable → Beta で最低 1 マイナー期間 API 破壊的変更ゼロ、過去の形からの移行ドキュメント完備。
- Beta → 機能完成、/docs の Props 完全カバー、a11y レビュー通過、本番採用 1 件以上。
- Experimental → デフォルト。新規はここから始まります。