Продукт ваш, строк ваш, рахунок підписуєте ви. Дизайн нового сценарію лежить у макеті, потрібна зміна живе у повідомленні чату тримісячної давності, а та півсторінка, яку обіцяли продавці, існує як скриншот без позначки, звідки він знятий. Потім приходить перша збірка, і виглядає вона не так, як ви уявляли. А розробник зазвичай міг би впоратися з роботою, от тільки отримав він переписку замість задачі.

Робочий бриф для розробника це короткий пакет, а не довгий чат. За влаштуванням він схожий на рахунок-замовлення: результат, який ви б самі підтвердили, поточна система, що означає «готово», і один рядок про те, за що цей рахунок не платить. Надішліть пакет до початку робіт, а наступного місяця зберіть ту саму форму для нової задачі: мета одна, випустити реліз, який ви впізнаєте, без сюрпризу на бойовому сайті в день, який ви пообіцяли.

1. Звідки насправді береться сюрприз

Сюрприз виникає не на старті, а під час перевірки. Сторінка вже існує, трафік на неї вже можна вести, і все одно ви її не приймаєте: хтось не записав важливу умову, статус платежу, філію, яка не повинна бачити дані іншої, або поле, яке відділ продажів вважав обов’язковим. Збірка зробила саме те, що їй сказали.

Намір продукту тримаєте ви, репозиторій у розробника, і кожна сторона вважає, що прогалину закрила інша. Чат створює відчуття швидкості, тому прогалина залишається в чаті, і через тиждень уже ніхто не може показати повідомлення, де вирішили, як має працювати система. Успадковані продукти ламаються в тому самому місці: нова команда витрачає перший тиждень не на розвиток, а на з’ясування того, що саме зараз працює, бо бриф, що існував лише в голові однієї людини, приходить у тому самому вигляді.

Перш ніж прикладати файли, напишіть три короткі рядки.

2. Що потрібно додавати кожного разу

Папка з назвою assets і фраза на кшталт «зробіть як у дизайні» не замінюють бриф. Розробник відкриє файли й усе одно не зрозуміє, який із них актуальний, який сценарій входить у задачу і що робити, коли дизайн не збігається з тим, що працює на живому продукті.

Зазвичай кожен надсилає те, чим користується сам: дизайнер передає файл, колега кидає посилання на сторінку, а іноді й пароль у приватне повідомлення, бо колись так спрацювало. Жодна з цих речей не є брифом, і прогалину розробник закриває припущеннями. Саме вони потім і стають тим, що ніхто не погоджував.

Матеріали зручно додавати в одному й тому самому порядку: тоді розробник одразу бачить, чого бракує.

Якщо частина виручки йде через інтернет-магазин, назвіть платформу, на якій він уже працює, і той крок покупки, який має змінитися. Формулювання «підвищити конверсію» нічого не каже про те, де саме буде зміна: у каталозі, в кошику чи на поверненні після оплати. Адаптація живого магазину і створення нового магазину це різні задачі. Бриф має прямо сказати, яка з них стоїть зараз.

3. Описуйте поведінку, а не оформлення

Бриф, у якому детально описані кольори, але не зафіксоване правило роботи системи, перевірятимуть саме за правилом. Вас цікавить, хто бачить запис, що відбувається після невдалої оплати і який звіт має бути після оцінювання дзвінка. Оформлення видно у файлі. А поведінка проявляється лише тоді, коли людина проходить сценарій до кінця.

Якщо ваш продукт пов’язаний із телефонією, поштою, бухгалтерією або CRM, результат оцінюватимуть у тій системі, у якій ваша команда працює щодня, а не в pull request. На одному CRM-проєкті оцінювання дзвінків було пов’язане з телефонією, обміном повідомленнями та бухгалтерією, а результат показувався у звіті. Повторний запуск не мав створювати другу оцінку, а одна філія не повинна була читати записи іншої. Вам не потрібно переносити в бриф саме цей стек. Потрібні рівноцінні речення: які системи входять у задачу, що людина має побачити після завершення обробки і яка умова повинна залишатися істинною, якщо процес спрацює двічі. Фраза «додати ШІ» цього не пояснює, а відповідати за цю частину доведеться вам, бо продукт ваш.

Для кожного сценарію в межах задачі опишіть таке:

4. Передавайте замовлення, а не переписку

Бриф це рахунок-замовлення, і розробник робить те, що в ньому написано, плюс те, що дозволяють порожні місця. Ставтеся до нього як до будь-якого замовлення: у ньому названо, хто замовляє, що саме замовлено і коли замовлення було передане. Задача, оцінена за розмовою чи за чатом, отримує найдешевше прочитання, бо саме воно вміщується між двома іншими задачами, і ваші власні слова стають бюджетом, який ви ніколи не погоджували.

Запитання будуть, і це нормально. Правило одне: відповідь, дана в чаті, ще не відповідь, доки вона не потрапила в бриф. Вставте рішення назад у документ із рядком контексту, і наступне запитання стартуватиме вже з оновленого стану. Якщо колега пообіцяв правку в розмові, діє те саме правило: обіцянка, що живе лише в записи розмови, розробником не почута.

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

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

Якщо окремого середовища ще немає, скажіть про це в брифі до обіцянки дати, поки ризик коштує дешево. Секрети й надалі не їздять у документі: бриф перелічує системи, а доступ видається через облікові записи вашої компанії.

5. Одна форма для кожного запиту

Визначеному проєкту потрібен увесь пакет. Постійній співпраці потрібна та сама форма в короткому вигляді: результат, межа, що означає «готово», і саме коротка форма не дає довгій співпраці розчинитися в архіві чату, на який ніхто не може послатися.

Форма ще й показує, чого бракує в оцінці. Розробник, який може назвати, що він у цьому релізі не робить, прочитав ваше замовлення правильно. Розпливчаста відповідь означає, що бриф не справився зі своєю єдиною задачею, і розмова, якої бракувало, все одно відбудеться: пізніше й дорожче. Правте замовлення, а не настрій.

Повторно використовуйте файл, а не створюйте новий: скопіюйте пакет за минулий місяць, змініть рядок результату, і розробник відкриє ту саму сторінку, що й ви, а не ту переписку, від якої вийшли.

Коли варто підключати розробника раніше

Такий пакет можна зібрати ще до того, як розробник відкриє репозиторій. Підключайте розробника раніше, ніж назвете дату, якщо зміна зачіпає платежі, спільну базу клієнтів або систему, яку ви самі не можете описати, і тим паче успадкований продукт, де ніхто не підтвердив окреме середовище. Розробник, який побачить бриф лише після слів «там майже все готово», успадкує сюрприз разом із вами.

Я беру в роботу задачі з чіткими межами від власників продуктів і команд, а також розробку за письмовим замовленням. Послуги охоплюють окремий проєкт і довшу співпрацю: продуктивність, SaaS і бекенд-системи, інтеграцію ШІ. У Обраних роботах видно, на які системи зазвичай лягають такі брифи: успадкований продукт, онлайн-магазин чи CRM із чинними користувачами, причому кожен кейс тримається в межах своєї задачі. Якщо реліз пора випускати, а розробник має працювати за письмовим замовленням, почніть із розробки продукту з нуля або напишіть мені. У перший лист покладіть результат, рядок про те, що означає «готово», і назву платформи. Секретного у перший лист класти не потрібно.