Skip to content

Выбор стартового репозитория

Используйте эту страницу, когда нужен самый быстрый путь в repo, который потом можно расширять на новые поддерживаемые outputs.

Перед выбором держите в голове одно важное правило:

  • starter показывает, как начать
  • он не определяет окончательную границу продукта
  • и он не мешает одному repo позже поддерживать больше target’ов

Если эта разница пока неочевидна, сначала прочитайте Один проект, несколько target’ов.

Сначала выберите, потом расширяйте

  • выбирайте Go, когда нужен самый сильный путь для продакшена
  • выбирайте Node/TypeScript, когда нужен основной поддерживаемый путь без Go
  • выбирайте Python, когда репозиторий осознанно Python-first и остаётся локальным для репозитория
  • выбирайте Claude starters только тогда, когда Claude hooks — это реальное product requirement

Starter нужно выбирать под первый правильный путь, а не под воображаемую окончательную форму продукта.

Что остаётся верным после выбора

  • repo остаётся одним
  • основной процесс остаётся тем же
  • поддерживаемые target’ы можно добавлять позже
  • глубина поддержки зависит от того, какой target вы добавляете

Матрица starter’ов

Если вам нуженЛучший starterПочему
Самый сильный путь для Codex в продакшенеplugin-kit-ai-starter-codex-goGo-first production path с самой чистой историей передачи другим людям
Repo-local Codex plugin на Pythonplugin-kit-ai-starter-codex-pythonStable Python subset с проверенным layout репозитория
Repo-local Codex plugin на Node/TSplugin-kit-ai-starter-codex-node-typescriptОсновной поддерживаемый путь без Go
Самый сильный путь для Claude в продакшенеplugin-kit-ai-starter-claude-goStable Claude subset плюс самый чистый путь для продакшена
Repo-local Claude plugin на Pythonplugin-kit-ai-starter-claude-pythonStable Claude hook subset с Python helpers
Repo-local Claude plugin на Node/TSplugin-kit-ai-starter-claude-node-typescriptStable Claude hook subset для TypeScript-first команд

Shared-package варианты

Игнорируйте этот раздел, если заранее не знаете, что команде нужен plugin-kit-ai-runtime как reusable dependency вместо vendored helper files.

Используйте shared-package варианты, когда:

  • нужна общая dependency across multiple plugin repos
  • команда готова явно pin'ить и обновлять runtime package
  • вы не хотите копировать helper files в каждый repo

Текущие shared-package starter'ы:

Если выбираете между обычным Python starter и Python starter с runtime-package, сначала прочитайте Python runtime, а затем Выбор модели поставки.

Когда не нужно переоптимизировать выбор

Не тратьте слишком много времени на поиск идеального starter.

Если не уверены:

  1. начинайте с Go starter ради самого сильного варианта по умолчанию
  2. начинайте с Node/TypeScript starter ради основного поддерживаемого пути без Go
  3. переходите к Python или shared-package variant только тогда, когда командный компромисс уже реален

Хорошая командная политика

Выбор starter’а на уровне команды должен быть достаточно стабильным, чтобы:

  • все узнавали layout репозитория
  • CI использовал один и тот же readiness flow
  • handoff не зависел от объяснений maintainer’а

Но стабильный выбор starter’а не мешает одному репозиторию позже добавить другие target’ы, если этого требует продукт.

Свяжите эту страницу со Стартовыми шаблонами, Выбором модели поставки, Bundle handoff и Стандартом репозитория.

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