User Stories и критерии приёмки: stories.md для агента
Роли, истории и сценарии Given/When/Then, по которым видно, готово или нет
Какую задачу решает
Описать user stories с критериями приёмки
Что будет на выходе
Документ stories.md: роли, сценарии, Given/When/Then
- Кому подойдёт
Продакт, которому нужно поставить задачи агенту так, чтобы результат можно было проверить
- Тема
- Вайбкодинг
- Инструменты
- любой ИИ-чат
Агент собрал форму записи. Ты открываешь её и видишь, что запись нельзя отменить, а если слот уже занят, висит пустой экран. Агент не виноват: ты об этом не писал. User stories с критериями приёмки закрывают эту дыру. На каждое действие пользователя есть условие «Дано — Когда — Тогда», и по нему видно, готово или нет, без споров «я имел в виду другое».
Здесь два промпта. Первый вытаскивает из твоего описания роли и короткий список историй, чтобы ты поправил его до деталей. Второй превращает утверждённый список в файл stories.md: истории, основные и негативные сценарии, критерии, которые проверяются руками.
Сначала договорись, кто пользуется продуктом и какие истории входят в первую версию. Потом ИИ расписывает каждую историю в формате Given/When/Then, и агенту остаётся сделать так, чтобы все «Тогда» сбылись.
Что получишь
- 👥Роли
Кто пользуется продуктом, что каждому можно и чего нельзя. Отсюда потом растут проверки прав.
- 📋Истории
«Как клиент, я хочу…, чтобы…» — только то, что входит в первую версию.
- 🧪Given/When/Then
На каждую историю основной сценарий и минимум один негативный: занято, пусто, нет прав, двойное нажатие.
Удобнее всего начинать, когда у тебя уже есть MVP на одну страницу: список функций первой версии берётся оттуда. Негативные сценарии хорошо дополняет гайд Четыре состояния, без которых интерфейс разваливается.
Как использовать
- 1Собери вход
Описание продукта, список функций первой версии и то, чего в ней точно нет.
- 2Утверди роли и список историй
Шаг 1. Вычеркни лишнее, ответь на вопросы ИИ, посмотри блок «Возможно, забыто».
- 3Получи stories.md
Шаг 2 в том же чате. ИИ выдаёт файл целиком одним блоком.
- 4Отдай агенту
Положи файл в папку docs и пиши агенту «делай US-3 из docs/stories.md, критерии приёмки обязательны».
Как сохранить: скопируй ответ шага 2 целиком, создай в проекте файл docs/stories.md и вставь туда. Когда агент закончит историю, проверь её по критериям и только потом бери следующую.
Рядом по теме: Путь пользователя без тупиков и пустых экранов, PRD для вайбкодинга: готовый prd.md для ИИ-агента, Как поставить задачу ИИ-разработчику: PRD из одной идеи, статья «Как написать ТЗ для ИИ-агента» и Чек-лист «Перед запуском» (бесплатно).
Дальше — для участников
Регистрация бесплатная и занимает минуту. Часть закрытых материалов откроется сразу, без карты.
Что дальше
- Скилл для генерации тест-кейсов из PRD — превратить критерии в тест-кейсы.
- Приёмка без поблажек: проверь работу агента — как принимать сделанное по этим критериям.
- Весь путь от идеи до первого работающего экрана с агентом — курс Первый экран за 990 ₽.