Что нужно продумать до того, как ИИ начнет писать код

О вайбкодинге сегодня говорят многие. Он подразумевает ускорение разработки за счёт того, что код пишет не человек вручную, а ИИ по текстовому описанию задачи. Агент сам предлагает решения, находит ошибки и собирает прототип.
Но быстро сгенерировать код — еще не значит получить решение, которое можно развивать дальше. Разберем это на примере Proof of Concept — прототипов, с помощью которых команды проверяют, работает ли идея и стоит ли превращать ее в полноценный продукт.

Обычно на PoC отводят несколько дней или недель, поэтому главная задача — успеть показать результат. Архитектура и тесты отходят на второй план, а если гипотеза подтверждается, значительную часть демо приходится переписывать перед переходом к MVP.

Вайбкодинг ускоряет сборку прототипа: разработчик описывает задачу, а ИИ-агент пишет код, исправляет ошибки и предлагает технические решения. Но без заданной структуры агент может по ходу работы менять логику проекта, отходить от требований и создавать код, который трудно поддерживать.

Чтобы разработка оставалась управляемой, следует зафиксировать Vision — документ в формате Markdown (.md), в котором команда описывает общую идею будущего решения:

➖ что и для кого создается;
➖ какую проблему решает продукт;
➖ какие функции войдут в первую версию;
➖ какие есть ограничения.

На основе этого документа ИИ генерирует прототип, придерживаясь заданных рамок. Только после этого агент переходит к коду.

После каждой итерации документы обновляются вместе с кодом. Требования и архитектура становятся частью процесса разработки, а не остаются отдельными файлами, которые быстро теряют актуальность. На выходе команда получает не одноразовое демо, а понятную структуру, тесты и код, который можно развивать дальше.