Как привести вайбкод в порядок: план на две недели

Проект, собранный в Lovable, Bolt, Cursor или Claude Code, работает — и именно поэтому его страшно трогать. Привести вайбкод в порядок не значит переписать его. Это значит за две недели сделать так, чтобы ты знал, что у тебя есть, кто имеет к этому доступ, и мог менять код, не молясь перед каждым деплоем.

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

Дни 1–2: опись

Нельзя навести порядок в том, чего не видишь. Начни со списка, а не с кода:

где лежит код и сколько у него копий (репозиторий, экспорт из конструктора, папка на ноутбуке);
какие внешние сервисы подключены: база, хостинг, почта, оплата, ИИ, аналитика;
на чьи аккаунты они заведены и с какой карты оплачиваются;
какие домены, где DNS, кто продлевает.

Обычно на этом шаге находится пара сюрпризов: сервис, оплаченный с личной карты бывшего фрилансера, или вторая база, о которой все забыли. Запиши всё в один файл в репозитории — он станет основой документации.

Дни 3–4: секреты и доступы

Пройдись по коду и истории коммитов в поисках ключей. Всё, что хоть раз попадало в репозиторий или в клиентский бандл, считай утёкшим: перевыпусти и положи в переменные окружения. Заведи файл .env.example с названиями переменных без значений.

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

Дни 5–7: структура

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

Сложи код по фичам: всё про оплату — рядом, всё про профиль — рядом.
Вынеси обращения к базе и внешним API из компонентов интерфейса в отдельные модули.
Удали очевидно мёртвый код: закомментированные блоки, неиспользуемые файлы, третью версию одной и той же функции.
Переименуй то, что называется data2, newHandler, utils.

Делай это маленькими коммитами, по одному изменению на коммит. Если что-то сломалось, ты найдёшь причину за минуту, а не за вечер.

Дни 8–10: тесты на денежных потоках

Покрывать тестами всё не нужно. Нужно покрыть то, поломка чего стоит денег или доверия: регистрацию и вход, оплату и начисление, доступ к чужим данным, всё, что отправляет письма или списывает лимиты.

Начни с одного сквозного теста на главный путь пользователя: зарегистрировался, заплатил, получил то, за что платил. Потом добавь проверки на типичные дыры вайбкода — запрос к чужой записи должен получать отказ, повторный вебхук оплаты не должен начислять второй раз. Пять честных тестов полезнее пятидесяти, проверяющих, что кнопка синяя.

Дни 11–12: деплой

Если деплой сейчас — это «нажать кнопку в конструкторе» или «зайти на сервер и сделать git pull», его надо сделать повторяемым. Минимум:

отдельные окружения для разработки и продакшна с разными базами и ключами;
сборка и тесты запускаются автоматически на каждый push;
выкладка одной командой или по слиянию в основную ветку;
понятный способ откатиться на предыдущую версию.

Проверь откат на деле, а не на словах. Заодно убедись, что бэкап базы существует и из него можно восстановиться.

Дни 13–14: документация

Последние два дня — на то, чтобы всё сделанное не потерялось. Обнови README: как запустить проект локально, какие переменные окружения нужны, как устроены основные части, как выкатывать, где подводные камни. Перенеси туда опись из первых дней.

Хороший критерий готовности: новый разработчик поднимает проект на своей машине за час, ни разу тебе не написав. Если не получается — README ещё не дописан.

Чего не делать, когда приводишь вайбкод в порядок

Смена стека, переписывание с нуля, переход на микросервисы, идеальное покрытие тестами. Всё это может понадобиться, но решать это стоит после уборки, когда видно, что на самом деле мешает. Часто оказывается, что после двух недель порядка переписывать уже ничего не хочется.

Коротко

Привести вайбкод в порядок — это не переписать, а сделать проект понятным, безопасным и предсказуемым.
Начинай с описи сервисов и аккаунтов, затем перевыпусти секреты и почисти доступы.
Структуру меняй маленькими коммитами: по фичам, с вынесенным доступом к данным, без мёртвого кода.
Тестами в первую очередь закрывай деньги, вход и доступ к чужим данным.
Закончи повторяемым деплоем с откатом и README, по которому проект поднимается без тебя.

Если на две недели нет рук, SUBXCAT может пройти этот план вместе с твоей командой.