ИИ-инжиниринг для разработчиков: Senior, Junior, Vibe
Одна задача, один ИИ-агент и три разработчика разного уровня подготовки: вайб-кодер, младший и старший разработчик. В этой статье я разбираю, как каждый из них ставит задачу агенту, какие ошибки допускает, что получает на выходе и во что этот результат обойдётся через полгода. Кода в статье нет совсем — только подходы, сравнительные таблицы и промпты в трёх вариантах: «плохо», «хорошо» и «правильно».
Вводные: задача и участники
Задача для всех одинаковая: создать Telegram-бота для службы поддержки первой линии (L1). Бот принимает обращения пользователей, отвечает на типовые вопросы по базе знаний, ведёт статус заявки и передаёт сложные случаи живому оператору второй линии (L2). Инструмент тоже одинаковый — автономный ИИ-агент уровня Claude Code.
Участников трое:
| Участник | Кто это |
|---|---|
| Vibe-кодер | Не владеет архитектурой и глубоким знанием языка. Ориентируется на видимый результат: «запустилось и отвечает — значит, готово». |
| Junior-разработчик | Знает синтаксис и базовые фреймворки, умеет читать чужой код, но пока плохо предсказывает, где система сломается под нагрузкой или при сбое. |
| Senior-разработчик | Мыслит системой: контрактами, отказами, стоимостью поддержки. Использует агента как ускоритель, но дизайн решения держит в своих руках. |
Чтобы сравнение было честным, договоримся, что считать результатом. Без этого вопрос «кто быстрее» сравнивает разные вещи: один финиширует на демо, другой — в эксплуатации. Критерий готовности (Definition of Done) для всех троих такой:
- бот отвечает по базе знаний и не выдумывает того, чего там нет;
- статусы заявок хранятся и переживают перезапуск бота;
- сложные случаи и прямые просьбы «позовите человека» уходят оператору;
- сбой LLM или Telegram API не приводит к потере обращения;
- ключи и персональные данные клиентов не утекают в код, логи и внешние сервисы;
- бот работает на сервере, а не только на ноутбуке автора.

Схема 1. Устройство бота поддержки L1 и жизненный цикл заявки
Как каждый начинает работу
Разница появляется задолго до первого сгенерированного файла — в тот момент, когда человек представляет себе, как устроен бот.
| Уровень | Первый шаг | Что держит в голове | Что упускает |
|---|---|---|---|
| Vibe | Один большой запрос «сделай бота поддержки» | Внешний вид диалога в Telegram | Хранение данных, сбои, безопасность — всё, чего не видно в чате |
| Junior | Просит агента выбрать фреймворк и разложить проект по папкам | Структуру проекта и основной сценарий | Границы ответственности модулей и сценарии, когда что-то идёт не так |
| Senior | Сам описывает состояния заявки, модель данных и контракты интеграций, затем подключает агента | Отказы, нагрузку, стоимость поддержки | Риск спроектировать «на вырост» больше, чем нужно на старте |

