Продукт ваш, срок ваш, счёт подписываете вы. Дизайн нового сценария лежит в макете, нужная правка живёт в сообщении чата трёхмесячной давности, а та половинка страницы, которую обещали продавцы, существует в виде скриншота без пометки, откуда он снят. Потом приходит первая сборка, и выглядит она совсем не так, как в вашей голове. Разработчик, скорее всего, справился бы с работой. Ему передали переписку, а не задачу.

Рабочий бриф для разработчика это короткий пакет, а не длинный чат. Устроен он как счёт-заказ: результат, который вы бы сами подтвердили, текущая система, что значит «готово», и одна строка о том, что этот счёт не покупает. Перед началом работ отправьте пакет разработчику, а через месяц соберите ту же форму для новой задачи: цель одна, выпустить релиз, который вы узнаете, без неприятного сюрприза на боевом сайте в день, который вы пообещали.

1. Откуда на самом деле берется сюрприз

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

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

Перед файлами напишите три короткие строки.

2. Что прикладывать каждый раз

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

Материалы обычно приходят из того инструмента, которым человек пользуется: дизайнер присылает файл, коллега отправляет ссылку на страницу, а иногда и пароль в личном сообщении, потому что однажды так получилось. Ни то, ни другое брифом не является. Пробел разработчик закрывает догадками, и именно догадка потом становится тем, что никто не согласовывал.

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

Если часть выручки идёт через интернет-магазин, назовите платформу, на которой он уже работает, и тот шаг покупки, который должен измениться. «Поднять конверсию» не говорит, где именно меняется шаг: в каталоге, в корзине или в возврате после оплаты. Доработка работающего магазина и сборка нового с нуля это разные задачи, и бриф должен прямо сказать, какая из них стоит перед вами.

3. Описывайте поведение, а не оформление

Бриф, в котором расписаны цвета, но не зафиксировано правило, проверять будут по правилу. Вас будет волновать, кто видит запись, что происходит при неуспешной оплате и что должен показывать отчет после оценки звонка. Оформление видно в файле. Поведение проявляется только тогда, когда человек проходит сценарий до конца.

Если продукт связан с телефонией, почтой, бухгалтерией или CRM, результат будут оценивать в той системе, в которой ваша команда работает каждый день, а не в pull request. На одном CRM-проекте оценка звонков связала телефонию, обмен сообщениями и бухгалтерию, а потом показала итог в отчете. Повторный запуск не должен был создавать вторую оценку, а один филиал не должен был видеть записи другого. Вам не нужно переносить в бриф именно этот стек. Нужны эквивалентные формулировки: какие системы участвуют, что человек увидит после завершения обработки и какое правило должно сохраняться, если задача запускается второй раз. «Добавить ИИ» этого не объясняет.

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

4. Отдавайте задачу, а не переписку

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

Вопросы будут, это нормально. Правило одно: ответ, данный в чате, ещё не ответ, пока он не попал в бриф. Вставьте решение обратно в документ с одной строкой контекста, и следующий вопрос начнётся уже с обновлённого состояния. Если коллега пообещал правку в разговоре, действует то же правило: обещание, живущее только в записи разговора, разработчиком не услышано.

То же правило действует для новых идей. Посреди работы кто-то просит то, что по сути является вторым заказом, и бриф позволяет отложить это без спора, потому что граница была написана до начала работы. Если объём меняется намеренно, не переписывайте историю: добавьте сверху новую шапку из трёх строк, а прежнюю поменяйте как заменённую, и в файле будет видно, что заказано сначала, а что добавлено потом.

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

Если отдельного окружения ещё нет, скажите об этом в брифе до обещания срока, пока риск стоит дёшево. Секреты по-прежнему не ездят в документе: бриф перечисляет системы, а доступ выдаётся через учётные записи вашей компании.

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

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

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

Переиспользуйте файл, а не создавайте новый: скопируйте пакет за прошлый месяц, поменяйте строку результата, и разработчик откроет ту же страницу, что и вы, а не ту переписку, от которой вы уходили.

Когда разработчика стоит подключать заранее

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

Я беру в работу задачи с понятными границами от владельцев продуктов и команд, а также разработку по письменному заказу. Услуги охватывают как отдельный проект, так и постоянное сотрудничество: производительность, SaaS и backend-системы, интеграция ИИ. В Выбранных работах видно, на какие системы обычно ложатся такие брифы: унаследованный продукт, интернет-магазин или CRM с действующими клиентами, причём каждый кейс остаётся в пределах согласованного объёма. Если релиз пора выпустить, а разработчик должен работать по письменному заказу, начните с разработки продукта с нуля или напишите мне.

В первое письмо положите результат, строку о том, что значит «готово», и название платформы. Секретного в первое письмо класть не нужно.