Содержание статьи
  1. Чем ТЗ отличается от запроса к нейросети
  2. Что подготовить перед составлением ТЗ
  3. Из каких разделов собрать ТЗ для приложения
  4. Пример ТЗ: сохранение проекта
  5. Как написать критерии приёмки
  6. Шаблон ТЗ для своего проекта
  7. Как попросить нейросеть подготовить и проверить ТЗ
  8. Как передать ТЗ в разработку и обновлять требования
  9. Частые вопросы

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

Я столкнулся с этим при создании Креатора. У меня были макеты, описание функций и требования, подготовленные с помощью Claude. Дальше я передавал задания в Figma Make и исправлял результат. Как писал в разборе разработки MVP, даже подробное описание экранов оставляло вопросы о техническом устройстве продукта.

Здесь разберём, что включить в документ для разработки приложения с ИИ. Все шаблоны ниже составлены для статьи. Их можно адаптировать под проект; это не исходное ТЗ Креатора и не описание его сегодняшнего кода.

Чем ТЗ отличается от запроса к нейросети

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

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

Так проще замечать расхождения. Если в ТЗ записано, что черновик сохраняется после обновления страницы, можно проверить, выполнил ли ИИ это условие. Если требование осталось только в старом сообщении чата, его сложнее найти и сопоставить с результатом.

Для небольшой правки достаточно короткой задачи: например, изменить подпись кнопки на конкретном экране. Для функции с данными и несколькими состояниями полезно отдельно записать требования. Объём зависит от сложности задачи: количество страниц само по себе ничего не подтверждает.

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

Что подготовить перед составлением ТЗ

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

Затем соберите исходные материалы. Подойдут макет, описание существующей функции, список полей, известная ошибка или ограничения проекта. Рядом укажите, что каждый материал означает: макет показывает расположение элементов, таблица — состав данных, а текст — правила поведения.

Если материалов несколько, определите, какой источник считать актуальным. Например, «названия полей берём из этого документа, макет используем для расположения, старый скриншот — только как справку». Иначе противоречия придётся разрешать во время реализации.

Наконец, выпишите неизвестные условия. Где хранятся данные? Нужно ли несколько пользователей? Есть ли ограничения выбранной платформы? Ответ «пока не решили» полезен, если рядом понятно, что нужно выяснить до разработки.

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

Из каких разделов собрать ТЗ для приложения

Для одной функции я бы начал с такой структуры:

РазделЧто записатьКак проверить полноту
ЦельКому и зачем нужна функцияМожно назвать наблюдаемый результат
ГраницыЧто входит в эту версию и что отложеноПонятно, какие пожелания пока не реализуются
СценарийДействия человека от начала до результатаНет необъяснённых переходов
ДанныеПоля, обязательность, сохранение, владелецПонятно, что происходит после перезагрузки
СостоянияПустой экран, загрузка, успех, ошибкаПользователь понимает, что происходит
ДоступКто читает и меняет записиОпределена проверка чужого доступа
ОграниченияЧто сохранить в существующем проектеАгент знает границы изменений
ПриёмкаНабор действий и ожидаемых результатовУсловия можно проверить
Открытые вопросыЧто ещё предстоит решитьНеизвестное не замаскировано под готовое решение

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

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

Пример ТЗ: сохранение проекта

Возьмём функцию небольшого веб-приложения: пользователь создаёт проект с описанием идеи. Это пример требований для статьи, а не инструкция по восстановлению Креатора.

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

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

Входит в задачу:
— форма создания;
— сохранение проекта;
— показ записи в личном списке;
— повторное открытие.

Пока не входит:
— совместный доступ;
— вложения;
— генерация рекомендаций;
— платежи.

Поля:
— название: обязательно, строка из одних пробелов не подходит;
— описание: необязательно;
— владелец определяется системой по текущему пользователю.

Поведение:
1. Пользователь заполняет форму и нажимает «Сохранить».
2. Приложение проверяет поля.
3. Во время запроса показывает состояние сохранения.
4. После успешной записи показывает проект в списке.
5. При ошибке сохраняет введённый текст и даёт повторить действие.

Данные и доступ:
— запись хранится на сервере и принадлежит создавшему её пользователю;
— другой аккаунт не может прочитать или изменить запись;
— перезагрузка страницы не удаляет проект;
— тот же пользователь видит проект при входе с другого устройства.

Ограничения:
— не менять существующий вход и соседние разделы без согласования;
— не добавлять сервисы с новыми расходами без согласования;
— если текущий проект не поддерживает эти условия, сообщить до правок.

До реализации уточнить:
— пределы длины полей;
— место хранения и существующие правила доступа;
— как обрабатывать повторный запрос, чтобы не создать дубликат.

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

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

Как написать критерии приёмки

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

Для примера выше подойдёт такая матрица:

Условие и действиеОжидаемый результат
Отправить название из пробеловПоявляется подсказка, проект не создаётся
Сохранить корректный проектЗапись появляется в личном списке
Обновить страницуСохранённая запись остаётся доступной
Повторить отправку одного запросаНе появляется второй экземпляр проекта
Смоделировать отказ сохраненияВидна ошибка, введённый текст остаётся
Открыть запись под другим тестовым аккаунтомСистема отклоняет чтение и изменение чужой записи
Войти тем же пользователем с другого устройстваПроект доступен из серверного хранилища

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

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

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

Шаблон ТЗ для своего проекта

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

Название и версия документа:
Дата последнего изменения:

1. Пользователь и ситуация
Кто выполняет действие? Что пытается получить?

2. Результат
Что должно появиться или измениться после действия?

3. Границы
Что делаем сейчас? Что отложено?

4. Исходные материалы
Ссылки на макеты, описание проекта и актуальные правила.
Какой источник важнее при противоречии?

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

6. Данные и доступ
Поля, обязательность, сохранение, владелец, разрешённые действия.

7. Ограничения
Что нельзя менять? Какие зависимости уже используются?

8. Приёмка
Условие → действие → ожидаемый результат.

9. Открытые вопросы
Что неизвестно? Какие ответы нужны до начала реализации?

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

Как попросить нейросеть подготовить и проверить ТЗ

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

Помоги подготовить ТЗ на одну функцию приложения.
Ниже — мои заметки, ограничения и исходные материалы.

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

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

Пока не пиши код и не меняй проект.

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

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

Практика конкретных заданий с проверяемым результатом описана и в рекомендациях Claude Code. Её можно применять к своему рабочему процессу без попытки найти единственный универсальный промпт.

Как передать ТЗ в разработку и обновлять требования

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

Короткое задание может выглядеть так: «Прочитай ТЗ версии 2. Изучи форму и сохранение проектов. Реализуй проверку названия и сообщение об ошибке. Остальные правила сохрани. После изменения покажи выполненные проверки и то, что пока проверить не удалось».

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

В полном практикуме по созданию приложения разбираю дальнейшие шаги: реализацию, проверку данных, исправления и тестовую публикацию. Здесь важно сохранить одну опору для всех этих этапов — актуальные правила продукта.

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

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

Можно ли поручить нейросети написать ТЗ целиком?

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

Нужно ли сразу выбирать язык программирования и базу данных?

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

Подойдёт ли один шаблон для Claude Code и платформы-конструктора?

Общую часть — цель, сценарий, данные и приёмку — можно использовать в обоих случаях. Задание на реализацию адаптируйте к возможностям выбранного инструмента. Если он не поддерживает важное требование, нужно изменить решение или выбрать другой путь.

Сколько страниц должно быть в ТЗ?

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

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