Поддерживаемые харнессы

Какие AI-харнессы поддерживает ai_stp и что означает уровень поддержки.

Поддерживаемые харнессы

Харнесс — CLI-среда, в которой работает coding agent. ai_stp не заменяет харнесс и не вызывает модели: он помогает собрать проверяемый сетап для конкретного target, а применяет итоговое состояние только provider этого харнесса.

Статусы MVP

Харнесс	Статус в MVP	Что доступно	Что помнить
Claude Code	beta	паспорта, совместимость, сборка сетапа, provider-план	входит в открытую бету вместе с остальными шестью
Codex	beta	паспорта, совместимость, сборка сетапа, provider-план	входит в открытую бету вместе с остальными шестью
Grok Build	beta	паспорта, совместимость, сборка сетапа, provider-план	входит в открытую бету вместе с остальными шестью
Pi	beta	паспорта, совместимость, сборка сетапа, provider-план	входит в открытую бету вместе с остальными шестью
OpenCode	beta	паспорта, совместимость, сборка сетапа, provider-план	входит в открытую бету вместе с остальными шестью
Cursor	beta	паспорта, совместимость, сборка сетапа, provider-план	plugin pack распознаётся по манифесту `.cursor-plugin`
Antigravity	beta	паспорта, совместимость, сборка сетапа, provider-план	конфигурация лежит внутри `~/.gemini`, а не в собственном каталоге
`undefined`	ограниченный режим	чтение, импорт, локальные проверки	автоматическая установка не считается безопасной

Что означает “поддерживается”

Поддержка в ai_stp состоит из нескольких уровней. Харнесс может проходить один уровень и ещё не быть готовым к следующему.

Уровень	Что проверяется	Зачем пользователю
Detection	CLI понимает, что за target перед ним	чтобы не применить сетап не туда
Compatibility	компоненты объявляют поддержку харнесса	чтобы отсеять очевидно неподходящее
Projection	сетап можно превратить в нативную структуру	чтобы файлы и настройки попали в правильный формат
Provider plan	provider строит план изменения target	чтобы увидеть diff до применения
Apply	provider применяет изменения и пишет журнал	чтобы был rollback и проверяемый результат

=== "Открытая бета: все семь харнессов"

Claude Code, Codex, Grok Build, Pi, OpenCode, Cursor и Antigravity
выпускаются вместе. Найти сетап, проверить совместимость, увидеть план и
применить через provider. Отсутствующее доказательство помечается
`not_verified`; харнесс из продукта не вычёркивается.

=== "undefined"

Этот режим нужен, чтобы не терять объект, когда харнесс неизвестен. Он
подходит для чтения, импорта и локального анализа, но не для уверенной
автоматической установки.

??? question "Почему сетап принадлежит одному харнессу" Потому что одинаковые слова в разных CLI часто означают разные файлы, права и события. skill для Codex и skill для Claude Code могут иметь похожий смысл, но разные нативные поверхности. Поэтому сетап создаётся для одного харнесса, а перенос делается через явную новую версию или адаптацию.

Что оказывается на диске у семи харнессов

ai_stp не копирует файлы в target. Сборщик строит нативный пакет; provider его записывает. Точные пути на машине даёт ai-stp component discover --json (source_path, layout_source) и план provider. Виды, которые discovery будет искать:

Вид	Claude Code	Codex	Grok Build
`instruction`	global и project	global и project	нативный layout инструкции не объявлен
`skill`	global и project	общий skill (включая `.agents/skills`)	global и project
`mcp`	global и project	имена внутри файла настроек (`config.toml`), если есть ключ `mcp_servers`	имена внутри `config.toml`, если ключ есть
`hook`	в матрице discovery нет top-level layout	project: `.codex/hooks.json` или `hooks/hooks.json` внутри доказанного plugin	global и project
`command`	global и project	global command/prompt	общий command, global
`agent`	global и project	project: `.codex/agents`	нативный layout агента не объявлен
`plugin`	global и project; pack — plugin только через `.claude-plugin/plugin.json`	корень plugin, skill и hooks-directory; pack через `.codex-plugin/plugin.json`	global и project; `plugins/marketplaces` — не plugin
`setting`	global и project	global и project (`config.toml`)	global и project (`config.toml`)

Каталог plugins/ без манифеста поддерживаемого харнесса не является plugin. CODEX.md — не официальный layout инструкции Codex; discovery возвращает unsupported_manifest и указывает на AGENTS.md.

Общие .agents/skills не принадлежат ни одному харнессу и возвращаются с harness_id=null.

После apply подтвердите:

ai-stp target status --project <id> --harness <id> --json
ai-stp target diff --project <id> --harness <id> --json

Официальная документация харнессов

Это документация вендоров, а не страницы ai_stp. Layouts, с которыми ai_stp будет работать, — только те, что component discover вернул с layout_source.

Харнесс	Официальная документация
Claude Code	документация Claude Code
Codex	документация ChatGPT / Codex (нативный файл инструкции: `AGENTS.md`)
Grok Build	документация xAI Build
Pi	документация Pi
OpenCode	документация OpenCode
Cursor	документация Cursor
Antigravity	документация Antigravity

Если классификация неясна, покажите поле layout_source из component discover. Не выдумывайте путь только потому, что соседний харнесс так устроен.

Как выбрать target

Запустите ai-stp doctor --json.
Проверьте, какой харнесс обнаружен: ai-stp toolchain harnesses --json.
Откройте сетап или компонент в каталоге.
Сверьте поддержку харнесса и линию доверия.
Смотрите provider-план до применения.

ai-stp doctor --json
ai-stp toolchain harnesses --json
ai-stp toolchain harness-capabilities --json

!!! tip "Для MVP" Если вы не уверены, начинайте с Claude Code, Codex или Grok Build. Для beta-линий сохраняйте план установки и не удаляйте backup до проверки результата.

Связанные страницы

Понятия — что такое харнесс, в отличие от сетапа.
Быстрый старт для человека — первый запуск, когда программы нет.
Программа harness — поставить бинарник, не сетап.
Provider — единственный писатель нативного состояния.
Компоненты — какие виды принимает каждый харнесс.
Сетапы — сетап принадлежит одному харнессу с создания.
Диагностика — undefined не ставится сам.