Модель стабильности
plugin-kit-ai использует формальные contract terms, чтобы команды могли точно понять, что именно они хотят стандартизировать.
Публичный язык и формальный язык
Публичные docs сначала используют более простой vocabulary:
Recommendedобычно указывает на самые сильные текущиеpublic-stablepathsAdvancedуказывает на поддерживаемые surfaces, которые уже или специализированнееExperimentalсоответствуетpublic-experimental
Когда вы задаёте compatibility policy, формальные термины важнее.
Как читать Recommended
Recommended - это продуктовый язык, а не замена формального контракта.
- обычно это promoted
public-stableproduction path - это не означает parity между всеми target'ами
- сама формулировка не поднимает
public-betaилиpublic-experimentalsurfaces выше
Public-Stable
Воспринимайте public-stable как уровень, на который можно опираться с нормальными production expectations.
Это tier, который большинству команд стоит предпочитать для default standards и долгого rollout.
Public-Beta
Воспринимайте public-beta как поддерживаемый, но ещё не замороженный контракт.
Используйте beta только тогда, когда компромисс осознан и действительно оправдан для продукта.
Public-Experimental
Воспринимайте public-experimental как opt-in churn вне нормального compatibility expectation.
Это может быть полезно для learning или раннего тестирования, но не должно тихо становиться командным default.
Практическое правило
- Предпочитайте рекомендуемый path для того продукта, который вы строите.
- Используйте точные формальные terms только тогда, когда нужна policy или compatibility precision.
- Используйте
validate --strictкак readiness gate для repo, который собираетесь выпускать.