КОНЦЕПЦИИ

Ментальная модель

Публичные концепции объясняют модель продукта, уровни поддержки и типы target’ов, не затягивая пользователя во внутреннюю release-механику.

Базовые идеи

Публичные docs описывают поддерживаемое пользовательское поведение, а не внутренние процессы команды.
API reference генерируется из реальных источников истины.
Install wrappers — это каналы доставки CLI, а не программные API.
Stability и maturity не менее важны, чем сами сигнатуры.

Начните с Зачем plugin-kit-ai, если ещё решаете, подходит ли проект вашей команде.
Прочитайте Модель управляемого проекта, если вам нужно самое короткое объяснение того, чем вообще является продукт.
Прочитайте Выбор runtime до того, как выбирать Go, Python, Node или shell.
Прочитайте Модель target’ов, прежде чем считать любой target полноценным runtime-плагином.
Прочитайте Модель стабильности, прежде чем обещать долгую совместимость другим пользователям.

Поймите, какую проблему решает проект и когда это вообще не ваш инструмент.

Посмотрите на самое короткое определение продукта: один authored repo, generated outputs, строгая validation и явные границы путей.

Посмотрите, как исходное состояние проекта, generated-файлы, validation, target’ы и handoff складываются в единую систему.

Поймите, что значат public-stable, beta и experimental, прежде чем завязываться на конкретную поверхность API или target.

Посмотрите на практическую разницу между runtime, package, extension и workspace-config target’ами.

Выберите между Go, Python, Node и shell по практическим ограничениям проекта, а не только по вкусу команды.