Vercel научила AI-агентов понимать продуктовые решения, а не только копировать код

Vercel опубликовала подробное описание своей системы product-design — инструментария, который помогает AI-агентам не просто копировать стиль и паттерны, но понимать, почему именно такой компонент, фраза или взаимодействие стали стандартом в продукте.

Агенты не понимают «почему»

Современные coding-агенты справляются с задачами быстро: пишут рабочий UI, копируют визуальный стиль, повторяют паттерны из репозитория. Проблема в другом — они не понимают причин, стоящих за этими решениями. Логика конкретного компонента, формулировки или взаимодействия обычно хранится в Slack-тредах, комментариях к design review, репликах в PR и в памяти людей, которые были на том совещании. Для агента этого контекста не существует: он работает только с тем, что попало в кодовую базу. Vercel подошла к проблеме радикально: все принятые продуктовые решения теперь живут в репозитории наравне с кодом. Они проходят ревью при изменениях и автоматически доступны любому агенту, работающему в проекте.

Что внутри системы

Система состоит из трёх компонентов. Скилл живёт в `.agents/skills/product-design/` прямо рядом с кодом, которым управляет. Внутри два ключевых раздела. `references/` содержит документацию по продуктовым решениям, качеству интерфейса, resilience, копирайтингу, глоссарий терминов и `coverage-gaps.md` — список областей, где стандарт ещё не сформирован. `exemplars/` документирует решения из прошлых PR, которые стоит повторять, и ошибки, которых нужно избегать. Линтеры автоматически проверяют всё, что поддаётся машинной верификации. Всё, что можно проверить без участия человека, должно проверяться без него. Цикл обновления собирает сигналы из Slack, Figma и GitHub, агрегирует их и готовит обновления гайдлайнов для финального одобрения командой.

Как скилл маршрутизирует задачи SKILL.md работает как роутер.

Сначала определяет режим запроса: shape, implement, review, copy или harden. Это принципиально — аудит не должен превращаться в редактуру, а задача на копирайтинг не должна разрастаться в редизайн. Скилл также пропускает задачи без видимого UI-влияния: backend-only логика, телеметрия, сгенерированные файлы. После определения режима скилл маршрутизирует к нужным источникам с учётом типа задачи и конкретной поверхности: Изменения в материалах интерфейса загружают `product-judgment.md` и `interface-quality.md` Работа с текстами ведёт к `copy.md` и каноничным глагольным формам продукта Модальное окно — паттерны деструктивных действий и canonical verbs Форма настроек — лейблы, валидация, progressive disclosure, accessible-name guidance Скилл не дублирует источники: Component API, правила дизайн-системы и критерии доступности остаются у своих владельцев — скилл только ссылается на них.

«Код показывает агентам, что было выпущено, — но не почему именно этот компонент или взаимодействие стали стандартом», — из документации

Vercel.

Что это значит

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