ИИ-инжиниринг для разработчиков: Senior, Junior, Vibe

Опубликовано 22.11.2026 07:51:00 в категории Искусственный интеллект

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

Вводные: задача и участники

Задача для всех одинаковая: создать 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 Из мониторинга или по жалобе, находит обращение по номеру заявки По журналу видит фрагменты базы знаний, переданные модели, и уровень уверенности ответа Исправление, новый сценарий в наборе проверочных диалогов и разбор инцидента для команды

Вместо заключения

Агент во всех трёх историях один и тот же. Попробуйте найти в таблицах свою строку — и подумайте, какой из промптов вы напишете в следующий раз.

Комментарии к статье ()

Загрузка...

Что-то пошло не по сценарию и завершилось ошибкой. Перезагрузить страницу (F5) 🗙

Переподключаем сервер...

Переподключение сломалось... Пробуем еще раз сек.

Не получилось переподключится.
Пожалуйста, обновите страницу F5

Сессия была поставлена сервером на паузу.

Восстановить сессию не получилось.
Пожалуйста, обновите страницу F5.