ИИ для технического задания: никогда не пишем код сразу

Опубликовано 15.11.20269 мин чтенияСредний
Артемий Миллер в кепке с логотипом Claude Code рядом с надписью «НЕ ПИШЕМ КОД СРАЗУ» и такими же логотипами.
Что узнаешь
  • Какие ответы нужны ИИ до составления требований
  • Как связать пожелания, решения и критерии приёмки
  • Как проверить готовность задания к реализации
Средний
9просмотров

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

Раньше у меня была проблема: пишешь код - он не работает. План не продуман. Решение так себе. Чтобы написать 1 функцию, уходила куча времени на переделки. Я каждый раз руками просил Claude Code: составь план, проверь план.

Разберём доработку существующего продукта: что нужно выяснить до передачи задания исполнителю.

Шаг 1. Что дать ИИ, чтобы он не придумал задачу за вас

Попросите ИИ сохранить ваш монолог дословно, отдельным блоком, как надиктовали. Это исходник, его не правим и не причёсываем.

Рядом запишите, чью проблему решаете и что система будет делать вместо человека. Добавьте текущий процесс, пользователей, права и доступные материалы. Если код уже есть, поручите ИИ изучить его структуру.

Дальше - условный пример: вводные и ответы владельца придуманы для разбора метода. Это не мой проект и не результат запуска ИИ.

Исходник сохраняем целиком:

В моём сервисе уже есть список заявок. Хочу выгружать выбранные заявки в CSV, только свои данные. Хочу, чтобы было понятно, что выгрузка идёт. Повторное нажатие не должно плодить выгрузки. Если что-то упало - хочу повторить, не потеряв исходный список. Ещё хочу отправку по расписанию на почту.

Запрос для этого шага:

Сохрани исходник без правок. Выдели цель и известные сведения о текущем продукте. Не добавляй функции, сроки и пороги. Задавай по одному вопросу, без ответа на который нельзя выбрать решение; известное не переспрашивай. Пока не составляй окончательное ТЗ и не пиши код.

Больше про ИИ-агентов - в канале:

Шаг 2. Какие вопросы задать до технического задания

Уточняем только то, без чего нельзя выбрать решение. Задаём 1 вопрос и ждём ответа. Уже известное не переспрашиваем.

О1-О8 - условные ответы владельца. Для своего продукта вы даёте их сами.

В1: Что сейчас делают со списком и что нужно получить вместо этого?

О1: строки уже можно просматривать и выбирать; сейчас их переписывают вручную. Нужен файл выбранных строк.

Значит, дорабатываем имеющийся список, новый учёт заявок не строим.

В2: Кто запускает выгрузку и что считается своими данными?

О2: вошедший пользователь выгружает только свои заявки. Чужие недоступны и при прямом запросе.

Проверить только кнопку недостаточно: попробуем запросить чужие данные напрямую. Права администратора не придумываем.

В3: Какие поля и строки должны оказаться в CSV?

О3: выбранные собственные заявки; номер, название и состояние; порядок списка.

Из О2 и О3 получаем требование: пользователь выгружает выбранные собственные заявки с номером, названием и состоянием, в порядке списка. Работает ли выгрузка, проверим после реализации.

В4: Что означает «понятно, что идёт»? Есть согласованное время ожидания?

О4: во время выгрузки видно «Готовим файл», после успеха доступно скачивание. Числовой срок пока не задан.

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

В5: Что происходит при повторном нажатии, пока файл готовится?

О5: новая выгрузка не начинается, остаётся текущее состояние.

В проверку включаем повторное нажатие во время подготовки файла.

В6: Что сохраняется при сбое и когда можно повторить?

О6: видно «Не удалось подготовить файл»; заявки и выбор остаются. После устранения сбоя повтор запускается. Частичный файл недоступен.

В7: Почта и расписание нужны для первого полезного результата?

О7: сначала файл из списка. Почта и расписание - следующая версия; получатель и правила расписания ещё не решены.

Почту и расписание сохраняем с причиной переноса.

В8: На каких данных проверяем, что нельзя менять и что мешает старту?

