Как проверить вёрстку сайта после правок Claude Code?

Как проверить вёрстку сайта после правок Claude Code?

Перед правками Claude Code сохраните эталонные скриншоты сайта, а после изменений сравните с ними новые снимки через Playwright. Так можно заметить, что кнопка заявки ушла за край экрана, заголовок перекрыл изображение или мобильное меню закрыло форму. Визуальные тесты показывают различия, но решение о том, какие из них нужны бизнесу, принимает человек. Ниже разберём, какие страницы проверять, как подготовить сравнение и когда обновлять эталоны, чтобы случайно не принять ошибку за новый дизайн.

Что проверяют визуальные тесты после вайбкодинга?

Визуальный тест открывает страницу в браузере, делает скриншот и сравнивает его с эталоном. Если изображения отличаются сильнее, чем допускают настройки, тест сообщает о расхождении. Playwright позволяет запускать такую проверку после изменений кода, в том числе после работы Claude Code.

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

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

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

Как подготовить сайт к сравнению скриншотов?

Сохраните текущую рабочую версию кода и проверьте её вручную до создания эталона. Если кнопка уже перекрывает текст, тест запомнит именно это состояние и будет защищать существующую ошибку. Эталон означает «мы проверили и приняли этот вид страницы».

Затем зафиксируйте условия съёмки. Один и тот же сайт выглядит по-разному при другой ширине окна, без нужного шрифта или с открытым уведомлением. Эти различия мешают увидеть последствия правок Claude Code.

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

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

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

Как поручить Claude Code настроить Playwright?

Сначала попросите Claude Code изучить проект: проверить, установлен ли Playwright, как запускается сайт и есть ли готовые тесты. Это снижает риск появления второй конфигурации рядом с рабочей. Затем дайте отдельную задачу на визуальную проверку, без изменения дизайна.

Формулировка задания может быть такой: «Настрой визуальные тесты Playwright для страницы услуги и формы заявки. Используй фиксированные размеры окна, дождись загрузки шрифтов, отключи анимации. Добавь сравнение через toHaveScreenshot и HTML-отчёт. Не меняй код страницы ради прохождения теста. Эталоны подготовь для ручного согласования».

Метод toHaveScreenshot сравнивает снимок страницы или отдельного элемента с эталонным изображением. Для подробной настройки пригодится инструкция по проверке вёрстки в Playwright после правок Claude Code. В задаче отдельно укажите, какой результат считать готовым: тест запускается, повторный запуск на неизменном сайте проходит, отчёт открывается.

  1. Попросите Claude Code добавить тест выбранной страницы и описать команду запуска для вашего проекта.
  2. Запустите создание эталона на версии, которую уже проверили вручную.
  3. Откройте эталонный снимок и подтвердите, что страница выглядит правильно.
  4. Повторите тест без правок кода: он должен пройти в тех же условиях.
  5. После изменений сайта запустите сравнение и откройте отчёт о различиях.

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

Как отличить нужный редизайн от ошибки вёрстки?

Сверьте различия с задачей, которую получил Claude Code. Если вы просили изменить цвет кнопки, перенос заголовка и исчезновение подписи поля не входят в согласованный результат. В отчёте смотрите исходный снимок, новый снимок и изображение различий, затем откройте саму страницу в браузере.

Проверяйте и соседние страницы. Изменение общего стиля карточки затрагивает все места, где сайт использует этот компонент. Поэтому после правки карточки товара нужно посмотреть её и в каталоге, и в блоке рекомендаций, если такой блок есть.

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

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

Даже после совпадения скриншотов проверьте, можно ли пройти страницу с клавиатуры и понять подписи полей. Видимая кнопка ещё не гарантирует, что посетитель сможет ею воспользоваться. Эту часть раскрывает проверка доступности сайта после правок Claude Code.

Типичные ошибки при проверке вёрстки

  • Обновлять все эталоны после падения тестов. Сначала разберите каждое различие, иначе ошибка станет новым образцом.
  • Проверять только первый экран. Добавьте снимок всей страницы или отдельную проверку формы ниже по странице.
  • Увеличивать допустимое расхождение ради успешного запуска. Сначала выясните, что вызывает различия: нестабильный снимок или правка интерфейса.
  • Поручать Claude Code одновременно менять дизайн и самостоятельно принимать результат. Оставьте согласование эталонов человеку.
  • Считать визуальный тест полной проверкой сайта. Отдельно проверьте отправку формы и переход к следующему шагу заказа.

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