Схема 2. Цикл работы с агентом: проб и ошибок у вайб-кодера, спецификации — у старшего разработчика. Младший разработчик обычно находится между ними
Какие ошибки допустит каждый
Ошибки удобнее сравнивать не по людям, а по областям: в каждой области у каждого уровня своя типичная ошибка.
| Область | Vibe | Junior | Senior |
|---|---|---|---|
| Архитектура | Один файл, в котором всё: и Telegram, и логика, и запросы к LLM | Бизнес-логика перемешана с транспортным слоем Telegram | Избыточное усложнение (overengineering): брокеры сообщений и микросервисы там, где хватило бы модульного монолита |
| Состояние и хранение | Диалоги в оперативной памяти — после перезапуска контекст теряется | База данных есть, но нет защиты от гонок состояний при параллельных сообщениях | Продуманная модель данных, но миграции и схема «на будущее» замедляют старт |
| Отказы внешних сервисов | Падение LLM или Telegram API роняет бота целиком | Ошибки ловятся, но нет повторов, таймаутов и запасного сценария | Предусмотрены, но иногда сложнее, чем того требует нагрузка |
| Повторная доставка | Не знает, что Telegram может прислать одно сообщение дважды | Нет идемпотентности (idempotency) — пользователь получает два ответа | Обычно учтено |
| Привязка к провайдеру | Ключ и модель зашиты прямо в код | Жёсткая привязка к одному провайдеру LLM без запасного варианта | Провайдер скрыт за интерфейсом |
| Поведение модели | Никаких ограничений: бот обещает скидку в 99%, если его попросить | Системный промпт «не отвечай не по теме», который обходится перефразированием | Риск довериться одному уровню защиты |
Чем каждому поможет агент
Возможности у агента одни и те же, а закрывают они совершенно разные потребности.
| Уровень | Роль агента | Главная польза |
|---|---|---|
| Vibe | Единственные «руки» и переводчик с человеческого языка на работающий прототип | Снимает барьер незнания окружения, библиотек и запуска |
| Junior | Терпеливый наставник и генератор шаблонов | Объясняет незнакомые библиотеки, подсказывает паттерны, находит ошибки |
| Senior | Исполнитель по спецификации | Снимает механическую работу: типовой код, миграции, адаптеры, тесты |
Какие задачи можно поручать агенту
Важно не только то, что агент умеет, но и то, что можно отдать ему без потери контроля.
| Уровень | Можно поручать | Нельзя без проверки |
|---|---|---|
| Vibe | Демо-стенд для проверки идеи, тексты ответов-заглушек, локальный запуск | Всё, что пойдёт к реальным клиентам: хранение данных, ключи, развёртывание на сервере |
| Junior | Работу с базой заявок, клавиатуры и меню Telegram, модульные тесты, рефакторинг отдельных функций | Выбор архитектуры, обработку конкурентных запросов, защиту от промпт-инъекций (prompt injection) |
| Senior | Реализацию изолированных модулей по готовому интерфейсу, тесты пограничных случаев, документацию, конфигурацию CI/CD | Изменения контрактов и схемы данных, решения о безопасности — их он оставляет за собой |