О8: тестовые заявки 2 пользователей, без настоящих клиентских данных. Список и права не менять. Начинать можно после подтверждения доступного способа сформировать CSV. Сроки и предельный объём обсудить отдельно.

Кто что может:

  • Пользователь выгружает выбранные собственные заявки.
  • Другой пользователь не получает чужие данные или файл.
  • Агент предлагает формулировку, владелец утверждает решение.

Почему Claude делает не то, что вы просили, разбираю в отдельной статье.

Шаг 3. Как не потерять ни одного пожелания

У каждого требования должно быть место в плане или открытый вопрос. Отнесите его к первой или следующей версии. Ничего молча не выкидывайте.

Для сверки соберём таблицу: П1-П6 - пожелания из исходника, Т1-Т6 - требования, К1-К5 - проверки.

Исходное пожеланиеУточняющий вопросРешение владельцаТребованиеВерсия или фазаКритерий проверки
П1: выбранные заявки в CSVВ1, В3: процесс, поляО1, О3: выбранные строки; номер, название, состояние; порядок спискаТ1: согласованные строки и поля в CSVПервая, выгрузкаК1: файл совпадает с выбранными данными
П2: только свои данныеВ2: праваО2: только свои при любом запросеТ2: отказ в выгрузке чужих заявокПервая, выгрузкаК2: отказ без чужих данных и файла
П3: понятно, что идётВ4: состояние, времяО4: «Готовим файл», затем скачивание; срока нетТ3: показать состояние и итогПервая, выгрузкаК5: состояния видны; время ещё не согласовано
П4: без дублейВ5: повторО5: не начинать новую выгрузку до завершения текущейТ4: повтор без новой выгрузкиПервая, выгрузкаК4: нет второго процесса и файла
П5: повтор без потери спискаВ6: сбойО6: сообщение, заявки и выбор сохранены; повтор после сбояТ5: сохранить данные и повтор, не выдавать частичный файлПервая, выгрузкаК3: ошибка, затем успешный повтор
П6: расписание и почтаВ7: нужны ли сейчасО7: перенос; получатель и расписание не решеныТ6: сохранить пожеланиеСледующая, фаза не назначенаНужны решения владельца и критерий

О8 относится ко всей доработке: используем тестовые данные, не меняем список и права, до начала реализации подтверждаем способ формирования CSV.

Пройдите исходник от П1 до П6: каждому нужно место или открытый вопрос. Затем от Т1 до Т6: из какого пожелания и ответа выросло требование? Цель - 0 потерянных пожеланий и 0 требований без источника.

Если модель добавила функцию, пометьте: «Предложение ИИ, решение владельца не получено». Без решения её не включаем в работу. Для реализации Т6 тоже пока не хватает данных.

Шаг 4. Как превратить «всё должно работать» в приёмку

Каждое правило должно быть проверяемым. Никаких лозунгов вроде «пиши чистый код».

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

К1. Вместо «выгрузка удобная» - состав файла из О1 и О3, требование Т1.

Условие: пользователь выбрал собственные тестовые заявки с известными значениями. Действие: выгрузить и открыть CSV. Результат: только выбранные строки, согласованные поля и порядок; исходные заявки не изменились. Сравниваем файл с тестовым списком.

К2. Вместо «данные защищены» - отказ по О2, требование Т2.

Условие: заявки принадлежат разным тестовым пользователям. Действие: запросить чужие заявки напрямую. Результат: отказ без чужих данных и файла. Проверяем, что запрос отклонён и чужие строки не получены.

К3. Вместо «если упало, можно повторить» - проверка по О6, требование Т5.

Условие: тестовый сбой прерывает подготовку файла. Безопасный способ вызвать его согласуйте с исполнителем. Действие: запустить выгрузку, получить сбой, устранить его и повторить запуск.

Результат: сначала видно «Не удалось подготовить файл», частичный файл недоступен, заявки и выбор сохранены. После повтора - файл по К1. Проверяем сообщение, список, выбор и содержимое файла.

К4. Повтор во время подготовки, О5 и Т4. Условие: файл готовится. Действие: нажать повторно. Результат: остаётся текущее состояние, новая выгрузка не начинается. Проверяем отсутствие дополнительного процесса и файла.

