Выбор стартового репозитория
Используйте эту страницу, когда нужен самый быстрый путь в 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-go | Go-first production path с самой чистой историей передачи другим людям |
| Repo-local Codex plugin на Python | plugin-kit-ai-starter-codex-python | Stable Python subset с проверенным layout репозитория |
| Repo-local Codex plugin на Node/TS | plugin-kit-ai-starter-codex-node-typescript | Основной поддерживаемый путь без Go |
| Самый сильный путь для Claude в продакшене | plugin-kit-ai-starter-claude-go | Stable Claude subset плюс самый чистый путь для продакшена |
| Repo-local Claude plugin на Python | plugin-kit-ai-starter-claude-python | Stable Claude hook subset с Python helpers |
| Repo-local Claude plugin на Node/TS | plugin-kit-ai-starter-claude-node-typescript | Stable 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'ы:
plugin-kit-ai-starter-codex-python-runtime-package: Python Codex starter с зафиксированнымplugin-kit-ai-runtimeвrequirements.txtplugin-kit-ai-starter-claude-node-typescript-runtime-package: Node/TypeScript Claude starter с зафиксированнымplugin-kit-ai-runtimeвpackage.json
Если выбираете между обычным Python starter и Python starter с runtime-package, сначала прочитайте Python runtime, а затем Выбор модели поставки.
Когда не нужно переоптимизировать выбор
Не тратьте слишком много времени на поиск идеального starter.
Если не уверены:
- начинайте с Go starter ради самого сильного варианта по умолчанию
- начинайте с Node/TypeScript starter ради основного поддерживаемого пути без Go
- переходите к Python или shared-package variant только тогда, когда командный компромисс уже реален
Хорошая командная политика
Выбор starter’а на уровне команды должен быть достаточно стабильным, чтобы:
- все узнавали layout репозитория
- CI использовал один и тот же readiness flow
- handoff не зависел от объяснений maintainer’а
Но стабильный выбор starter’а не мешает одному репозиторию позже добавить другие target’ы, если этого требует продукт.
Свяжите эту страницу со Стартовыми шаблонами, Выбором модели поставки, Bundle handoff и Стандартом репозитория.