AgenturaРазобрать задачу

Вайбкодинг: 12 правил, после которых ИИ-агент перестаёт ломать ваш проект

· 6 мин чтения

Содержание

  1. Что вообще реально свайбкодить без программиста
  2. 1. Код пишите в агенте, а чат оставьте для текстов
  3. 2. GitHub с первого дня
  4. 3. Одна задача - один диалог
  5. 4. Режьте задачи на куски по полчаса
  6. 5. Сначала план, потом код
  7. 6. Задание храните в файле, а в чате - ссылку на него
  8. 7. Ведите памятку проекта для агента
  9. 8. Самопроверка: агент принимает работу первым
  10. 9. Просите тесты на каждую важную функцию
  11. 10. Просите логи - чинить по фактам вместо догадок
  12. 11. Секреты - вне чата и вне репозитория
  13. 12. Повторяющиеся действия превращайте в команды
  14. Вопросы про вайбкодинг
  15. Что запомнить

Вайбкодинг - это когда вы описываете задачу словами, а ИИ-агент превращает её в работающий код. Порог входа упал до нуля, и вместе с ним упал порог входа в хаос: проект из сотни файлов, где всё держится на удаче, ломается от любой правки.

Мы в Агентуре живём в этом режиме каждый день: флот из семи ИИ-агентов пишет код нашей CRM, собирает сайты и ведёт этот блог. Ниже - 12 правил, которые отделяют управляемую разработку от лотереи. Все выстраданы на собственных проектах.

Что вообще реально свайбкодить без программиста

Спокойно: сайт, лендинг, блог, внутренний инструмент (калькулятор смет, генератор отчётов), телеграм-бот, автоматизация рутины, прототип продукта для проверки спроса. С оговорками: всё, где крутятся чужие деньги и персональные данные, - там самостоятельный потолок наступает быстро, и финальную милю лучше проходить с командой.

Теперь правила.

1. Код пишите в агенте, а чат оставьте для текстов

ChatGPT и Claude в браузере хороши для писем и идей, но код они отдают вам куском текста - а куда его вставлять, разбирайтесь сами. Агент для кода (Claude Code, Codex) работает прямо в папке проекта: сам создаёт файлы, сам запускает, сам видит ошибки и сам их чинит. Разница как между советом по телефону и мастером, который приехал с инструментом.

2. GitHub с первого дня

GitHub - бесплатная история всех версий вашего кода. Попросите агента создать приватный репозиторий и сохранять каждую законченную правку. Это страховка от двух бед сразу: от неудачной переделки (откат одной командой) и от гибели ноутбука. Без истории версий любая ошибка агента - безвозвратная.

3. Одна задача - один диалог

Длинный чат накапливает мусор: старые обсуждения путают агента, и он начинает тащить в новую задачу решения из прошлой. Закончили задачу - закройте диалог, начните свежий. Контекст проекта агент возьмёт из памятки (правило 7) - переписка недельной давности для этого лишняя.

4. Режьте задачи на куски по полчаса

«Сделай мне CRM» - путь к разочарованию: агент нагенерирует гору кода, которую страшно трогать. «Добавь в таблицу клиентов колонку со статусом оплаты» - задача, результат которой видно за один заход. Правило простое: если работу нельзя проверить за 10 минут, режьте её дальше.

5. Сначала план, потом код

Заканчивайте каждую крупную постановку фразой: «покажи план и задай уточняющие вопросы, код пиши только после моего согласия». Агент предложит подход, вы поймаете лишнее до того, как оно станет кодом. Пять минут на план экономят час на переделку.

Свайбкодили прототип, а он уже приносит заявки и его страшно трогать? Разберём код, укрепим слабые места и доведём до состояния, за которое спокойно.

Разобрать мой прототип

6. Задание храните в файле, а в чате - ссылку на него

Для задач крупнее пары абзацев заведите файл с постановкой прямо в проекте: что делаем, зачем, что считается готовым. Агенту в чат - одна строка: «работай по заданию из файла». Выгода двойная: задание переживает любой перезапуск диалога, а агент сверяется с ним на каждом шаге вместо того, чтобы додумывать.

7. Ведите памятку проекта для агента

