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

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

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