Release notes по демо спринта: черновик словами команды

Релиз выходит во вторник, а release notes всё ещё пустая страница. Что в него вошло, было сказано вслух: два демо спринта, разработчик показывает каждое изменение, кто-то мимоходом упоминает, что повторяющиеся заказы в одном случае всё ещё не синхронизируются. В истории коммитов — код, а не объяснение, а в трекере стоит «Done» и сокращения разработчиков. Лучшее описание каждого изменения — то, что разработчик сказал, пока его показывал.

Путь короче: записывайте демо спринта в Speak-Y, нажимайте горячую клавишу, когда разработчик показывает то, что выходит в релиз, или называет известную проблему, а перед релизом попросите AI-ассистента собрать отметки через MCP по тегу релиза и составить черновик. Каждая строка возвращается с тем, кто это сказал, его словами, датой демо, временем в записи и тикетом для проверки. Решение, что выходит в релиз, текст для клиентов и обещания по срокам остаются за людьми.

Руководство описывает приложение Speak-Y для macOS и его MCP-сервер по состоянию на 17 ноября 2026 года на одном вымышленном примере: Priya Nair, продакт-менеджер Crewboard — приложения для планирования работы выездных сервисных бригад, — 24 ноября выпускает для клиентов релиз 4.2. В него вошла работа двух спринтов, показанная на демо 30 октября и 13 ноября.

Что release notes нужно от демо спринта?

Руководства по release notes сходятся в том, как они должны выглядеть. Keep a Changelog (версия 1.1.0) начинает с того, что чейнджлоги — «для людей, а не для машин», группирует изменения по типу — Added, Changed, Deprecated, Removed, Fixed, Security — и предостерегает от того, чтобы сваливать в них git log. Руководство по стилю документации MongoDB держит раздел Known issues в каждых release notes, даже если там написано «None for this release», и просит указывать для каждой проблемы её влияние на пользователя и обходной путь (оба найдены 17 ноября 2026 года).

Демо — то место, где эти факты звучат вслух. Scrum Guide описывает Sprint Review как рабочую сессию со стейкхолдерами, а не просто презентацию, — так что объяснения, вопросы и оговорки звучат на звонке. Между демо и release notes теряются четыре вещи:

До первого демо: два типа заметок и тег релиза

Откройте Настройки → Заметки. В разделе Типы заметок переименуйте тип по умолчанию Отметить момент в Shipped (вошло в релиз) и оставьте его на ⌥1. Нажмите Добавить тип заметки, введите Known issue (известная проблема) в поле Название типа, нажмите Сохранить, затем Назначить клавишу и нажмите ⌥2.

Выберите один тег для релиза, например release-4-2, и ставьте его на каждое демо, работа с которого в него входит. Тогда перед релизом ассистент читает ровно эти звонки и ничего из прошлого релиза или звонков с клиентами.

Во что превращается каждая отметка в release notes: отметки Shipped и Known issue и осторожное «должно войти», которое не отмечают
Два типа заметок сортируют демо прямо по ходу; «может быть» ждёт трекера.

Во время демо: дайте разработчику показать и нажимайте клавишу

Записывайте демо как встречу. Бот не подключается: Speak-Y записывает ваш микрофон и звук звонка на Mac, поэтому всё работает одинаково в Zoom, Google Meet или Microsoft Teams. Если на демо есть люди не из команды, в начале скажите, что демо записывается, — о том, как различаются правила согласия, см. законно ли записывать встречи.

Отметки становятся полезными благодаря трём привычкам:

  1. Нажимайте после фразы. Отметка охватывает последние 15 секунд звонка, поэтому только что прозвучавшее описание попадает в неё.
  2. Спрашивайте «что теперь может пользователь?». Вопрос превращает демо эндпоинта во фразу, понятную клиенту. Отметьте ответ на ⌥1.
  3. Спрашивайте про граничные случаи. «А для повторяющихся заказов работает?» вытаскивает оговорку, пока разработчик ещё на экране. Отметьте её на ⌥2.

На демо 13 ноября Priya отмечает два изменения и одну известную проблему. На 08:15 мобильная разработчица Hana Kim говорит: «Техники теперь могут менять порядок своего дня, перетаскивая заказы в мобильном приложении, и диспетчер сразу видит новый порядок». На 19:35, на вопрос, работает ли это для повторяющихся заказов, Hana отвечает: «Повторяющиеся заказы всё ещё не синхронизируются с Google Calendar, если в серии есть исключение. Событие приходится править вручную». Priya отмечает это как известную проблему. Когда бэкенд-разработчик Marco Lee добавляет, что экспорт в CSV «должен войти, если QA пропустит его в пятницу», она это не отмечает: это то, что нужно проверить, а не то, что можно объявлять.

После демо: подпишите спикеров и добавьте тег

На вкладке По спикерам нажмите на каждую плашку спикера и введите имя и роль — «Hana Kim, мобильная разработка», — чтобы в черновике цитировались люди, а не номера. Добавьте тег release-4-2. Плашки над транскриптом считают отметки по типам, а щелчок по плашке оставляет только эти реплики.

Запись демо спринта 13 ноября в Speak-Y на вкладке По спикерам, с отметками Shipped и Known issue рядом с репликами разработчиков
Каждая отметка стоит рядом со своей репликой, с именем разработчика и временем в демо.

Та же запись пригодится и на следующей встрече: с неё можно начать ретроспективу, как в статье доведение решений ретро до дела.