Схема 3. Распределение работы между человеком и агентом на разных уровнях подготовки
Файл контекста проекта (CLAUDE.md)
Агент не помнит прошлых сессий. Всё, что он должен знать о проекте при каждом запуске, лежит в файле контекста — для Claude Code это CLAUDE.md в корне репозитория. То, как разработчик обращается с этим файлом, хорошо показывает его уровень.
| Уровень | Есть ли файл | Что в нём | Последствия |
|---|---|---|---|
| Vibe | Нет | — | Каждую сессию агент заново «знакомится» с проектом и может принять решения, противоречащие вчерашним |
| Junior | Создан агентом командой /init и больше не редактируется |
Описание структуры папок и команд запуска | Агент знает, где что лежит, но не знает, как здесь принято писать и чего делать нельзя |
| Senior | Ведётся вручную и обновляется по ходу проекта | Архитектурные границы, запреты, команды сборки и тестов, критерии готовности | Агент с первой минуты работает по правилам проекта |
Как может выглядеть содержимое файла на разных уровнях:
✗ Плохо:
Это телеграм-бот поддержки. Пиши хороший чистый код.
✓ Хорошо:
Telegram-бот поддержки L1.
Структура: bot/ — обработчики Telegram, services/ — логика, db/ — работа с базой.
Запуск: см. README. Тесты: команда запуска тестов из README.
★ Правильно:
Telegram-бот поддержки L1. Три слоя: транспорт (Telegram), бизнес-логика, хранение.
Правила:
- Транспортный слой не обращается к базе данных напрямую — только через сервисы.
- Обращения к LLM — только через интерфейс провайдера; конкретный провайдер не упоминается в бизнес-логике.
- Персональные данные (телефон, email) маскируются до отправки во внешние сервисы и в логи.
- Каждое входящее сообщение обрабатывается идемпотентно по идентификатору обновления Telegram.
Запрещено:
- менять схему базы данных без миграции;
- добавлять зависимости без согласования;
- изменять существующие тесты, чтобы они «проходили».
Готово = все тесты проходят + сценарии из docs/acceptance.md выполнены вручную.
Промпты: плохо → хорошо → правильно
Ниже — четыре типичные ситуации из жизни этого бота. Для каждой три варианта постановки задачи агенту. Нетрудно заметить, кому из наших участников принадлежит каждый вариант.
Постановка задачи целиком
✗ Плохо:
Сделай телеграм-бота для техподдержки на первой линии. Он должен общаться
с клиентами через нейросеть, отвечать на вопросы, быть вежливым, а если не
знает ответ — звать оператора. Сделай красиво и чтобы работало без ошибок.
Агент сам додумает архитектуру: скорее всего, выберет хранение в памяти, оставит ключи в коде и сложит всё в один файл.
✓ Хорошо:
Создай Telegram-бота поддержки L1. Используй асинхронный фреймворк, храни
историю диалогов в PostgreSQL. Бот ищет ответы в приложенном файле FAQ.
Добавь команду вызова оператора: она меняет статус заявки в базе и отправляет
уведомление в отдельный чат поддержки. Вынеси все ключи в конфигурацию.
Появились структура, база данных и сценарий эскалации. Не учтены параллельные сообщения, галлюцинации модели, защита от спама и поведение при падении внешних сервисов.
★ Правильно:
Спроектируй и реализуй Telegram-бота поддержки L1 с разделением на
транспортный слой, бизнес-логику и слой хранения.
1. Жизненный цикл заявки: NEW -> BOT_IN_PROGRESS -> ESCALATED_L2 -> CLOSED.
Все переходы сохраняются в БД с отметкой времени.
2. Ответы — строго по переданным фрагментам базы знаний. Если релевантность
ниже порога или пользователь просит человека — перевод в ESCALATED_L2
без генерации ответа моделью.
3. Безопасность: маскировать телефоны и email до отправки текста в LLM;
не более 10 сообщений в минуту от одного пользователя; пользовательский
ввод отделён от системных инструкций.
4. Отказоустойчивость: при таймауте LLM более 8 секунд или ошибке 5xx —
перевод обращения в очередь L2 с уведомлением пользователя.
5. Повторная доставка одного и того же обновления Telegram не должна
приводить к повторному ответу.
6. До написания кода предложи структуру модулей и схему таблиц
на согласование. Код не пиши, пока я не подтвержу.
Агент получает архитектурные рамки, машину состояний, правила поведения при сбоях и обязательную остановку перед генерацией файлов.
Исправление ошибки
Ситуация: пользователи жалуются, что иногда бот отвечает на одно сообщение дважды.
✗ Плохо:
Бот иногда отвечает два раза. Исправь.
Агент начнёт «лечить» симптом: например, добавит проверку «не отправлять одинаковый текст подряд». Причина останется.
✓ Хорошо:
Бот иногда отвечает на одно сообщение дважды. Обычно это происходит, когда
ответ модели долгий. Вот фрагмент логов за последний час: <логи>.
Найди причину и исправь.
Есть симптом, условия и данные. Но агент сразу перейдёт к правкам, и вы увидите уже готовое исправление, а не его обоснование.
★ Правильно:
Бот иногда отвечает на одно сообщение дважды, чаще при долгом ответе модели.
Логи: <логи>.
Моя гипотеза: Telegram повторно доставляет обновление, если обработчик
не успевает ответить, а мы не проверяем идентификатор обновления.
1. Не меняя код, подтверди или опровергни гипотезу по логам и коду.
2. Напиши тест, который воспроизводит двойной ответ.
3. Предложи исправление и опиши, какие ещё обработчики подвержены той же проблеме.
Исправление применяй только после моего подтверждения.
Сначала причина, потом тест, который её доказывает, и только потом исправление — причём не в одном месте, а везде, где проблема может повториться.
Ревью результата
Ситуация: агент закончил большой кусок работы, и его нужно проверить.
✗ Плохо:
Проверь, всё ли хорошо в коде.
Агент почти наверняка ответит, что всё хорошо, и предложит пару косметических улучшений.
✓ Хорошо:
Проверь код на ошибки, проблемы безопасности и производительности.
Уже лучше, но «проблемы безопасности» — слишком широкая формулировка: агент проверит то, что сочтёт важным сам.
★ Правильно:
Проведи ревью изменений по чек-листу. Ничего не исправляй — только отчёт.
1. Для каждого требования из спецификации укажи, где оно реализовано
и каким тестом покрыто. Требования без теста — отдельным списком.
2. Есть ли места, где телефон или email клиента попадает в логи
или уходит в LLM без маскирования?
3. Что произойдёт при таймауте LLM, ошибке 5xx и недоступности базы данных?
4. Есть ли секреты в коде, конфигурации в репозитории или в тестах?
5. Есть ли изменения, которые не относятся к задаче?
Формат: таблица «пункт — статус — файл и строка — комментарий».
Ревью превращается из «посмотри» в проверку конкретных утверждений, которую можно повторять после каждого изменения.
Новая функция в работающем проекте
Ситуация: бот уже работает, и его нужно подключить к CRM компании.
✗ Плохо:
Подключи бота к нашей CRM.
Агент встроит вызовы CRM прямо в обработчики сообщений — и бот будет падать вместе с CRM.
✓ Хорошо:
Подключи CRM через её REST API: при создании новой заявки создавай карточку
клиента в CRM. Адрес и ключ API — в конфигурации.
Сценарий понятен, но не сказано, что делать, если CRM недоступна, и где должна жить интеграция.
★ Правильно:
Нужна интеграция с CRM: при создании заявки — карточка клиента в CRM.
Ограничения:
1. Интеграция — отдельный адаптер за интерфейсом; бизнес-логика
не знает о конкретной CRM.
2. Недоступность CRM не должна мешать созданию заявки: заявка создаётся,
синхронизация уходит в очередь с повторными попытками.
3. Повторная синхронизация не должна создавать дубликаты карточек.
4. Существующие тесты не меняй. Новые — на успешный сценарий,
недоступность CRM и повторную отправку.
Сначала покажи план изменений: какие файлы затронешь и почему.
Новая функция добавляется рядом с существующей системой, а не внутрь неё, и с заранее оговорённым поведением при сбоях.
Как проверить, что агент сделал то, что просили
Агент уверенно сообщает «готово» даже тогда, когда сделал половину. Поэтому способ проверки — отдельный навык, и у каждого уровня он свой.
| Уровень | Как проверяет | Что остаётся непроверенным |
|---|---|---|
| Vibe | Пишет боту «привет» и пару типовых вопросов. Ответил — значит, работает | Всё, что за пределами счастливого пути (happy path): сбои, параллельные пользователи, некорректный ввод, перезапуск |
| Junior | Просит агента написать тесты и запускает их. Бегло просматривает изменения | Тесты проверяют то, что агент написал, а не то, что требовалось. Агент, по сути, проверяет сам себя |
| Senior | Пишет приёмочные сценарии из требований до кода, читает изменения (diff), отдельно проверяет отказы и попытки промпт-инъекций | Риск потратить на проверку больше времени, чем того стоит текущий этап проекта |
Чему нужно научиться
Навык работы с агентом сводится к двум вещам: точно формулировать ограничения и проверять результат. Но точка роста у каждого своя.
- Vibe-кодеру — декомпозиции: разбивать одну большую задачу на последовательные шаги, читать сообщения об ошибках, а не пересылать их агенту, и понимать разницу между запуском на своём компьютере и работой на сервере. Отдельно — базовой гигиене: ключи не хранятся в коде, логи не содержат персональных данных.
- Junior-разработчику — думать о пограничных случаях (edge cases): ставить агенту задачу не только на счастливый путь, но и на обрыв сети, некорректный ввод, таймауты и повторную доставку. И научиться писать требования к тестам самому, а не принимать тесты агента на веру.
- Senior-разработчику — контекст-инжинирингу (context engineering): упаковывать правила проекта в короткие инструкции для агента и вести файл контекста. А ещё — строгому ревью сгенерированных изменений на скрытые деградации и умению вовремя остановиться в проектировании.
Кто справится быстрее
Ответ зависит от того, где финиш. Если финиш — первый ответ бота в Telegram, то побеждает один участник. Если финиш — критерий готовности из раздела «Вводные: задача и участники», то совсем другой.
| Уровень | До первого ответа бота | До выполнения критерия готовности | Куда уходит время |
|---|---|---|---|
| Vibe | Минуты | Без переделки практически не достигается | На бесконечный цикл «ошибка — в чат — новая ошибка» |
| Junior | Часы | Дни, плюс доработки после первых реальных пользователей | На исправление того, что не было оговорено заранее |
| Senior | Дни | Дни — почти сразу после первого запуска | На проектирование, согласование и проверку до написания кода |

