Словарь ClaudeLab
Что такое техническое задание
Техническое задание - это согласованное описание того, какой результат нужно создать, для кого он предназначен и по каким критериям его будут принимать. В документе фиксируют сценарии, границы, данные, интеграции, требования и неизвестные, которые должны быть решены до или во время работы.
Простыми словами
ТЗ похоже на маршрут перед поездкой. Недостаточно написать «поехать к морю»: нужно знать точку старта, пассажиров, ограничения машины и признак прибытия. При этом маршрут может уточняться после разведки, если изменения фиксируются и обе стороны понимают их последствия.
Зачем это бизнесу
Выравнивает ожидания
Заказчик и исполнитель одинаково называют пользователей, действия и результат. Формулировка «удобный кабинет» превращается в проверяемые сценарии: войти, увидеть заказ, скачать документ, изменить разрешённое поле.
Очерчивает границы
Документ показывает, что входит в текущий этап и что остаётся за его пределами. Новая идея не теряется, но отдельно оценивается по влиянию на архитектуру, срок и проверку.
Помогает принимать работу
Для каждого важного сценария есть ожидаемый результат и условия. Проверка опирается на согласованные критерии. Воспоминание о разговоре и общее ощущение готовности доказательством не служат.
Выявляет неизвестное
Если нет источника данных, правил расчёта или владельца решения, это видно до разработки. Неизвестное оформляют как вопрос, исследование или отдельный прототип. Уверенная формулировка пробел в данных не закроет.
Как это выглядит на практике
| Раздел ТЗ | Что в нём фиксируют |
|---|---|
| Цель и пользователи | Какую рабочую задачу решает продукт, кто выполняет сценарий и какой результат получает бизнес. |
| Сценарии | Порядок действий пользователя и системы, включая ошибки, пустые состояния и передачу человеку. |
| Данные и интеграции | Источники, обязательные поля, права доступа, форматы обмена и поведение при недоступности внешнего сервиса. |
| Критерии приёмки | Набор проверок, по которым сторонам понятно, что сценарий работает в согласованных границах. |
В ClaudeLab сложные требования проверяются рабочим прототипом до окончательного решения по проекту. Как ТЗ связывается с этим подходом, показано на странице о заказной разработке: заказчик видит сценарий в действии, а документ фиксирует границы и критерии следующего этапа.
Частые вопросы
- Кто должен писать техническое задание?
- Смысл и правила процесса даёт заказчик, техническую форму помогает собрать исполнитель или аналитик. Хорошее ТЗ создаётся совместно: одна сторона знает работу, другая умеет перевести её в сценарии, данные и проверки.
- Нужно ли описывать каждую кнопку?
- Не всегда. Глубина зависит от риска и стадии. Для проверки идеи важнее основной путь и критерий результата, для интеграции с учётом нужны точные поля и ошибки. Деталь должна помогать принять решение или проверить работу.
- Можно ли менять ТЗ во время проекта?
- Можно, если изменение зафиксировано и оценено. Появление нового требования нормально; проблема начинается, когда оно незаметно становится частью прежнего объёма и ломает связанные решения.
- Чем ТЗ отличается от прототипа?
- ТЗ описывает поведение, данные и критерии словами и схемами. Прототип показывает интерфейс или рабочий сценарий наглядно. Вместе они уменьшают разные риски: документ удерживает границы, прототип проверяет понимание.