Попросите ассистента составить черновик

Подключите ассистента к MCP-серверу Speak-Y один раз: Подключить ИИ-ассистента в меню аккаунта внизу боковой панели или Настройки → Интеграции, затем Подключить рядом с Claude, ChatGPT или Cursor. Шаги описаны в статье как подключить заметки встреч к AI-ассистентам. Сервер бесплатен на любом тарифе и читает библиотеку на вашем Mac.

Сохраните постоянные инструкции в проекте в Claude или ChatGPT, чтобы перед каждым релизом запрос умещался в одну строку:

Составь черновик release notes Crewboard 4.2:
демо с тегом «release-4-2».

Правила:
- Используй только мои отметки Shipped
  и Known issue.
- Сгруппируй: Добавлено, Изменено, Исправлено,
  Известные проблемы.
- Для каждого: слова разработчика, кто сказал,
  дата демо и время, например (13 нояб., 08:15).
- Добавь «Проверить:» с тикетом. Не придумывай
  номер тикета.
- Всё сказанное с «должно» или «мне кажется»
  выноси в неподтверждённое.
- Без текста для клиентов и без сроков.

Ассистент вызывает list_recordings с тегом и читает каждое демо. Вместе с транскриптом Speak-Y передаёт ему список Notes — у каждой отметки время, тип, спикер и первые слова. Время отметки — момент, когда вы нажали клавишу, через несколько секунд после начала реплики; в черновике указано начало реплики:

Релиз 4.2 — черновик (по демо спринта)
Добавлено
- Порядок дня перетаскиванием. Hana Kim:
  «Техники теперь могут менять порядок своего
  дня, перетаскивая заказы в мобильном
  приложении». (13 нояб., 08:15)
  Проверить: тикет порядка, мобильный релиз
Изменено
- Напоминания о заказах. Marco Lee: «Напоминания
  теперь приходят за час до заказа, а не
  накануне вечером». (30 окт., 14:05)
  Проверить: тикет настроек напоминаний

Известные проблемы
- Hana Kim: «Повторяющиеся заказы всё ещё не
  синхронизируются с Google Calendar, если в
  серии есть исключение. Событие приходится
  править вручную». (13 нояб., 19:40)

Не подтверждено
- Экспорт в CSV. Marco Lee: «Должен войти, если
  QA пропустит его в пятницу». (13 нояб., 23:10)
Что ассистент читает через MCP — отметки со временем, типами и спикерами — и черновик release notes, в который он их группирует
Изменения сгруппированы по типу; у каждой строки остаются демо и время, когда это прозвучало.

Демо не знают, что произошло после них. Если QA переносит экспорт в CSV в следующий релиз, скажите об этом в том же чате: зажмите правый ⌘ (Right ⌘) в поле сообщения, продиктуйте «Экспорт в CSV не прошёл QA, переносится в 4.3», отпустите и отправьте. Ассистент уберёт строку из черновика и оставит рядом то, что было сказано на демо.

Что остаётся за продакт-менеджером

Черновик знает, что сказала команда. Четырёх вещей он сделать не может:

Четыре проверки перед тем, как черновик станет опубликованными release notes, у каждой — тревожный признак, что он ещё не готов
Демо говорят, что было сказано; трекер, формулировки и обещания — за людьми.

Ограничения и стоимость

Коротко

Shipped на ⌥1, Known issue на ⌥2, один тег на релиз. Спрашивайте, что теперь может пользователь, спрашивайте про граничные случаи, нажимайте клавишу; потом имена спикеров и тег. Перед релизом один запрос даёт черновик, сгруппированный по типу, со словами разработчиков, временем и тикетом для проверки; что выходит в релиз, текст для клиентов и любые обещания — ваши. Чтобы превратить планирование на другом конце спринта в задачи, см. черновики задач в Claude Code по планированию спринта.

FAQ

Может ли AI-ассистент составить release notes по записанным демо спринта?

Он может собрать черновик из того, что сказала команда. Подключённый к MCP-серверу Speak-Y, Claude, ChatGPT или Cursor читает демо с тегом вашего релиза — транскрипт по спикерам и список Notes с вашими отметками и их временем — и группирует отмеченные моменты в Shipped и Known issue, со словами разработчика, датой демо и временем в записи. Что на самом деле выходит в релиз, затем сверяют с трекером.

Как отмечать на демо спринта то, что вошло в релиз?

Создайте типы заметок в Speak-Y в разделе Настройки → Заметки: переименуйте тип по умолчанию Отметить момент в Shipped на ⌥1 и добавьте Known issue на ⌥2. Нажатие отмечает последние 15 секунд звонка этим типом, поэтому фраза, которую разработчик только что произнёс, попадает в список ассистента уже рассортированной, со спикером и временем.

Достаточно ли демо, чтобы считать фичу частью релиза?

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

Сохранять ли в release notes формулировки разработчиков?

В черновике — да, в опубликованных заметках — нет. Фраза разработчика точнее всего описывает изменение, а время в записи позволяет её переслушать; текст для клиентов переписывает продакт-менеджер или технический писатель — через то, что пользователь теперь может сделать.

Какой тариф Speak-Y нужен для 45-минутных демо спринта?

Pro или выше. По данным speak-y.com на 17 ноября 2026 года, Free останавливает запись встречи на 30 минутах, Pro ($10 в месяц) — на одном часе, а Pro+ ($15) и Max ($30) — на четырёх часах. MCP-сервер бесплатен на любом тарифе.