Вайбкодинг · Прикладной гайд

Цикл разработки с агентами: шесть шагов, контракт и операционный слой

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

Словарь цикла разработки

Словарь цикла разработки Термины цикла разработки: агент, спека, карточка, задача-контракт, готово когда, операционный слой, оркестратор, деплой. Для каждого термина указаны суть и аналог в процессах. АГЕНТ работает инструментами: файлы, проверки, браузер ≈ новый сотрудник проекта СПЕКА намерение, зафиксированное текстом: что делаем и зачем ≈ заявка клиента КАРТОЧКА запись о задаче: номер, история, комментарии ≈ заказ в трекере ЗАДАЧА-КОНТРАКТ заказ с приёмкой: цель, входы, ограничения, форма, критерии ≈ бриф для подрядчика ГОТОВО, КОГДА признаки принятой работы, названные до начала работы ≈ акт приёмки в договоре ОПЕРАЦИОННЫЙ СЛОЙ где хранятся задачи и как их ведут ≈ диспетчерская ОРКЕСТРАТОР агент-менеджер: делит задачу и раздаёт, код не пишет ≈ руководитель проектов ДЕПЛОЙ публикация версии и фиксация истории ≈ поставка на полки термин · суть · аналог в процессах
Рис. 1. Термины цикла разработки: от намерения до публикации.

Пока задачи живут в чате

Задачи приходят из чатов, звонков и заметок на полях. Через неделю никто уже не помнит, что именно было обещано: формулировка "сделай красиво" ушла агенту, агент отчитался, а проверять результат нечем. Критериев не было, спорить о результате можно бесконечно.

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

Цикл из шести шагов задаёт порядок работы. Задача-контракт описывает ожидаемый результат и приёмку. Операционный слой хранит задачи и решения, а агенты помогают поддерживать эти записи.

Шесть шагов от намерения до публикации

Разработка продукта собирается в замкнутый круг. Намерение фиксируется текстом, из текста рождается план, план превращается в код, код проходит проверки, результат смотрит человек, версия публикуется. Дальше круг начинается заново: деплой открывает следующую версию.

Цикл разработки из шести шагов Замкнутый цикл из шести шагов: спека, план, код, тесты, человек, деплой. Верхний ряд идёт слева направо: спека, план, код. Затем вниз к нижнему ряду, который идёт справа налево: тесты, человек, деплой. От деплоя возвратная стрелка ведёт к спеке с подписью следующая версия. Под каждым шагом подписано, чем он подтверждается. Шаг с человеком выделен как обязательный контроль. 01 Спека что делаем и зачем: сообщение, описание ошибки, запрос пользователя подтверждение: текст спеки 02 План кто, что и в каких файлах; план можно отдать агенту целиком подтверждение: список шагов 03 Код работает агент или человек; изменения живут в отдельной ветке подтверждение: ветка 04 Тесты автоматическая проверка: агент открывает браузер и идёт путём клиента подтверждение: пройденный прогон 05 Человек проверка глазами владельца на тестовой или живой версии подтверждение: ваша проверка 06 Деплой фиксация истории, публикация версии, начало следующего круга подтверждение: опубликованная версия следующая версия переход цикла шаг обязательный контроль человека
Рис. 2. Цикл разработки из шести шагов с подтверждением каждого этапа.

Задача как контракт с приёмкой

Операционную часть цикла держат задачи. У каждой задачи есть письменная постановка: контракт между вами, проектом и агентом.

В контракте шесть пунктов. Сначала укажите, кем агент работает и зачем, затем что ему дано и что запрещено, в конце опишите вид результата и критерии приёмки.

Структура задачи-контракта Сырая просьба слева превращается в задачу-контракт из шести пунктов: роль, цель, входы, ограничения, форма, критерии успеха. Пункт критерии успеха выделен как обязательный: без него задачи нет. Справа результат: задача, готовая к передаче агенту. Просьба "сделай красиво" Задача-контракт РОЛЬ кем работает агент при выполнении ЦЕЛЬ итог одной строкой ВХОДЫ файлы, страницы, ссылки, доступы ОГРАНИЧЕНИЯ что нельзя трогать, какие правила обязательны ФОРМА вид результата: таблица, список, страница КРИТЕРИИ УСПЕХА · без них задачи нет Задача готова к передаче рамка: сырьё и результат · выделено: обязательный пункт приёмки
Рис. 3. Структура задачи-контракта: шесть пунктов постановки и критерии приёмки.

Приёмка в карточке задачи