К5. Состояние выгрузки, О4 и Т3. Условие: выбраны свои тестовые заявки. Действие: запустить выгрузку. Результат: сначала «Готовим файл», после успеха можно скачать CSV. Проверяем смену состояния и доступность файла.

Кстати, я снял ролик «Полная схема по Hermes Agent: 13 ИИ-агентов для бизнеса», обязательно посмотрите.

Видео загрузится при скролле
Полная схема по Hermes Agent: 13 ИИ-агентов для бизнеса

На 04:45 - «Сделай мне функцию», на 05:23 - «От вопросов до автотестов». Посмотрите, как агент проходит путь от вопросов до проверки кода.

Намеренно ошибочный пример: «CSV готов за 3 секунды». Число придумано для разбора: в О4 владелец не задал срок. Оставляем состояния К5, а время подготовки и условия его измерения уточняем. Сроки не выдумываем.

Запрос для подготовки проверок:

Для каждого утверждённого требования предложи исходное условие, действие и наблюдаемый результат. Укажи номер требования и ответ, из которого оно следует. Отдельно проверь успех, отказ по правам, повтор и ошибку. Не добавляй сроки и лимиты. Если решения нет, оставь вопрос; не объявляй такой критерий готовым.

Согласованное задание - начало проекта. Для работы с ИИ-агентами посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Что войдёт в первую версию, а что пока не получим

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

В примере это ручная выгрузка Т1-Т5 с правами, состояниями, повтором и обработкой ошибок. Кнопки без работающего сценария недостаточно.

Почта и расписание Т6 - следующая версия по О7. Переделка списка и изменение прав исключены по О8: чтобы включить их в работу, нужно отдельное решение владельца.

Перед кодом подтвердите, что CSV можно сформировать доступными средствами. Затем владелец решает, можно ли начать без согласованных ограничений на объём и время подготовки.

Как проверить задание перед передачей исполнителю

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

Для исходного ТЗ можно собрать такое оглавление:

  • Исходный текст и цель.
  • Текущий продукт и доступные материалы.
  • Роли и сценарии.
  • Требования с номерами и источниками решений.
  • Первая версия, переносы и исключения.
  • Ограничения и нерешённые вопросы.
  • Критерии приёмки.
  • Порядок работы и журнал решений.

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

Если уже выбрали Spec Kit, его настройку в Claude Code смотрите в отдельной статье.

Перед передачей проверьте:

  • Каждое пожелание попало в требования или открытые вопросы.
  • У каждого требования есть источник и ответ владельца.
  • Версии и исключения согласованы с исходником.
  • Для текущей версии описано, как проверять результат.
  • Предложения модели отделены от утверждённых решений.
  • Вопросы, без которых нельзя начать работу, решены владельцем.
  • Владелец подтвердил, что задание решает исходную проблему.

При любом «нет» возвращаемся к вопросу или формулировке. В нашем примере код писать пока нельзя: проверки описаны, но способ сформировать CSV ещё не подтверждён.

Финальный запрос агенту:

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

Теперь проверьте: задание решает вашу проблему или получился «план для плана»? Делаем то, что вы хотите, или то, что модель додумала?

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

Какое пожелание в вашем текущем ТЗ пока нельзя проверить действием? Напишите в комментариях в канале.

Частые вопросы

Источники

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

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

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные инструкции

OpenCode AGENTS.md: какой инструктаж получил агент - перепроверь сам

OpenCode объединяет найденные AGENTS.md без автоматического разрешения противоречий. Проверьте корневой и вложенный файлы раздельными метками и сравните поведение в текущей и новой сессиях.

8 мин

ИИ для бухгалтера: собери первичку и проверь по документам

Начните с реестра обезличенных счетов и сверки каждого поля с документом. ИИ собирает черновик, бухгалтер принимает результат и разбирает нерешённые расхождения.

9 мин

Самообучающийся ИИ: стало лучше или стало хуже?

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

7 мин

ИИ для тестирования: после правки проверяем весь путь

Поручите ИИ подготовить и сохранить проверки важных функций, затем повторяйте тот же набор после правки. Сравнивайте результат с согласованным ожиданием и открывайте отчёт перед приёмкой.

8 мин