Команды Chrome, Edge, Firefox и MDN выпустили Modern Web Guidance для ИИ-агентов

Команды Chrome, Edge, Firefox и MDN выпустили Modern Web Guidance для ИИ-агентов

На GitHub в организации GoogleChrome опубликован проект Modern Web Guidance. Это набор навыков (skills), который встраивает в кодинг-агентов знания о веб-платформе, лучшие практики и данные о совместимости браузеров. Цель, увести агентов от устаревших паттернов к решениям, которые используют возможности современной веб-платформы. Проектом, как сказано в README, руководят команды Google Chrome, Microsoft Edge, Mozilla Firefox и MDN вместе с сообществом веб-разработчиков.

Проблему README формулирует так: кодинг-агенты часто выбирают старые приёмы, потому что в обучающих данных языковых моделей очень много устаревшего кода. В результате они генерируют раздутый JavaScript там, где уже есть нативные производительные решения платформы. Даже если модель знает о существовании API, ей, по словам авторов, не хватает плотности реальных современных примеров реализации, нужных для кода уровня продакшена.

Командная строка навыка возвращает в контекстное окно агента целевые рекомендации, подготовленные экспертами. Они сосредоточены на трёх направлениях: современные API браузера (помочь моделям правильно строить API, которые они часто применяют неверно); производительность и доступность (предпочтение API уровня платформы, которые браузер может оптимизировать и в которых есть встроенные средства доступности); ответственные запасные варианты (лёгкие fallback-решения вместо тяжёлых полифиллов и устаревших библиотек).

Охват, от новых возможностей веб-платформы за последние несколько лет до самых передовых. По заявлению авторов, руководства рассчитаны на экономию токенов: они прогоняют оценки (evals), чтобы убрать самое тривиальное содержание, которое модели и так знают. README указывает 250 современных веб-функций и 203 реальных сценария разработчиков.

Установка, интерактивным мастером: npx modern-web-guidance@latest install. Есть три команды: search (поиск руководств, например по запросу «animate a dialog modal backdrop»), retrieve (получить руководство по идентификатору, например animate-to-from-top-layer) и legacy-scan (просканировать кодовую базу на устаревшие паттерны, которые стоит модернизировать). Также в README есть ссылки на документацию, панель оценок (Eval Dashboard), исходный код и форму сообщения о проблеме; в качестве примера приведено руководство navigation-drawer.

Список руководств в README сгруппирован по темам. Среди них доступность (например, синхронизация aria-invalid с визуальным состоянием :user-invalid, учёт системного масштаба текста), встроенные в браузер ИИ-API (language-model на базе Prompt API, summarizer, translator, language-detection), современный CSS (контейнерные запросы, якорное позиционирование, subgrid, анимация к внутренним размерам, стилизация по состоянию дочерних элементов), формы (автозаполнение адреса, платежей, входа и регистрации, стилизуемый select, проверка полей только после взаимодействия пользователя, SMS-коды), веб-компоненты (custom elements, Shadow DOM, form-associated custom elements) и работа со временем через Temporal (расчёт интервалов, даты без привязки к часовому поясу, события с привязкой к часовому поясу IANA). Список в доступном тексте обрывается на середине записи.

Ключевые факты

  • Modern Web Guidance, набор навыков с командной строкой для кодинг-агентов; опубликован на GitHub в организации GoogleChrome.
  • Проектом руководят команды Google Chrome, Microsoft Edge, Mozilla Firefox и MDN вместе с сообществом веб-разработчиков.
  • Идея: в обучающих данных моделей много устаревшего кода, поэтому агенты пишут раздутый JavaScript там, где есть нативные API платформы; CLI подставляет в контекст агента экспертные руководства.
  • README заявляет охват в 250 современных веб-функций и 203 реальных сценария разработчиков; руководства прогоняют через evals, чтобы убрать то, что модели и так знают.
  • Команды: install (интерактивная установка через npx), search, retrieve и legacy-scan для поиска устаревших паттернов в кодовой базе.

Почему это важно

Кодинг-агенты опираются на обучающие данные, где устаревший код встречается чаще современного, и по умолчанию тянутся к старым приёмам и тяжёлым библиотекам. Здесь за исправление берутся те, кто делает сами браузеры и документацию веб-платформы: проектом руководят команды Chrome, Edge, Firefox и MDN. Это попытка дать агентам актуальные рекомендации из первых рук, а не полагаться на то, что модель «помнит» из обучения.

Кому это важно

Веб-разработчикам, которые пишут код вместе с ИИ-агентами и получают от них JavaScript в стиле прошлых лет. Командам, которые поддерживают большие кодовые базы и хотят найти устаревшие паттерны (для этого есть команда legacy-scan). Тем, кто занимается доступностью и производительностью интерфейсов: именно эти темы авторы выделяют среди приоритетов.

Как это применить

Установить навык интерактивным мастером: npx modern-web-guidance@latest install. Дальше агент (или сам разработчик) может искать руководства командой search, например по запросу «animate a dialog modal backdrop», забирать нужное по идентификатору через retrieve и сканировать проект командой legacy-scan, чтобы увидеть, что стоит модернизировать. Альтернативные способы установки описаны в README, но в доступном тексте не приведены. Какие именно агенты поддерживаются, в видимой части README не сказано.

Можно ли доверять

Все утверждения о проблеме и о пользе проекта взяты из README самого проекта, то есть это описание от авторов. Источник, официальный репозиторий в организации GoogleChrome, а руководят проектом команды основных браузеров и MDN. Результаты оценок в видимом тексте не показаны: есть только ссылка на панель Eval Dashboard, поэтому заявление об эффективности руководств по тексту проверить нельзя. Цифры 250 функций и 203 сценария, заявление авторов.

Риски и подводные камни

Эффект зависит от того, насколько хорошо агент использует подмешанные рекомендации; независимых замеров в доступном тексте нет. Что именно скрывается за 250 функциями и 203 сценариями (например, сколько всего руководств), из видимого текста не ясно. Часть описанных руководств посвящена новым и экспериментальным возможностям, встроенным в браузер ИИ-API (Prompt API, Summarizer, Translator) и Temporal; поддержку этих API в нужных браузерах придётся проверять отдельно. Список руководств в доступном тексте обрывается, поэтому полный перечень нужно смотреть в репозитории.