Инструкция вайбкодера
Как человек, который учился писать код с нуля, я испытываю смешанные чувства, когда речь заходит о вайбкодинге:
- я рада, что больше не нужно неделю чинить баг (и в конце концов понять, что где-то скобка не закрыта);
- я не понимаю теперь, в чём заключается моя работа и кому она нужна;
- я чувствую облегчение о того, что теперь могу отправить коллег в ChatGPT и не разбирать каждую мелочь типа “собрать n эксель-табличек в одну”;
- я в ужасе от мысли о том, какие ошибки могут прокрасться в код и обвалить всю систему в самый неподходящий момент.
На всякий случай уточню, что вайбкодинг — это когда вы пишете нейросети: “Напиши код,” — и она пишет код, а вы нет.
Посидев с этими чувствами некоторое время, я решила написать базовую инструкцию для тех, кто взялся писать код, но не умеет его читать. Я никогда не была разработчиком высшей лиги, но кое что кое в чём понимаю. Кроме того, я уже успела понаблюдать кое-какие косяки, которые люди делают, создавая код с ИИ. И наделать ошибок самостоятельно, разумеется. В общем, надеюсь, кому-то эта моя писанина пригодится.
Если вы кодер, напишите, что я забыла и что ещё стоит учесть. Если вы вайбкодер, напишите, с чем сами столкнулись. Что было сложно и непонятно, какие у вас были ошибки. Что понравилось, тоже напишите обязательно.
Самое Важное Правило (СВП)
Ответственность за результат несёте вы.
“Нейросеть мне наврала” и прочие подобные штуки есть снятие с себя ответственности. Это как сказать: “Молоток ударил меня по пальцу.”
Нейросеть — очень сложный многофункциональный молоток, им размахивать надо аккуратно и со знанием дела. Но это не субъект — субъект вы.
Это, впрочем, не должно вогнать вас в ужас и совсем остановить от использования нейросетей в работе. Ошибки вы будете делать что с ИИ, что без ИИ. Работа с кодом состоит на 5% из того, что вы пишете код, и на 95% из того, что вы пялитесь в экран, пытаясь осознать, что только что произошло и почему не произошло того, что вы задумали. Это нормально.
Если вы не управляете ядерным реактором, от ваших ошибок никто не помрёт. Скорее всего. Не могу поручиться, но скорее всего. Если вы управляете ядерным реактором, бога ради, закройте этот текст.
От ваших ошибок, впрочем, могут утечь чувствительные данные клиентов, обрушиться веб-сайт или что-то в этом роде — тоже не очень приятно. Нам такое не нужно. Именно поэтому нам нужно СВП: оно направляет нашу творческую энергию на эксперименты, но не позволяет уж слишком разойтись.
Остальные правила (тоже важные)
Не пропускайте непонятное
Самые безумные путешествия начинаются с фразы “Я знаю короткую дорогу,” а самые запутанные ошибки — с “Я не знаю, что он мне тут понаписал, ну да и фиг с ним.”
Вы же общаетесь с нейросетью. Она не злится и не устаёт. Так задавайте ей вопросы! Столько вопросов, сколько нужно, чтобы вы всё поняли. “Объясни как неандертальцу, причём пятилетнему” — рабочая схема. Вы будете знать, что написано в вашем коде, и это даже ещё не все плюсы.
Во-первых, вы будете знать, что написано в коде.
Во-вторых, вы кое-что узнаете про то, как пишутся приложения — это интересно, честное слово. Со временем вы сможете сознательно выбирать наиболее подходящие решения под ваш случай.
В-третьих, нейросети периодически делают ошибки, и пока вы их допрашиваете, они исправляются. Кругом польза, короче говоря.
Освойте контроль версий
git.
Тут будет непросто, сразу говорю: git — это больно. Я видела опытных (гораздо более опытных, чем я сама) разработчиков, которые от него на стенку лезли. А уж сколько раз я от него не стенку лезла…
Но git спасёт ваш проект, и не раз. Он не даст перезаписать версию или потерять кусок кода. Он позволит откатиться назад и начать с последней удачной точки. Он поддержит ваши эксперименты и никому не позволит сломать то, что работает. Он неумолим как каменная стенка, но за этой стенкой вся ваша работа в полной безопасности.
И ради всего, что для вас свято (и чего-нибудь ещё, если у вас нет ничего святого), не передавайте управление git нейросетям. Ещё нет.
Большие и продвинутые модели сегодня уже очень хорошо пишут код и здорово подсказывают, что ещё можно улучшить. Но есть у них серьёзный недостаток: они иногда вместо решения проблемы пытаются подставить костыль, чтобы её обойти. Например, у вас код не проходит тест и выдаёт ошибку, и нейросеть меняет не сломанный код, а правильный тест.
Встроенные механизмы защиты git можно обойти, но этого нельзя делать, если вы не понимаете на 115%, что конкретно и зачем вы собираетесь сделать.
И тогда всё равно нельзя.
Вы рискуете потерять кусок своей работы или снести часть работы коллег, если у вас команда. Поэтому с git только ручками, чтобы всё было под вашим полным контролем.
Возможно, вскоре нейросети станут надёжнее в этом плане, но в начале июля 2026 года я вам настоятельно советую в git их не пускать. У нейросети можно спросить, что делать, и попросить объяснить команду.
Если в команде есть --force или --hard, не надо. Просто не надо. В редких случаях это оправдано, но в таких редких, что общее правило — не надо.
Берегите данные
Логины, пароли, адреса электронных почт, API-ключи и прочие подобные вещи — они называются “секреты” — в коде держать нельзя: если кто доберётся до кода, получит всё в своё распоряжение.
Вам может быть сложно вычистить все секреты самостоятельно. Натравите на код нейросеть, а ещё лучше — воспользуйтесь инструментом, который называется pre-commit hooks.
Это дополнительные инструменты git — такие специальные маленькие программы, каждая из которых решает конкретную задачу. Есть те, которые удаляют лишние пустые строки в конце ваших файлов, а есть те, что ловят похожие на пароли записи в вашем коде. Они не идеальны, но очень полезны — советую про них почитать. Можно начать, например, с этой статьи: там как раз про удаление чувствительных данных из кода.
Такие программки проверяют ваш код до того, как он покинет ваш компьютер, что очень удобно.
В самом начале пути не набирайте себе по сто штук — начните с самых важных, а потом потихоньку добавляйте. Дело в том, что эти программы будут либо вносить изменения в ваш код (в мелочах: например, удалят лишние пустые строки), либо требовать изменений от вас. Если их будет много, вы сойдёте с ума раньше, чем могли бы.
Используйте виртуальное окружение
Для работы приложений вам потребуются библиотеки — наборы функций, которые ваш код будет запускать. Они есть в разных версиях, сделаны разными людьми и могут друг с другом не работать.
Может быть такое, например, что для одного приложения вам нужны библиотеки А и Б, а для другого — библиотеки Б и В. Текущая версия библиотеки А работает только с версией Б-0.1.1, а текущая версия библиотеки В — только с версией Б-0.1.2. Если вы их просто к себе на компьютер установите, будет коллапс, и одно из двух приложений (а скорее оба) перестанут работать.
Виртуальное окружение — это такая песочница, в которой приложение изолировано от всех остальных. Все нужные библиотеки ставить надо туда.
Попросите вашу нейросеть дать вам нужные команды или настроить виртуальное окружение за вас (это делегировать можно, это не git). Только будьте внимательны: возможно, ваш ИИ-инструмент работает с собственным виртуальным окружением. Если вам надо какие-то команды запускать отдельно, не забудьте его активировать (ИИ подскажет, как).
С git и виртуальным окружением работаем через командную строку. Чтобы туда попасть, вам нужно приложение Terminal на MacOS или PowerShell на Windows.
Работайте над одной задачей за раз
Как бы ни было соблазнительно делать пять дел одновременно, это плохая идея. Это выглядит, как хорошая идея, но я вам клянусь, вы о ней будете жалеть, причём долго и интенсивно.
Разумный подход такой:
- взяли задачу;
- сделали виртуальное окружение;
- написали код;
- сохранили рабочую версию с git;
- взяли следующую задачу.
Так у вас всё под контролем. Вы можете вспомнить, что когда сделали и зачем, а ещё у вас в git много контрольных точек, и вы всегда можете вернуться на предыдущий шаг с минимальными потерями.
Современный мир шепчет нам: “Используй каждую секунду. Будь продуктивнее. Ты что, моргнул? Ленивая скотина,” — и это голос сатаны. Рабочая ёмкость нашего мозга ограничена биологически, и к её пределам подходить не нужно: вы немедленно теряете способность принимать здравые решения. Это нехорошо, так не надо.
Не забывайте отдыхать
Вставайте из-за стола. Занимайтесь спортом. Не забывайте пить воду. Спите нормально. Это правда важно.
Я знаю, как вайбкодинг может затянуть: вы сели решить задачку на полчаса, а очнулись с готовым приложением в два ночи. Нам такое вредно. Опять же, у мозга есть биологические потребности, и, если вы не будете принимать их во внимание, ваше внимание потеряет остроту, а решения — смысл.
И чего вы тогда наваяете?
Лучше поспите как следует, обнимите кота (опционально, при наличии последнего), попейте чаю, а потом уж садитесь за работу. Застряли на сложной ошибке? — Идите погулять. Кончились идеи? — Разомнитесь.
Полы можно в квартире вымыть, в конце концов. Пыль протереть на полках, до которых уже полгода руки не доходят (руки к вам прикреплены, их туда донести надо, если чо). Отвлечься.
У себя в телеграме я недавно писала, почему важно беречь и уважать мозг и давать ему необходимый отдых. Это правило, пожалуй, по важности должно следовать сразу после СВП. Но вы же за конкретными подсказками про код пришли, правильно? Поэтому оно тут.
Заключение
Это далеко не исчерпывающий список, но, думаю, для начала его будет достаточно.
Так уж получилось, что мы теперь все себе и бухгалтеры, и писатели, и программисты и кто только не. Это выматывает, даже если оно вам нравится. Мне хотелось вам дать хотя бы небольшую опору. Надеюсь, получилось.
Если остались вопросы, не стесняйтесь писать в комментариях. Помните: глупых вопросов не бывает, бывают глупые ответы. Я постараюсь ответить как следует.