Модуль 1 · Идея и спецификация · урок 1 из 13
Вайбкодинг и агентная инженерия: в чём разница
Слово «вайбкодинг» сегодня значит что угодно: от «накидал прототип за вечер, не открывая код» до «вся команда пишет через агента». В этом курсе мы разведём эти режимы и пройдём путь от идеи до работающего продукта так, чтобы на выходе был не одноразовый прототип, а код, который можно поддерживать.
Два режима работы с агентом
Термин vibe coding в феврале 2025 года ввёл Андрей Карпаты: вы описываете, что хотите, принимаете всё, что предложила модель, и не читаете код. Для прототипа на выходные это нормально — если не взлетит, выбросите.
Саймон Уиллисон в гайде Agentic Engineering Patterns описывает другой режим — агентную инженерию (agentic engineering). Агент сам пишет, запускает и дорабатывает код, а профессионал направляет его и отвечает за результат. Разница не в инструменте: и там и там может работать один и тот же Codex. Разница в том, кто проверяет.
| Вайбкодинг | Агентная инженерия | |
|---|---|---|
| Код читают | почти никогда | там, где цена ошибки высока |
| Проверка | «вроде работает» | тесты, линтеры, ревью, запуск |
| Знания о проекте | в голове и в чате | в репозитории: спецификация, AGENTS.md, планы |
| Жизнь кода | дни | месяцы и годы |
На практике это спектр. Внутри одного проекта вы можете вайбкодить экран настроек и очень внимательно вести код авторизации.
Сквозной проект курса
Все уроки продвигают один продукт — внутренний сервис «Переговорки» для офиса на несколько десятков человек:
- сотрудник входит по корпоративной почте, видит занятость комнат и бронирует слот;
- пересекающиеся брони невозможны;
- офис-менеджер заводит комнаты;
- расписание комнаты можно подписать в календаре, отмены уходят уведомлением в рабочий мессенджер;
- сервис живёт на стенде и в продакшене, деплоится из GitLab CI.
Задача нарочно приземлённая: в ней есть всё, на чём ломаются вайбкод-проекты, — время и часовые пояса, гонки при одновременной записи, права доступа, секреты, миграции базы.
Стек — TypeScript на Node.js, PostgreSQL, React. Почему именно он и как выбрать свой, разберём в уроке про стек. Если ваша команда пишет на PHP, все приёмы переносятся на Laravel почти без изменений.
Где без чтения кода нельзя
Честное правило курса: агент пишет почти весь код, но некоторые места вы читаете сами, строка за строкой:
- схема базы и миграции — их трудно откатить;
- авторизация и проверка прав — ошибка здесь не видна в интерфейсе;
- всё, что касается денег, персональных данных и секретов;
- тесты, которые написал агент, — иначе они проверяют то, что он сделал, а не то, что нужно.
Остальное проверяет механика: тесты, типы, линтер, ревью командой /review. Её мы будем выстраивать с первого урока.
Что понадобится
Пройденный курс «Codex с нуля»: вы умеете запускать Codex CLI, понимаете песочницу и одобрения, работаете с git. Нужны Node.js 22, Docker для базы и локальный репозиторий в GitLab или GitHub. Работать можно в CLI или в режиме Codex в ChatGPT desktop app: промпты одинаковые, а команды терминала из уроков в приложении заменяет его интерфейс.
Попробуйте сами
10–15 мин на рабочем месте- Вспомните последний прототип, который вы или коллеги собрали с агентом. Выпишите, что в нём пришлось бы переделать, чтобы им пользовались каждый день.
- Заведите пустой репозиторий
roomsи сделайте первый коммит с README из одной строки — к нему мы вернёмся в следующем уроке.
Коротко
- Вайбкодинг — принять код не глядя; агентная инженерия — агент пишет, человек направляет и проверяет.
- Это спектр: строгость зависит от цены ошибки в конкретном месте.
- Сквозной проект курса — сервис бронирования переговорок с базой, входом и деплоем.
- Схему базы, права доступа, секреты и тесты агента читаем сами.