Что именно вы собираете

Начинайте с задачи. Вам не нужно понимать target IDs, runtime lanes или детали local MCP transport до того, как вы создадите repo.

Подключить онлайн-сервис

Используйте это, когда плагин должен подключаться к hosted-сервису вроде Notion, Stripe, Cloudflare или Vercel.

plugin-kit-ai init my-plugin --template online-service

Это создаёт:

• один редактируемый source под src/
• общий hosted-service wiring под src/mcp/servers.yaml
• generated app-specific output files для поддерживаемых package и workspace targets
• без runtime-кода и launcher-контракта по умолчанию

Подключить локальный инструмент

Используйте это, когда плагин должен обращаться к repo-owned CLI, container или локальному executable tool вроде Docker Hub, Chrome DevTools или HubSpot Developer.

plugin-kit-ai init my-plugin --template local-tool

Это создаёт:

• один редактируемый source под src/
• wiring для локальной команды, контейнера или инструмента под src/mcp/servers.yaml
• generated app-specific output files для поддерживаемых package и workspace targets
• без runtime-кода и launcher-контракта по умолчанию

Сделать свой plugin с логикой - Advanced

Используйте это, когда ценность плагина живёт в вашем коде, hooks, runtime behavior или orchestration logic.

plugin-kit-ai init my-plugin --template custom-logic

Этот путь даёт больше контроля и больше ответственности, чем первые два starter'а:

• вы редактируете runtime-facing files под src/
• вы сохраняете один repo, даже когда generated target outputs появляются в корне
• вы сами владеете runtime entrypoint, test flow и поведением, которые определяют плагин

Откройте Build Custom Plugin Logic, если вам нужен отдельный advanced guide для этого пути.

Что делать дальше

После любого из этих стартов:

cd my-plugin
plugin-kit-ai inspect . --authoring
plugin-kit-ai generate .
plugin-kit-ai generate --check .

Потом валидируйте тот supported output, который реально собираетесь поставлять первым.

Когда открывать advanced pages

• Открывайте Быстрый старт, когда нужен самый короткий first-run flow.
• Открывайте Build Custom Plugin Logic, когда вы осознанно выбираете advanced runtime path.
• Открывайте Выбор target, когда нужны конкретные решения по способу поставки.
• Открывайте Что можно собрать, когда нужна полная product map.