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