Skip to content

Модель стабильности

plugin-kit-ai использует формальные contract terms, чтобы команды могли точно понять, что именно они хотят стандартизировать.

Публичный язык и формальный язык

Публичные docs сначала используют более простой vocabulary:

  • Recommended обычно указывает на самые сильные текущие public-stable paths
  • Advanced указывает на поддерживаемые surfaces, которые уже или специализированнее
  • Experimental соответствует public-experimental

Когда вы задаёте compatibility policy, формальные термины важнее.

Recommended - это продуктовый язык, а не замена формального контракта.

  • обычно это promoted public-stable production path
  • это не означает parity между всеми target'ами
  • сама формулировка не поднимает public-beta или public-experimental surfaces выше

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.

Практическое правило

  1. Предпочитайте рекомендуемый path для того продукта, который вы строите.
  2. Используйте точные формальные terms только тогда, когда нужна policy или compatibility precision.
  3. Используйте validate --strict как readiness gate для repo, который собираетесь выпускать.

Публичная документация для авторов плагинов и интеграторов.