Схема 4. Время до демо и до выполнения критерия готовности — порядок величины, а не точные замеры
Насколько масштабируемым получится результат
Разница между подходами проявляется, когда бот из демонстрации превращается в рабочий инструмент.
| Уровень | Рост числа пользователей | Новая интеграция (CRM, вторая линия) | Через полгода развития |
|---|---|---|---|
| Vibe | Первые проблемы — уже при нескольких одновременных диалогах | Затрагивает весь код сразу, правка одного сценария ломает соседние | Проще переписать с нуля, чем добавить функцию |
| Junior | Выдерживает реальную нагрузку небольшой службы поддержки; с ростом появляются блокировки и гонки состояний | Возможна, но требует правок в бизнес-логике | Нужен плановый рефакторинг узких мест, но код остаётся читаемым |
| Senior | Ограничения известны заранее и решаются масштабированием отдельных частей | Добавляется отдельным модулем без переписывания ядра | Новые сценарии добавляются изолированно и сразу покрываются тестами |
Сколько стоит эксплуатация
Цена бота — это не только время разработки. Каждый ответ стоит токенов, каждая переделка — времени, каждый инцидент — репутации.
| Статья расходов | Vibe | Junior | Senior |
|---|---|---|---|
| Токены на разработку | Много: десятки итераций «исправь ошибку» | Средне: структура задана, но много доработок | Больше всего вложено в начале (спецификация, согласование), дальше — меньше итераций |
| Токены в эксплуатации | В каждый запрос уходит вся история диалога | Вся история диалога, без ограничений длины | Только нужные фрагменты базы знаний и короткий контекст, плюс лимиты на пользователя |
| Защита от злоупотреблений | Нет: любой может «накрутить» счёт за LLM | Частичная | Лимиты частоты запросов и эскалация вместо генерации там, где модель не нужна |
| Переделки | Постоянные, вплоть до переписывания | Плановый рефакторинг | Точечные изменения |
| Поддержка | Разобраться в коде может только агент, и то не всегда | Может другой разработчик | Может другой разработчик, есть документация и тесты |
Кто отвечает за инцидент
Ситуация: бот пообещал клиенту возврат денег, которого нет в регламенте компании. Клиент пришёл с претензией.
Агент ответственности не несёт: отвечает тот, кто принял его изменения и выпустил их к клиентам. Различается то, насколько быстро этот человек сможет разобраться в произошедшем.
| Уровень | Как узнаёт об инциденте | Как ищет причину | Что меняется после |
|---|---|---|---|
| Vibe | От руководителя, по жалобе клиента | Спрашивает агента «почему бот так ответил?» — агент строит догадки, логов диалога нет | В промпт добавляется «не обещай возвраты». До следующего похожего случая |
| Junior | Из жалобы, затем находит диалог в базе | Видит ответ, но не видит, на основе каких данных модель его построила | Уточняется системный промпт, но проверки, что проблема не повторится, нет |
| Senior | Из мониторинга или по жалобе, находит обращение по номеру заявки | По журналу видит фрагменты базы знаний, переданные модели, и уровень уверенности ответа | Исправление, новый сценарий в наборе проверочных диалогов и разбор инцидента для команды |
Вместо заключения
Агент во всех трёх историях один и тот же. Попробуйте найти в таблицах свою строку — и подумайте, какой из промптов вы напишете в следующий раз.