Harness engineering: как построить надёжного AI-агента
Статей: 8
Harness engineering (харнес-инжиниринг) — дисциплина о том, как построить вокруг языковой модели окружение, в котором AI-агент надёжно выполняет реальную работу. Формула темы: Агент = Модель + Харнес. Одна и та же модель в одном проекте работает как опытный разработчик, а в другом теряет контекст и рапортует о готовности неработающей фичи — разница почти всегда в харнесе, а не в модели.
Это руководство — карта темы. Здесь собраны ключевые понятия и порядок, в котором удобно их осваивать. Каждая тема подробно разобрана в отдельной статье.
Пять подсистем харнеса
- Инструкции — файлы CLAUDE.md и AGENTS.md, тематические документы и skills: что агент знает о проекте.
- Инструменты — shell, правка файлов, браузер, MCP-серверы: чем агент действует.
- Среда — песочница, контейнер, изолированная рабочая копия: где агент запускает команды.
- Состояние — файлы плана и прогресса, git-история: память между сессиями.
- Обратная связь — тесты, линтеры, хуки, независимый проверяющий: как агент узнаёт о своих ошибках.
Подсистемы образуют замкнутый контур. Убрать любую — и контур размыкается: без проверок агент не видит ошибок, без состояния каждая сессия начинается с нуля.
С чего начать
Если тема новая, начните со статьи о том, что такое harness engineering и чем он отличается от промпт- и контекст-инжиниринга. Короткое определение с примером — в статье про харнес агента.
Дальше переходите к практике. Первый файл, с которым сталкивается каждый, — инструкции проекта: что писать в CLAUDE.md и AGENTS.md, чего не писать и почему агент игнорирует правило, которое прямо записано в файле.
Когда агент уже работает в проекте, встаёт вопрос надёжности. Пошаговый план ведёт от журнала провалов и метрик MTBF и MTTR через дешёвый откат, петли обратной связи и память в файлах к автономному циклу, в котором агент работает часами без присмотра.
Главные принципы
- Агент не сломан — сломано окружение. Сначала ищите дыру в харнесе, а не меняйте модель.
- Начинайте с обратной связи: команда проверки даёт больше, чем страница инструкций.
- Инструкции — карта, а не учебник: короткий входной файл и подробности по требованию.
- Важное живёт в файлах, а не в окне контекста.
- Измеряйте: журнал провалов вместо ощущений.
Все подсистемы и сборка харнеса целиком разобраны на практике в курсе по харнес-инжинирингу.