В корне проекта живёт файл-памятка (у Claude Code он называется CLAUDE.md): что это за проект, как он устроен, как запускать, что запрещено трогать, какие решения уже приняты. Агент читает её в начале каждого диалога. Каждый раз, когда агент ошибся из-за незнания контекста, - дописывайте строчку в памятку. Через месяц у вас агент, который знает проект лучше подрядчика.

8. Самопроверка: агент принимает работу первым

Привыкайте заканчивать задачу фразой: «проверь результат и напиши, что именно проверил». Для сайтов работает магия скриншотов: агент умеет снять страницу, посмотреть на неё и сам заметить съехавшую вёрстку. Самопроверка ловит половину ошибок до вас - а вторую половину прокликивайте руками: форму, ссылки, мобильную версию.

9. Просите тесты на каждую важную функцию

Тест - это код, который проверяет ваш код: посчитала ли смета правильную сумму, ушла ли заявка. Просите агента: «напиши тесты на это и запускай их после каждой правки». Смысл для непрограммиста огромный: тесты - ваш контролёр качества, который бесплатно и мгновенно ловит поломки в старом коде после новых правок.

10. Просите логи - чинить по фактам вместо догадок

Лог - это дневник программы: что запустилось, что пришло, где упало. Когда что-то ломается, агент с логами чинит причину, а без логов - гадает. Одна фраза при постановке: «добавь подробные логи ключевых шагов». Окупается первым же сбоем.

11. Секреты - вне чата и вне репозитория

Пароли, ключи API, доступы к серверу держите в отдельном файле (обычно .env), который исключён из GitHub через .gitignore. В чат с нейросетью секреты тоже вставлять нельзя - попросите агента самому прочитать их из файла. И раз в месяц спрашивайте: «проверь, что секреты нигде, кроме .env, и файл в .gitignore». Утёкший ключ - это чужие расходы на вашей карте.

12. Повторяющиеся действия превращайте в команды

Всё, что вы просите чаще двух раз («собери и выложи на сервер», «проверь тексты на ошибки», «сними скриншоты всех страниц»), агент может оформить в готовую команду-сценарий. Дальше это одно слово вместо абзаца объяснений - и ноль шансов забыть шаг. Так рутина превращается в кнопку.

Вопросы про вайбкодинг

Что такое вайбкодинг простыми словами? Разработка, где код пишет ИИ-агент, а человек ставит задачи и принимает результат. Роль автора кода сменилась ролью заказчика.

С чего начать, если я вообще без опыта? Поставьте Claude Code, возьмите подписку за 20 $ и соберите простой сайт - это лучший тренажёр. Пошаговый разбор - в статье как сделать сайт с помощью ИИ. Про оплату из России: карты РФ сервис отклоняет, платить придётся зарубежной картой или через посредников; посредники формально нарушают правила Anthropic, аккаунт могут заблокировать вместе с подпиской - правило 2 (GitHub с первого дня) как раз страхует от такой потери.

Какие инструменты выбрать? Терминальный агент (Claude Code или Codex) плюс GitHub. Конструкторы с ИИ внутри дают быстрый старт, но код живёт на чужой платформе и потолок наступает раньше.

Сколько это стоит в месяц? Подписка на модель ~2 000 ₽. Для сайта добавьте сервер от 300 ₽ и домен от 200 ₽ в год. Итого - дешевле одного часа работы студии.

Где предел вайбкодинга? Деньги, персональные данные, нагрузка. Прототип и внутренние инструменты - смело сами; продукт, где ошибка стоит денег клиентов, доводите с командой.

Что запомнить

Хотите такой же агентный конвейер под ваши задачи - без месяцев проб и ошибок? Покажем на вашем проекте, что можно автоматизировать уже сейчас.

Разобрать задачу
Дмитрий Симаков

Дмитрий Симаков

Основатель Агентуры, автор блога

Привет! Я строю агентные контуры для бизнеса и работаю на собственном флоте из семи ИИ-агентов. Среди кейсов: CRM премиум-бутика в Telegram, автоматизация event-производства, агентный конвейер этого блога. Ещё больше практики - в моём Телеграм-канале.

Подписаться на канал

Тема ближе к делу, чем к чтению? Смотрите услугу: Доработка MVP до продакшена