Модуль 04

Модуль 4. Соберите первый рабочий сценарий целиком

Вместо большого списка функций пройдите один путь пользователя от экрана до проверенного результата.

Вертикальный срез — маленький, но сквозной кусок продукта. В нашем примере это не просто «сверстать форму», а пройти путь: выбрать услугу → ввести контакт → отправить данные в тестовый обработчик → получить реальное состояние успеха или ошибки.

Полезно понимать четыре слоя, которые AI-инструмент может менять: HTML описывает элементы страницы, CSS — их расположение и внешний вид, JavaScript в браузере — интерактивность, сервер/backend — проверку и хранение данных. Секреты нельзя прятать в клиентский JavaScript: пользователь может получить код страницы.

Почему начинаем со сквозного сценария

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

Сделайте по одному шагу за раз

  1. Покажите форму на странице. Проверьте заголовок, поля и кнопку на ширине телефона.
  2. Добавьте локальную проверку формы. Пустое имя и пустой контакт должны остановить отправку и подсказать, что исправить.
  3. Подключите тестовую функцию отправки. На этом этапе можно использовать mock, который возвращает успех или одну из ошибок.
  4. Покажите три состояния: идёт отправка, запрос принят, сервер не ответил.
  5. Запустите сценарий вручную и сравните с критериями из первого модуля.
  6. Зафиксируйте версию. Сохраните или commit только после проверки.

Просите агента вносить один слой за раз и не менять уже принятые части. После каждого шага посмотрите экран и diff. Скриншот показывает внешний вид, но не доказывает, что данные действительно отправляются.

Рабочий цикл: контекст, небольшой шаг, проверка и checkpoint

Пример карточки ошибки

СобытиеЧто делать интерфейсуЧто не делать
Поле обязательно, но пустоеПоказать, какое поле заполнитьОтправлять запрос и очищать форму
Запрос выполняетсяЗаблокировать повторное нажатие, показать статусСоздавать несколько одинаковых заявок
Запрос успешенПоказать подтверждение и очистить форму по выбранному правилуПоказывать вымышленный «успех» до ответа
Сервер вернул ошибкуСохранить введённое и дать повторитьПоказать внутренний stack trace

Практика

  1. Ведите журнал реализации: шаг → изменённые файлы → результат проверки.
  2. Соберите только один путь из брифа.
  3. Проверьте его в трёх состояниях и на настольной/мобильной ширине.
  4. Попросите второго человека выполнить путь без ваших подсказок.
  5. Запишите один обнаруженный дефект и исправьте его отдельной маленькой задачей.

Артефакт: работающий vertical slice и журнал изменений. Критерий готовности — пользователь проходит путь и получает правдивое подтверждение результата.

Самопроверка

  • Система получает и возвращает реальный результат или пока имитирует его?
  • Понятно ли, что видит пользователь во время загрузки и при сбое?
  • Можно ли отменить последнее изменение?