Vibe coding: как разрабатывать с AI-помощником и проверять результат
Vibe coding — это способ разработки, при котором задача формулируется на естественном языке, а AI-помощник предлагает код, тесты, конфигурацию или объяснение. Название подчёркивает скорость и поток, но не отменяет главное правило: сгенерированный фрагмент остаётся черновиком, пока человек не проверил код, поведение и зависимости. Такой подход экономит время на рутине, но требует дисциплины сильнее, чем обычное автодополнение.
Речь не о том, чтобы попросить AI написать проект и принять результат. Практическая ценность появляется, когда AI-помощник встроен в понятный цикл: постановка задачи, маленькое изменение, чтение diff, автоматические проверки, ручной прогон, проверка зависимостей и только потом merge. Ниже — рабочий каркас для такого цикла.
Что такое Vibe coding и где он уместен
Vibe coding не равен no-code и не означает отказ от инженерных знаний. В редакторе или чате вы описываете намерение, ограничения и ожидаемое поведение, а модель предлагает вариант реализации. Отличие от автодополнения — в масштабе: AI может предложить целый модуль, набор тестов, миграцию, конфигурацию CI или разбор незнакомого API. Чем больше фрагмент, тем важнее его проверить.
Подход уместен там, где цена ошибки ограничена и результат можно быстро проверить:
- черновики прототипов и внутренних инструментов;
- небольшие рефакторинги с понятными тестами;
- заготовки тестов, документации и примеров использования;
- разбор библиотеки или API, после которого вы сверяете вывод с официальной документацией.
Ограничивать генерацию без серьёзного review стоит в коде, который отвечает за аутентификацию, платежи, персональные данные, миграции данных, инфраструктуру и юридически значимые процессы. Там ошибка может быть дорогой, а уверенный тон ответа AI не заменяет проверку. Если фрагмент затрагивает права доступа или секреты, привлекайте человека, который отвечает за этот участок.
Полезная роль AI-помощника — быть объясняющим партнёром. Можно попросить разобрать незнакомый участок, предложить варианты структуры или перечислить вопросы к задаче. Но итоговое решение должно опираться на документацию проекта, тесты и понимание последствий, а не на правдоподобность ответа.
Как выглядит безопасный цикл работы с AI-помощником
Безопасный цикл начинается не с промпта, а с границ задачи. Сформулируйте, что должно измениться, что трогать нельзя, какие сценарии важны и как вы поймёте, что результат верный. Чем конкретнее контекст, тем меньше вероятность, что AI придумает лишнюю абстракцию или незаметно поменяет поведение соседнего кода.
- Опишите задачу и ограничения: ожидаемое поведение, входные данные, ошибки, совместимость, файлы или модули.
- Попросите AI сначала объяснить план и допущения, а код — небольшими частями.
- Вносите одно смысловое изменение за раз, чтобы diff можно было прочитать.
- Прочитайте каждую строку diff: что удалено, что добавлено, какие побочные эффекты появились.
- Запустите автоматические проверки: тесты, линтер, проверку типов, сборку и CI.
- Проверьте поведение руками: успешный сценарий, ошибки, пустые состояния, права, повторные действия.
- Проверьте новые зависимости и только после этого коммитьте изменение.
Для автоматизаций, где AI обрабатывает данные, полезен тот же принцип: проверки на входе, понятные исключения и передача спорных случаев человеку. Об этом отдельный материал про AI-автоматизацию. В разработке роль человека похожа: он не переписывает каждый символ, но отвечает за границы, проверку и решение о выпуске.
Если AI предлагает рефакторинг за пределами задачи, меняет публичный интерфейс или добавляет новую библиотеку без запроса, это повод остановиться. Отклоните лишнее и сузьте задачу. Большой diff, который вы не можете объяснить, — не признак продуктивности, а сигнал о риске.
Проверка кода: читать, а не соглашаться
Сгенерированный код может выглядеть аккуратно и при этом решать не ту задачу. Поэтому читайте diff как изменение системы, а не как текст. Начните с вопроса, что именно поменялось и почему. Затем проверьте, не появились ли новые сетевые вызовы, файлы, разрешения, отключённые проверки или обходные пути, которых не было в задаче.
Отдельно смотрите на обработку ошибок и входных данных. Пустые значения, неверный формат, большие объёмы, повторная отправка, таймаут и отмена — типичные места, где черновик расходится с реальностью. Проверьте, что ошибки не раскрывают лишние детали, секреты не попадают в логи, а права доступа проверяются на нужном уровне. Если код непонятен, не соглашайтесь на merge только потому, что тесты зелёные.
Предупреждение. Не вставляйте в AI-чат ключи доступа, токены, пароли, реальные персональные данные клиентов и внутренние документы. Для контекста используйте обезличенные примеры. Перед использованием сервиса сверьтесь с правилами вашей организации и условиями выбранного инструмента.
Полезно просить AI не только написать код, но и перечислить риски: какие входы он не покрыл, где возможна гонка, что будет при ошибке сети, какие assumptions он сделал. Такой список не является проверкой, но помогает найти места для собственного review.
Смотрите и на поддерживаемость. Новый код должен вписываться в принятые в проекте соглашения, не дублировать существующие функции и не создавать скрытую связанность. Если ради простой задачи появился новый слой абстракции, спросите, нельзя ли решить её проще. Простота обычно облегчает проверку и поддержку.
Проверка поведения: тесты, сценарии и ручной прогон
Проверка поведения отвечает на вопрос, делает ли код то, что нужно пользователю и системе. Юнит-тесты важны, но они не заменяют запуск приложения и ручной прогон сценария. Проверьте успешный путь, ошибочные входы, пустые состояния, недостаточные права, повторное действие, отмену операции и поведение при недоступном внешнем сервисе.
Минимальный набор проверок поведения
Сформулируйте короткий сценарий до запуска: что пользователь делает, что ожидает увидеть и какие данные меняются. Затем пройдите его в среде, близкой к реальной. Сравните не только экран, но и побочные эффекты: записи в базе, отправленные события, логи, письма, фоновые задачи. Если изменение затрагивает права доступа, проверьте его под разными ролями, а не только под администратором.
Почему тесты от AI тоже нужно проверять
Тест может быть написан под ошибочную реализацию и закреплять неверное поведение. Проверьте, что он действительно падает без исправления и проверяет обещанное, а не внутреннюю деталь. Смотрите на утверждения, моки и граничные значения. Хороший признак — тест можно объяснить своими словами и он не зависит от случайного порядка или внешней сети.
Если автоматических тестов нет, зафиксируйте ручной сценарий в описании изменения. Это помогает review и снижает риск, что проверка останется только в памяти автора. Для небольших правок достаточно короткого списка шагов, для рискованных изменений — более подробного.
Зависимости: проверяйте не только название пакета
Зависимости — отдельная зона риска, потому что AI может предложить пакет с похожим названием, несуществующую версию или библиотеку с несовместимой лицензией. Не устанавливайте пакет только потому, что он упомянут в ответе. Сверьте точное имя и версию в официальном реестре пакетов, посмотрите maintainer, историю релизов, лицензию, известные уязвимости и транзитивные зависимости.
Проверьте, не появляются ли в проекте новые скрипты установки, бинарные артефакты или источники пакетов. Зафиксируйте версии в lockfile и убедитесь, что CI использует те же правила установки. Если пакет внутренний, действуйте по политике организации: кто его поддерживает, как обновляется, какие ограничения есть для сторонних библиотек.
Для браузерных расширений и плагинов отдельно смотрите разрешения и интерфейсы, которые запрашивает код. Если AI помогает с таким проектом, полезен разбор разработки расширений для Firefox с проверкой интерфейсов и разрешений. Принцип общий: каждое новое разрешение или зависимость должны быть объяснены и проверены до выпуска.
Не забывайте про обновления. Даже проверенный пакет со временем получает новые версии и уязвимости. Команде нужен понятный порядок обновления зависимостей и проверки, что изменение не ломает сборку. AI может помочь сравнить версии, но решение об обновлении принимает человек.
Как встроить подход в командную работу
Vibe coding плохо работает как негласная практика. Если часть команды генерирует код, а часть об этом не знает, review превращается в формальность. Договоритесь, какие данные можно передавать AI-инструментам, кто отвечает за merge и какие проверки обязательны для изменений, созданных с помощником.
Практичный минимум: небольшие pull request, шаблон описания с указанием, что сгенерировано и как проверено, обязательный CI, review человеком и понятный владелец кода после merge. Для новичков полезно требование объяснить изменение своими словами. Это не бюрократия, а способ не потерять понимание системы.
Оценивайте не скорость генерации, а долю изменений, которые проходят проверки без переделки, и количество дефектов после выпуска. Если AI-помощник ускоряет черновик, но увеличивает время review, команде нужен другой промпт, другой размер задачи или более строгие границы. Ответственность за код остаётся у людей, даже если первая версия появилась из ответа модели.
В распределённой команде правила стоит записать, а не держать в переписке. Это помогает новым участникам и снижает разницу в ожиданиях. Полезно договориться, какие задачи можно начинать с AI, а какие требуют предварительного обсуждения. Такой подход сохраняет скорость, но не делает качество случайным.
Подход с AI-помощником — это безопасно?
Сам по себе подход не гарантирует безопасность. Риск зависит от того, какие данные вы передаёте AI, как проверяете код, тесты и зависимости. Для прототипа порог ниже; для production нужен review, CI, проверка прав доступа и секретов.
Можно ли использовать такой подход без опыта программирования?
Можно получить черновик или учебный пример, но production-код требует понимания языка, среды и последствий. Если опыта нет, нужен наставник или review. AI может предложить правдоподобное, но неверное решение.
Что проверять перед merge?
Diff, обработку ошибок, права доступа, секреты, тесты, ручное поведение, зависимости, лицензии и CI. Если фрагмент непонятен, merge лучше отложить и разобраться.
Как проверять зависимости, которые предложил AI?
Сверяйте точное имя и версию в официальном реестре пакетов, смотрите maintainer, лицензию, уязвимости, транзитивные зависимости и lockfile. Не устанавливайте пакет только потому, что он есть в ответе.
Заменяет ли AI-помощник разработчика?
Нет. Он меняет распределение работы: AI ускоряет черновик, человек отвечает за постановку задачи, проверку и поддержку. Ответственность за код остаётся у команды.