Карточка задачи в трекере: поля приёмки и результат Карточка задачи Дайджест чата потока: результат файл-дайджест с датой недели, отдел учебное производство, сигнал приёмки дайджест лежит в папке потока, срок четверг 18:00 с приоритетом P2. Внизу плашка: закрыта, приёмка пройдена. Дайджест чата потока РЕЗУЛЬТАТ файл-дайджест с датой недели ОТДЕЛ учебное производство СИГНАЛ ПРИЁМКИ дайджест лежит в папке потока СРОК четверг 18:00, приоритет P2 ЗАКРЫТА = ПРИЁМКА ПРОЙДЕНА рамка: запись о задаче · моно: поля приёмки
Рис. 4. Карточка задачи в трекере: поля приёмки и результат.

Закрытая карточка и есть приёмка: результат совпал с сигналом, карточка закрывается без обсуждений.

Задача без критериев приёмки

Сравнение: размытая просьба против контракта с критериями приёмки Сравнение двух подходов к постановке задач: размытая формулировка "сделай красиво" и контракт с критериями приёмки "готово, когда...". Каждый критерий можно проверить и зафиксировать результат. БЫЛО · РАЗМЫТАЯ ПРОСЬБА "Сделай красиво" "поправь главную страницу, сделай красиво" У проверки нет опоры: приёмка превращается в бесконечный спор о вкусе, работа виснет. ЗАКРЫТЬ НЕЛЬЗЯ · НЕТ СИГНАЛА СТАЛО · БИНАРНАЯ ПРИЁМКА "Готово, когда..." • заголовок читается с телефона • кнопка записи видна без прокрутки • в консоли браузера 0 ошибок Каждый критерий можно проверить и записать результат. ПРИЁМКА ПО ФАКТУ · КАРТОЧКА ЗАКРЫТА красный: размытая просьба без критериев · синий: проверяемый контракт приёмки
Рис. 5. Разница между размытой просьбой и задачей с критериями приёмки.

Ведение задач силами агентов

Операционный слой включает место хранения задач и правила работы с ними. Он может жить в трекере, таблице, общем документе или папке Markdown-файлов. GitHub Issues подходит как один из вариантов.

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

Агенты читают входящие запросы, оформляют задачи и обновляют статусы. Вы уточняете приоритеты, проверяете результат и подтверждаете закрытие задачи.

Если задачи уже ведут в документе

Можно начать в том документе или таблице, где команда уже ведёт задачи. Выделите каждой задаче отдельный блок или строку: описание, статус, критерии приёмки и ссылка на результат.

Договоритесь, какие поля заполняет агент и когда вы проверяете его записи. Для продолжения работы после перерыва должно быть понятно, что уже сделано, какие решения приняты и какой шаг следующий.

Ритм дня

Суточный ритм работы с агентами Схема замкнутого суточного цикла: Утро (сводка дня из открытых задач), День (оркестрация задач по субагентам), Вечер (приёмка владельцем и закрытие задач) с переходом на следующий рабочий день. СУТОЧНЫЙ КОНТУР: ОТ УТРЕННЕГО ПЛАНА ДО ВЕЧЕРНЕЙ ПРИЁМКИ 01 · УТРО Что у меня сегодня? Агент собирает картину дня из списка открытых задач → сводка задач и приоритеты 02 · ДЕНЬ Оркестрация задач Менеджер режет задачи и раздаёт агентам в отдельные ветки → параллельные ветки и PR 03 · ВЕЧЕР Проверка и сдача Владелец смотрит результат по критериям успеха ✓ закрытая карточка = принято следующий рабочий день синий: шаги дня · пунктир: суточный цикл воспроизводства
Рис. 6. Суточный ритм работы с агентами: от утренней сводки до вечерней приёмки.
  1. Утро. Спрашиваете у агента "что у меня сегодня?"; он собирает картину дня из открытых карточек.
  2. День. Агент-менеджер режет задачи на части и раздаёт исполнителям, каждый работает в своей копии.
  3. Вечер. Смотрите результаты и закрываете карточки по сигналам приёмки.

Пример: напоминания о встречах в боте

Задача состояла в том, чтобы добавить напоминания о личных встречах в бота уведомлений. Агент прочитал описание, вынес открытые вопросы отдельным блоком и составил план: что сделать и какие файлы изменить.

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

После команды "Разберись и почини" агент внёс исправления в своей ветке. Повторная проверка остановилась из-за лимита платформы, поэтому подтверждения успешного запуска в этом разборе нет.

