ТЗ для кодингового агента: как написать так, чтобы создать результат, а не косячный код

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

Чтобы сократить количество ситуаций, когда агент косячит (убрать их полностью пока невозможно), важен не только сам процесс, но и то, что предшествует ему. И тут мне хочется отметить роль правильно написанного ТЗ. По моему опыту, хорошо описанное ТЗ и работа с ним закрывают 80% проблем, которые возникают у кодинговых агентов. Сегодня делюсь тем, как надо и как не надо его писать.

Выбирайте стек и формат реализации сами
Даже если не шарите за языки программирования - погуглите, что и для чего используется. Ваша цель - выбрать более популярный язык и формат реализации. Почему? Потому что в нем больше примеров, на которых ИИ обучался. Например, реализовать что-то на React будет гораздо проще, чем пилить условный Telegram Mini-App, т.к. последние появились не так давно.

Продумайте UJM
Как минимум - базовые сценарии. Да, можно в процессе подправить, но у LLM есть один недостаток - они часто не убирают старую логику при добавлении новой. Результат - сломанный код и кривой User Journey.

Потратьте время на продумывание состояний
LLM неплохо продумывают стейты, но неидеально. Особенно в контексте ТЗ. Мой совет - нарисовать себе заранее схему возможных, критичных для вас состояний создаваемого приложения, а затем убедиться, что все они включены в ТЗ.

Разбейте ТЗ на этапы
Самое простое - сделать в соответствии с UJM. Цель - чтобы после каждого этапа вы могли потрогать результат. Так мы обеспечиваем себе больше контроля и отлавливаем ошибки на самом раннем этапе.

Не отдавайте задачу ИИ втупую
Если делать в формате одного сообщения - получите ТЗ с кучей недочетов. Ваша задача - коллаборировать, а не делегировать. 1 этап - всегда сетап окружения, 2 и последующие - в соответствии с вашим UJM.

На хорошее ТЗ, набив руку, вы потратите максимум час, без него - AI агент сожрет десятки ваших часов, а месячный лимит токенов вы потратите за один вечер.

Не забудьте залететь на эфир по ИИ прототипированию в следующий вторник, мой бот напомнит об эфире, а также пришлет вам ссылку и запись, если не сможете быть онлайн.

👉🏻 Записаться на эфир