Задачу для ИИ-агента пишут иначе, чем программисту: шаблон и десять настоящих задач

Почему хватило двух слов и ссылки? ТЗ программисту несёт всё сразу: что за проект, как здесь принято, как проверить и что сделать сейчас. Агенту каждый раз нужна только последняя часть.

У агента нет памяти между задачами. Чего нет в файлах, которые он читает, того для него не существует. Поэтому постоянное записывают один раз, в эти самые файлы.

Подрядчику-человеку подробное ТЗ по-прежнему нужно. Это договор о том, что считать сделанным. У агента договор другой: правила и проверки в репозитории, а задача называет только, что сделать сейчас.

«Сделай карточку» у нас значит одно и то же для любого инструмента. Рецепт карточки лежит в репозитории с середины августа: где искать факты и какие разделы обязательны. Поэтому задаче хватает двух слов и ссылки.

Документов в нашем репозитории почти столько же, сколько кода: 934 тысячи строк против миллиона (замер 4 октября). Главный из них — файл правил, который агент читает первым. Такой файл уже ищут, «agents md» по Wordstat набирает 1 531 запрос в месяц.

Что тогда писать в самой задаче? Ровно то, чего нет в правилах. Руководства на русском учат ставить задачу человеку: так устроены статья на Хабре 2022 года и справочник robotbull.

Свежая статья mysummit учит ИИ писать ТЗ для людей, а задачу для агента, который сам пишет код, в первой выдаче не разбирает никто. Поэтому шаблон ниже мы собрали из своих задач того же ряда в 115.

Anthropic в руководстве по Claude Code советует то же своими словами: назвать симптом, вероятное место и как выглядит «исправлено». Первым советом там стоит другое — дать агенту проверку, которую он запустит сам.

Формата файла, места хранения и имени ветки в задаче нет, их знают правила. Слово «канон» здесь значит правило проекта. Агент дописал его сам, и следующим карточкам без своего логотипа поставит знак компании-разработчика.

Четвёртая вещь защищает от необратимого. 9 сентября агент получил бриф, где один шаг ждал команды, и прочёл «по сигналу» как разрешение на весь бриф. Он переключил сайт на новый сервер раньше времени.

Вреда не было, сервер был готов. С тех пор у каждого необратимого шага в задаче своё стоп-слово, а деньги, ключи, данные людей и публикации наружу агент без человека не трогает вовсе.

Ниже десять задач из ряда в 115, который мы публикуем на странице открытых цифр. Сообщение в чате, что сделал агент и сколько прошло до прода. Реплики сократили и поправили орфографию, смысл не меняли.

Быстрее всех доехали симптом и выбор. Вся задача звучала так: «чёт я нажимаю, и ничего не происходит». Агент работал над этой страницей в той же сессии и через 4 минуты починил раскрытие разделов карты, а следом добавил проверку, чтобы поломка не вернулась.

«Давай матрёшек» — выбор из четырёх обложек, которые агент показал до этого. Ушло 8 минут.

Медиана 25 минут, быстрее часа 64 % задач. Девять из десяти уложились в шесть часов. В эти минуты входят чтение правил, проверки и влитие, а не только набор кода.

Почему одни задачи идут минуты, а другие сутки? Сначала посмотрите на одинаковые. Пятнадцать раз инженер просил агента сделать карточку и давал адрес, слова почти не отличались.

Быстрее всех собрались карточки Kodify и Veai, дольше всех — Replit Agent и GitHub Copilot. Даже самая долгая шла 4 часа, а не неделю.

Дольше суток шли только открытые задачи. Таких пять из 115, и во всех «готово» решал показ. Их формулировки: «посмотрим, что получается», «посмотрю, что выходит».

Это не ошибка, так ищут новый вид страницы. Но это поиск, а не задача, и ему стоит дать лимит кругов или дату показа.

Что писать в строке «готово». У нас встречаются два вида признаков: что видно на экране, как «дата не прижата к крошкам на телефоне», и какая проверка позеленеет. Оба агент проверит сам.

Классический критерий приёмки из учебников аналитика — «Дано, Когда, Тогда». Агенту он тоже годится: из такого критерия агент может сам написать автотест.

Кто проверяет критерий? Не тот, кто делал. Карточку Veai принимал второй агент с чистым контекстом: он не видел, как её писали, и сверял каждый факт с собранными источниками.

Первый прогон вернул карточку с семью замечаниями. Среди них «внутренний замер» двух моделей, которого в собранных фактах не было: писатель его выдумал.

Задача на починку звучала коротко, «почини блокеры сам». Через 46 минут исправления были на сайте. Но выдумка около часа провисела там: в тот вечер приёмку запускали впервые, уже после выкатки.

Правило вышло той же ночью. Приёмника запускает сам писатель, до влития, а протокол приёмки ложится в описание правки. Прогон теперь один, а контрольный — только если чинили факты.

23 августа агент собрал фото на карточке в карусель, хотя у соседних карточек был коллаж. Ответ был не «переделай», а вопрос: «Вижу косяк! Ты должен был применить фотогрид, как в Яндекс Станции. Где нужно поправить мозг писателя карточек?». Мозгом у нас зовут рецепт, по которому агент пишет карточки.

Через 18 минут на карточке стоял коллаж, а в рецепте — строка о нём. Следующие карточки собирались уже с ней, и задачу никто не переписывал.

Правило живёт там, где падает проверка, а не там, где записано. Этот вывод мы записали в журнал после случая 17 июля.

Раздувать файл правил тоже не надо. Anthropic советует спрашивать про каждую строку, ошибётся ли агент без неё: в раздутом файле агент начинает пропускать важное.

Четыре шага на первую неделю, без найма и без нового процесса.

Codex читает AGENTS.md сам. Claude Code читает CLAUDE.md, и в нём можно одной строкой подключить тот же AGENTS.md, чтобы правила жили в одном месте.

Понять, с чего начать в вашей команде, поможет тест для руководителя: десять вопросов и три шага на неделю.

Если правила писать некому, есть подписка на агентную разработку. Вы присылаете задачу словами, правка на проверке за рабочий день, вливает ваш разработчик.

1. Задача агенту укладывается в одну фразу с четырьмя вещами: что сделать, где, когда готово и докуда можно без спроса.

2. Всё постоянное — один раз в файл правил, а не в каждую задачу.

3. Задача без признака «готово» превращается в поиск. Дайте ему критерий или лимит кругов.

4. «Готово» проверяет не автор правки, а последним смотрит человек, который вливает.

5. Агент сделал не то — допишите строку в правила, а задачу не переписывайте.