При остановке тестов проверка остаётся незавершённой. Агент сообщает причину остановки; к приёмке возвращаются после успешного запуска.

Пример показывает, где остановить цикл: изменения уже подготовлены, а тесты ещё нужно проверить. Решение о слиянии и публикации остаётся за владельцем продукта.

Промпты для старта

Постановка задачи по шести пунктам

Задача-контракт
Возьми мою просьбу и преврати в задачу-контракт по шести пунктам:
Роль: кем ты работаешь.
Цель: итог одной строкой.
Входы: файлы, ссылки, доступы.
Ограничения: что нельзя трогать.
Форма: вид результата.
Критерии успеха: по чему принимаем работу.
Покажи задачу на подтверждение до начала работы.

Отправьте этот промпт вместе с описанием задачи. Он помогает договориться с агентом о результате и проверке до начала работы.

Режим оркестратора

Оркестратор
Ты оркестратор: планируй работу, ставь задачи и проверяй результат.
Код и запуск проверок делегируй субагентам на [МОДЕЛЬ_ИСПОЛНИТЕЛЯ].
Запускай максимум четыре субагента одновременно.
Проси у каждого краткий итог, результаты проверок и открытые вопросы.

Вместо [МОДЕЛЬ_ИСПОЛНИТЕЛЯ] укажите любую достаточно умную для вашей задачи модель, доступную в среде с субагентами. Четыре исполнителя здесь ограничивают параллельную работу; число можно уменьшить под свой лимит.

Этот режим нужен для экономии токенов Fable. Если отдавать ей весь код и все проверки, лимита подписки Claude может не хватить. Поэтому Fable планирует и принимает результат, а объёмную работу выполняют другие модели.

Разработка по шагам

Цикл на одной задаче
Вот задача: [ВСТАВИТЬ_ЗАДАЧУ].
Пройди цикл: спека в одном абзаце, план по шагам,
работа в отдельной ветке, автоматические проверки,
отчёт с разницей "было и стало" и открытыми вопросами.
Вливать не проси: слияние принимаю я по критериям успеха.

Подставьте свою задачу. Шаблон связывает постановку, отдельную ветку, проверки и ваше решение о слиянии.

Типичные ошибки

Типичные ошибки при внедрении агентов в разработку Сравнительная схема трех архитектурных ловушек (чат вместо трекера, ручное ведение задач, дорогая модель на всех этапах) и системных решений: Было → Стало. ТРИ АРХИТЕКТУРНЫЕ ЛОВУШКИ: БЫЛО → СТАЛО ОШИБКА 1 · ТРЕКЕР Чат вместо трекера "обсудили в трёх чатах" контекст размыт, через неделю решение не найти "задача с историей" контекст закреплён, агент читает задачу ОШИБКА 2 · РУТИНА Ручное ведение задач "человек заполняет трекер" рутина съедает вечер, трекер забрасывается "агент заводит по ритму" человек только валидирует и закрывает ОШИБКА 3 · РЕСУРСЫ Дорогая модель везде "Fable на всём цикле" лимит Fable уходит на весь код и проверки "Fable планирует, агенты пишут" токены Fable на решения другие модели на исполнение красный: ловушка ручной работы · синий: системный переход на операционку с агентами
Рис. 7. Три типичные ошибки при внедрении агентов в разработку.

Чат вместо трекера задач

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

Ручное ведение задач без агентов

Почему ломает: система работает, пока карточки заводятся; вручную это съедает вечер, и однажды вечер не находится. Было: "заведу сам, когда до рук дойдёт". Стало: агент читает источники по расписанию и заводит карточки, вы проверяете раз в день и закрываете.

Дорогая модель на всех этапах

Если Fable выполняет весь цикл, её лимит уходит и на планирование, и на объёмный код, и на повторные проверки. В подписке Claude его может не хватить на остальные задачи.

Оставьте Fable постановку задач и приёмку. Исполнение передайте другой модели, которая справляется с работой. Назначайте модели по сложности задачи и доступному лимиту.

Готово, когда

  • У каждой задачи, отданной агенту, есть критерии успеха, названные до старта работы.
  • Рабочая версия продукта отделена от работы агента: ветка или копия проекта.
  • Задачи и статусы хранятся в выбранной системе; агент обновляет их по согласованным правилам, вы принимаете результат.
  • У каждого шага цикла есть подтверждение: текст спеки, план, ветка, пройденный прогон, ваша проверка, опубликованная версия.
  • Слияние проходит только после вашей приёмки по критериям из задачи.