Как связать курс со своим инструментом

Если вы уже используете агентский CLI или IDE, начните с его имеющихся возможностей. Необязательно писать заново хранение сессий, подтверждения команд или чтение правил проекта. Внешнему harness нужны те части процесса, которых вашему инструменту и CI не хватает.

Вместо таблицы названий флагов проверьте поведение установленной у вас версии. Поддержка режимов и формат журналов меняются; пробный запуск даст более надёжное основание для адаптера.

Что проверить у backend

Часть процесса	Практическая проверка
Правила проекта	Какой файл инструмент читает, откуда и с каким приоритетом? Проверить на безопасной отличимой инструкции.
Запуск без диалога	Можно ли передать задачу из runner и дождаться кода завершения? Что произойдёт при запросе подтверждения?
Рабочая папка	Какие файлы доступны процессу? Ограничивает ли настройка доступ или только задаёт текущую директорию?
Права инструментов	Как запрещается команда или внешний вызов? Что получает runner при отказе?
Контекст	Какие материалы передаются модели и как проверить их версии?
Журнал	Есть ли события инструментов, ошибки и результат? Какие данные туда попадают?
Остановка	Можно ли задать тайм-аут и завершить дочерние процессы?
Повтор	Продолжает ли инструмент сессию или создаёт новую? Какие изменения уже остались?
Интеграции	Какие параметры получают подключённые инструменты и какие права используют?

Файлы AGENTS.md, CLAUDE.md или правила IDE могут выполнять похожую роль, но не следует считать их приоритеты и охват одинаковыми. Запишите фактическое поведение выбранного backend в документации адаптера.

Первая интеграция

Возьмите одну маленькую задачу с известной проверкой. Подготовьте отдельную рабочую копию, вызовите backend из runner и сохраните его результат. Затем выполните принятый набор тестов над итоговыми файлами и сформируйте отчёт о запуске.

Повторите с отсутствующим контекстом, отказом в доступе и тайм-аутом. Пока эти случаи не различимы, подключать очередь задач рано: она усложнит поиск причины.

Если backend обращается к облачной модели, предусмотрите разрешённое соединение и состав передаваемых данных. Песочница для исполняемого кода и канал вызова модели могут иметь разные сетевые правила.