Привет, это Валерий Баранов, руководитель технологий фронтенда в Яндекс 360. В нашей команде около 90% разработчиков используют AI-помощников.
Поначалу работа с ассистентом выглядит волшебно: он быстро генерирует MVP, и кажется, что за пару недель можно сделать что угодно. А затем мы входим в долину разочарования. Ассистент начинает ломать работающий код, предлагает компоненты, которых нет в проекте, и меняет собственные решения. Знакомая ситуация?
Обычно проблема не в модели, а в контексте: LLM не знает структуру вашего репозитория, не понимает внутренние библиотеки и не видит дизайн в Figma. Мы систематизировали подход и выделили три уровня, которые нужно закрыть, чтобы ассистент стал полноценным участником команды.
🅰️ Первый уровень — контекст проекта
Решение оказалось простым — файл
AGЕNТS.md. Это открытый стандарт, который поддерживают Cursor, GitHub Copilot и другие популярные ассистенты. Один файл задаёт карту проекта: структуру директорий, команды сборки, архитектурные конвенции и границы допустимого.Пишите только то, что модель не может узнать дёшево. Исследования показывают, что инструкции в повелительном наклонении («Используй CSS Modules для новых компонентов») AI выполняет в 94% случаев.
🅰️ Второй уровень — контекст библиотек
Для внутреннего UI Kit Orbita мы разработали собственный MCP-сервер. Через него модель получает актуальный API компонентов, токены и паттерны композиции. Это решает проблему, когда ассистент предлагает компоненты, которых нет в проекте, или использует устаревшие пропсы.
🅰️ Третий уровень — связь дизайна и кода
Мы договорились с дизайнерами: Figma задаёт требования, а реализация остаётся за кодом. Инструмент Figma Code Connect описывает маппинг свойств. Теперь LLM видит, как параметр называется в дизайне и коде.
🅰️ Что в итоге
В результате
AGENTS.md требует один день на настройку, MCP-сервер — около недели. За 28 дней можно синхронизировать всё с Figma. Вложения окупаются, ассистент перестаёт гадать и начинает генерировать корректный код.📖 А в полной статье на Хабре я рассказываю:
🔴 Как структурировать
AGENTS.md, чтобы он работал, а не пылился в репозитории🔴 Почему MCP-сервер для внутренней библиотеки меняет правила игры
🔴 Как синхронизировать Figma и код, чтобы ассистент не путал enabled с isDisabled
Подписывайтесь:
💬 @Yandex4Developers