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

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

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

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

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

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

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

Управление ИТ-проектом с агентами связывает порядок задач с приёмкой и пересмотром очереди после изменений.

Контекстное окно нейросети ограничивает объём материалов для одной задачи агента.

Свежая статья 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, чтобы правила жили в одном месте.

Понять, с чего начать в вашей команде, поможет бесплатный звонок на 30 минут.

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

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

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

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

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

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