Как проверить, что вайбкодинг не сломал микроразметку после правок ИИ-агента

Как проверить, что вайбкодинг не сломал микроразметку после правок ИИ-агента

ИИ-агент правит шаблон, переносит блоки, меняет структуру страницы — и незаметно ломает schema.org-разметку, которую вы настраивали вручную или добавляли тем же вайбкодингом раньше. Поисковики перестают показывать звёздочки, цены и хлебные крошки в выдаче. В этой статье — конкретный порядок проверки микроразметки после каждой итерации с ИИ-агентом, типичные места поломок и как их чинить без глубокого погружения в код.

Почему вайбкодинг ломает микроразметку чаще, чем кажется

ИИ-агент работает с кодом файл за файлом. Он видит текущий контекст, но не всегда «помнит», что вы добавляли разметку schema.org три сессии назад в другом шаблоне. Claude Code, Cursor и подобные инструменты умеют делать согласованные правки по многим файлам, но только если явно попросить их следить за структурой JSON-LD или микроданными (Хабр). Без такой инструкции агент спокойно перепишет <div itemscope> в семантический <section>, потеряв атрибут, или перенесёт блок цены так, что itemprop="price" окажется вне родительского itemscope.

Ещё одна причина — рефакторинг после вайбкодинга. Как только проект набирает массу, появляется запрос на «почистить код». Разработчик или агент удаляет «лишние» атрибуты, не понимая, что они нужны поисковику, а не браузеру. Результат — страница визуально не изменилась, зато расширенный сниппет в Google пропал.

Что именно ломается: три самых частых места

Первое — JSON-LD в <head>. Агент переносит скрипты, меняет порядок тегов или дублирует блок при слиянии шаблонов. Поисковик получает два конкурирующих объекта Product или LocalBusiness на одной странице.

Второе — microdata-атрибуты на HTML-элементах. При переходе с таблиц на flexbox или при адаптивной вёрстке агент часто перекидывает содержимое в новые теги, забывая перенести itemprop. Цена остаётся в коде, но уже не внутри itemscope — поисковик её не видит.

Третье — Open Graph и Twitter Card. Это не schema.org, но поисковики и ИИ-боты тоже читают эти мета-теги. ИИ-агент при работе с <head> нередко удаляет «непонятные» og:image или меняет og:type на дефолтный website, убирая более точный тип.

Как проверить микроразметку: пошаговый порядок

Проверку удобно встроить прямо в рабочий цикл с агентом — до коммита, а не после деплоя.

  1. Rich Results Test от Google. Вставьте URL страницы или HTML-код. Инструмент покажет, какие объекты schema.org он нашёл, какие поля заполнены корректно, а какие вызывают предупреждение. Удобно проверять прямо на staging-версии.
  2. Schema Markup Validator (validator.schema.org). Строже, чем тест Google. Проверяет соответствие спецификации schema.org без поправки на то, что «Google всё равно поймёт». Используйте для финальной проверки перед публикацией.
  3. Поиск по коду через grep или поиск в IDE. После каждой сессии с агентом выполните поиск по строкам itemscope, itemprop, application/ld+json. Убедитесь, что количество вхождений совпадает с тем, что было до правок. Если агент что-то удалил — сразу видно.
  4. Diff перед коммитом. Просматривайте изменения в файлах шаблонов целиком, а не только в той части, которую агент пометил как изменённую. Микроразметка часто живёт в соседних строках с правками.

Если вы работаете с Claude Code — сохраняйте чекпоинты перед каждым сообщением агенту. При поломке можно откатиться к нужному состоянию через /rewind, выбрать сообщение, с которого всё пошло не так, и вернуть файлы или весь разговор (smyslokod.ru). Это занимает меньше минуты и страхует от ситуации, когда правки уже в трёх файлах и вручную не разобраться.

Как объяснить агенту, чтобы он не трогал разметку

Самый надёжный способ — явно запретить в системных инструкциях. В файле CLAUDE.md можно указать правила, которые агент будет соблюдать при каждой правке: не удалять атрибуты itemprop и itemscope, не переносить блоки с JSON-LD без явной команды, не трогать содержимое тегов <script type="application/ld+json">.

Пример инструкции для CLAUDE.md:


## Микроразметка
- Не удалять и не изменять атрибуты itemscope, itemprop, itemtype.
- Не трогать теги <script type="application/ld+json"> без явной команды.
- При переносе HTML-блока сохранять все data-атрибуты и атрибуты schema.org.
			

Это не гарантия на сто процентов, но агент начнёт спрашивать перед удалением, а не молча чистить «лишнее».

Таблица: чем проверять и что ловит каждый инструмент

Инструмент Что проверяет Когда использовать
Google Rich Results Test Schema.org, пригодность к расширенным сниппетам После каждой сессии агента на страницах с товарами, отзывами, событиями
Schema Markup Validator Соответствие спецификации schema.org Финальная проверка перед публикацией
Open Graph Debugger (Facebook) og: теги, og:image, og:type При правках в <head> или шаблоне мета-тегов
grep / поиск в IDE Количество и положение атрибутов в коде Сразу после diff, до коммита
/rewind в Claude Code Возврат к чекпоинту до правок агента Когда разметка сломана и непонятно в каком файле

Типичные ошибки при работе с ИИ-агентом и микроразметкой

  • Проверять разметку только визуально — браузер отображает страницу корректно даже без itemscope.
  • Давать агенту задачу «оптимизируй шаблон» без ограничений — агент считает атрибуты schema.org устаревшим мусором.
  • Не делать чекпоинт перед сессией с агентом и потом тратить час на ручной откат.
  • Забывать про страницы с динамической разметкой: карточки товаров, посты блога, страницы услуг — агент правит шаблон, и поломка попадает сразу на все страницы.
  • Доверять только одному валидатору — Google Rich Results Test и Schema Markup Validator иногда расходятся в оценке одного и того же кода.

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

3 шага, которые можно сделать сегодня:

  1. Откройте Google Rich Results Test и проверьте три главные страницы сайта — главную, карточку товара или услуги, страницу контактов. Запишите, какие объекты schema.org сейчас распознаются.
  2. Добавьте в CLAUDE.md (или аналогичный файл инструкций вашего инструмента) явный запрет трогать атрибуты itemscope, itemprop и блоки JSON-LD без команды.
  3. Настройте grep-поиск по ключевым строкам микроразметки и запускайте его как часть проверки diff перед каждым коммитом после сессии с агентом.