Запуск закінчився о четвертій ранку після п’ятнадцяти годин правок, суперечок і одного відсутнього абзацу. Ніхто не записав у технічне завдання, що означає «готово». Проєкт провалився не через код, а через те, що ТЗ жило в листуванні.
Що таке технічне завдання
Не документ на сто сторінок. Чотири речі: обсяг, ролі, приймання й зміни. Обсяг каже, що входить і що ні. Ролі кажуть, хто вирішує. Приймання каже, як зрозуміти, що працює. Зміни кажуть, що робити з новою ідеєю на третьому тижні.
П’ять ознак, що завдання немає
- На першій зустрічі звучить «по ходу розберемося».
- Двоє людей описують один екран по-різному.
- Кожне нове прохання беруть без зсуву строку.
- «Готово» вирішує той, хто опинився в кімнаті на запуску.
- План тестів - «потикаємо».
Що воно економить
Односторінкове ТЗ ловить дорогі непорозуміння до коду. Воно ж захищає команду: письмовий обсяг перетворює «ви це пропустили» на «це поза обсягом, ось зміна». Розмова переходить від пошуку винних до рішення.
ТЗ на одну сторінку
Мета одним реченням. П’ять-сім історій користувача з критеріями приймання. Власник і той, хто затверджує. Відомі ризики. Порядок змін: хто просить, хто оцінює, хто затверджує. Для більшості проєктів цієї сторінки досить.
Якщо замовник не може написати
Тоді пишете ви і просите відповісти «так» або «ні». ТЗ, написане підрядником і підтверджене замовником, краще за ідеальний документ, який ніхто не читав. Надсилайте короткий текст, а не презентацію на сорок слайдів.
Звичка, яка прибирає наступне four a.m.
До першого рядка коду прочитайте ТЗ уголос із командою. Кожне речення, після якого знизують плечима, йде на переписування. Десять хвилин такого читання економлять ніч запуску. ТЗ - не бюрократія, а найдешевший тест проєкту.
Виробниче пекло рідко робить складна технічна задача. Його робить домовленість, яку ніхто не записав.
Питання до першого ТЗ
Хто пише? Перший чернетка - той, хто ближче до бізнес-задачі; підрядник править його під реальність. Два читачі, одна сторінка.
Скільки сторінок? Для більшості проєктів одна. Десять сторінок зазвичай означають, що обсяг неясний, а не що документ докладний.
А якщо замовник відмовляється писати? Напишіть свої припущення й попросіть відповісти «так» або «ні». Мовчання не згода.
ТЗ вбиває гнучкість? Ні. Воно показує, скільки коштує зміна, а гнучкості потрібна саме ця цифра.
Чек-ліст до старту
- Мета одним реченням.
- П’ять-сім історій із критеріями приймання.
- Власник і той, хто затверджує, названі.
- Що поза обсягом - записано.
- Ризики перелічені.
- Порядок змін узгоджений.
- Дата запуску й план відкату.
ТЗ - не договір із майбутнім. Це знімок того, про що домовилися сьогодні, з деталями, яких досить, щоб помітити розходження. Змінюється домовленість - оновіть документ і збережіть стару версію.
Як виглядає технічне завдання, яке рятує
Добре технічне завдання - одна сторінка: обсяг, ролі, приймання, порядок змін. User stories допомагають описати приймання без води. Ніч о четвертій ранку - не аргумент проти документа.
Перевірка проста: дайте документ людині, яка не брала участі в обговоренні, і попросіть переказати обсяг робіт. Якщо переказ розходиться з вашим, проблема не у виконавці. Ще одне правило - фіксувати, чого в проєкті не буде: без списку винятків обсяг росте сам. І дата: у приймання має бути строк, інакше «майже готово» живе місяцями. Документ на одну сторінку оновлюється дешевше, ніж сорок сторінок, які ніхто не читає. Тримайте його там, де команда вже дивиться. ТЗ не замінює розмову, воно лише фіксує її результат.
Документ переживає зміну людей, чат - ні. Тому його й тримають окремо.
Ще за темою: Чому бізнес без цілей не зростає і Архітектура ПЗ: шість патернів і як обрати.