Как написать ТЗ коротко: сформулируйте цель, опишите сценарии пользователей, проведите границу «входит / не входит», зафиксируйте данные и технические ограничения, разбейте работу на этапы и для каждого запишите проверяемые критерии приёмки. Потом перечитайте ТЗ глазами исполнителя и закройте все места, где он задал бы вопрос.
Ниже — семь шагов с вопросами, которые стоит задать на каждом. Готовый шаблон и образец заполнения — на странице пример и шаблон ТЗ. Если исполнитель — кодинг-агент, смотрите также ТЗ для нейросети.
Шаг 1. Цель в одну-две фразы#
Запишите, что должно появиться и что изменится после запуска. Не «сделать сайт», а «клиенты сами записываются на приём, мастер не тратит вечер на переписку».
Вопросы к себе или заказчику:
- Какую проблему решаем?
- Как поймём через месяц, что проект помог?
- Что будет, если ничего не делать?
Если цель не помещается в две фразы, скорее всего, это несколько проектов. Выберите первый.
Шаг 2. Пользователи и сценарии#
Перечислите роли (клиент, администратор, менеджер) и для каждой — сценарии в формате «действие → результат». Сценарий — главная единица ТЗ: из него потом выводятся экраны, данные и проверки.
Клиент:
- выбирает услугу → видит свободное время на 14 дней;
- вводит имя и телефон → видит подтверждение с датой.
Опишите и неудачные ветки: что видит пользователь, если время занято, поле не заполнено, сервис недоступен. Именно их чаще всего забывают.
Шаг 3. Граница: что входит и что не входит#
Составьте два списка. «Входит» — функции, без которых первая версия не имеет смысла. «Не входит» — всё, что обсуждали, но отложили: оплата, личный кабинет, мобильное приложение.
Этот шаг экономит больше всего нервов. Исполнитель-человек по списку «не входит» понимает, где кончается оплаченная работа. ИИ-агент — что не нужно «улучшать» по своей инициативе.
Шаг 4. Данные и интерфейс#
Для каждой сущности (заказ, запись, пользователь) перечислите поля и отметьте обязательные. Укажите, откуда данные берутся и где хранятся.
Для интерфейса достаточно списка экранов по порядку: что на каждом, какие состояния (пусто, загрузка, ошибка), как выглядит на телефоне. Если есть макет или скриншот похожего сервиса, приложите: картинка точнее слов «современный дизайн».
Шаг 5. Технические требования#
- Стек, если он важен: на чём проект будет жить и кто его будет поддерживать.
- Хостинг и интеграции: платёжный сервис, почта, CRM, мессенджер.
- Безопасность: кто к чему имеет доступ, где хранятся ключи и пароли.
- Ограничения: бюджет на сервисы, запрет на новые зависимости без согласования.
Если стек не важен, так и напишите: «на выбор исполнителя, с обоснованием». Это тоже решение.
Шаг 6. Этапы#
Разбейте работу на этапы так, чтобы после каждого был видимый результат: «клиент видит свободное время», а не «настроена база». Для каждого этапа укажите, что сдаётся, и срок, если он нужен.
Этапы полезны и людям (оплата по частям, промежуточная приёмка), и ИИ-агенту: задача, отданная целиком, выполняется хуже, чем та же работа, отданная по шагам с проверкой после каждого.
Шаг 7. Критерии приёмки#
Для каждого этапа запишите, как проверить, что он готов. Хороший критерий проверяется за минуты и не вызывает спора:
| Плохо | Хорошо |
|---|---|
| Удобная форма записи | Пустую форму отправить нельзя, ошибка видна под полем |
| Быстрая работа | Страница услуг открывается на телефоне без горизонтальной прокрутки |
| Надёжная запись | Два клиента не могут записаться на одно время |
Документация Claude Code называет возможность проверить результат самым важным, что можно дать агенту: тесты, ожидаемый вывод, скриншот. Для исполнителя-человека это тоже главное — по критериям проходит приёмка.
Проверка ТЗ перед отправкой#
Пройдите по чек-листу:
- Цель понятна человеку, который не был на созвоне.
- У каждого сценария есть результат и неудачная ветка.
- Список «не входит» не пустой.
- Нет слов без меры: «быстро», «удобно», «красиво», «и т.д.».
- У каждого этапа есть критерий приёмки, который можно проверить.
- Открытые вопросы выписаны отдельно, у каждого есть ответственный.
Тест из документации Anthropic по промтам подходит и для ТЗ: если коллега без контекста запутается, исполнитель тоже запутается.
Как составить ТЗ с помощью нейросети#
Нейросеть полезна не как автор ТЗ с нуля, а как интервьюер, который находит пропуски. Этот приём описывают и в документации Claude Code (попросить агента расспросить вас перед большой функцией), и разработчики в своих рабочих процессах: например, Харпер Рид в разборе своего процесса с LLM просит модель задавать вопросы по одному, а итоговую спецификацию сохраняет как spec.md в репозитории.
Промт-интервью:
Я хочу сделать [коротко: проект или функция].
Помоги составить техническое задание. Задавай вопросы по одному,
начиная с самых важных: цель, пользователи и сценарии, что не входит,
данные, технические ограничения, этапы, критерии приёмки.
Не предлагай функции, о которых я не говорил.
Когда вопросы закончатся, собери ТЗ по этим разделам.
Критерии приёмки пиши только проверяемые.
После этого проверьте результат по чек-листу выше — особенно раздел «входит»: модели любят добавлять «полезное».
Если не хочется вести диалог, генератор ТЗ соберёт документ по полям формы.
Что делать с ТЗ дальше#
- Для исполнителя-человека: согласуйте ТЗ, зафиксируйте версию и дату, все изменения вносите в документ, а не оставляйте в чате.
- Для ИИ-агента: положите ТЗ файлом в проект и начните с промта «сначала план»: агент читает ТЗ, задаёт вопросы и предлагает план, а код пишет только после вашего «ок». Подробно — на странице ТЗ для нейросети.