Вайбкодинг · Прикладной гайд
Цикл разработки с агентами: шесть шагов, контракт и операционный слой
Продукт собирают агенты, порядок работы держите вы. Цикл из шести шагов ведёт от намерения до публикации. Задача-контракт задаёт критерии приёмки, а операционный слой хранит задачи, решения и результаты в удобном вам инструменте.
Словарь цикла разработки
Пока задачи живут в чате
Задачи приходят из чатов, звонков и заметок на полях. Через неделю никто уже не помнит, что именно было обещано: формулировка "сделай красиво" ушла агенту, агент отчитался, а проверять результат нечем. Критериев не было, спорить о результате можно бесконечно.
Второй риск тише, но дороже: вы сами превращаетесь в парсера собственных поручений. Каждая задача проходит через вас: услышали, пересказали агенту, проверили, переложили в трекер руками. Агенты при этом простаивают.
Цикл из шести шагов задаёт порядок работы. Задача-контракт описывает ожидаемый результат и приёмку. Операционный слой хранит задачи и решения, а агенты помогают поддерживать эти записи.
Шесть шагов от намерения до публикации
Разработка продукта собирается в замкнутый круг. Намерение фиксируется текстом, из текста рождается план, план превращается в код, код проходит проверки, результат смотрит человек, версия публикуется. Дальше круг начинается заново: деплой открывает следующую версию.
Задача как контракт с приёмкой
Операционную часть цикла держат задачи. У каждой задачи есть письменная постановка: контракт между вами, проектом и агентом.
В контракте шесть пунктов. Сначала укажите, кем агент работает и зачем, затем что ему дано и что запрещено, в конце опишите вид результата и критерии приёмки.
Приёмка в карточке задачи
Закрытая карточка и есть приёмка: результат совпал с сигналом, карточка закрывается без обсуждений.
Задача без критериев приёмки
Ведение задач силами агентов
Операционный слой включает место хранения задач и правила работы с ними. Он может жить в трекере, таблице, общем документе или папке Markdown-файлов. GitHub Issues подходит как один из вариантов.
Для каждой задачи нужны цель, критерии приёмки, текущий статус и история решений. Агент должен уметь найти задачу, прочитать контекст и сохранить результат в пределах выданных прав.
Агенты читают входящие запросы, оформляют задачи и обновляют статусы. Вы уточняете приоритеты, проверяете результат и подтверждаете закрытие задачи.
Если задачи уже ведут в документе
Можно начать в том документе или таблице, где команда уже ведёт задачи. Выделите каждой задаче отдельный блок или строку: описание, статус, критерии приёмки и ссылка на результат.
Договоритесь, какие поля заполняет агент и когда вы проверяете его записи. Для продолжения работы после перерыва должно быть понятно, что уже сделано, какие решения приняты и какой шаг следующий.
Ритм дня
- Утро. Спрашиваете у агента "что у меня сегодня?"; он собирает картину дня из открытых карточек.
- День. Агент-менеджер режет задачи на части и раздаёт исполнителям, каждый работает в своей копии.
- Вечер. Смотрите результаты и закрываете карточки по сигналам приёмки.
Пример: напоминания о встречах в боте
Задача состояла в том, чтобы добавить напоминания о личных встречах в бота уведомлений. Агент прочитал описание, вынес открытые вопросы отдельным блоком и составил план: что сделать и какие файлы изменить.
Затем агент подготовил изменения в отдельной ветке и создал запрос на слияние. Автоматические тесты обнаружили ошибку. Слияние отложили до её исправления.
После команды "Разберись и почини" агент внёс исправления в своей ветке. Повторная проверка остановилась из-за лимита платформы, поэтому подтверждения успешного запуска в этом разборе нет.
При остановке тестов проверка остаётся незавершённой. Агент сообщает причину остановки; к приёмке возвращаются после успешного запуска.
Пример показывает, где остановить цикл: изменения уже подготовлены, а тесты ещё нужно проверить. Решение о слиянии и публикации остаётся за владельцем продукта.
Промпты для старта
Постановка задачи по шести пунктам
Возьми мою просьбу и преврати в задачу-контракт по шести пунктам:
Роль: кем ты работаешь.
Цель: итог одной строкой.
Входы: файлы, ссылки, доступы.
Ограничения: что нельзя трогать.
Форма: вид результата.
Критерии успеха: по чему принимаем работу.
Покажи задачу на подтверждение до начала работы.
Отправьте этот промпт вместе с описанием задачи. Он помогает договориться с агентом о результате и проверке до начала работы.
Режим оркестратора
Ты оркестратор: планируй работу, ставь задачи и проверяй результат.
Код и запуск проверок делегируй субагентам на [МОДЕЛЬ_ИСПОЛНИТЕЛЯ].
Запускай максимум четыре субагента одновременно.
Проси у каждого краткий итог, результаты проверок и открытые вопросы.
Вместо [МОДЕЛЬ_ИСПОЛНИТЕЛЯ] укажите любую достаточно умную для вашей задачи модель, доступную в среде с субагентами. Четыре исполнителя здесь ограничивают параллельную работу; число можно уменьшить под свой лимит.
Этот режим нужен для экономии токенов Fable. Если отдавать ей весь код и все проверки, лимита подписки Claude может не хватить. Поэтому Fable планирует и принимает результат, а объёмную работу выполняют другие модели.
Разработка по шагам
Вот задача: [ВСТАВИТЬ_ЗАДАЧУ].
Пройди цикл: спека в одном абзаце, план по шагам,
работа в отдельной ветке, автоматические проверки,
отчёт с разницей "было и стало" и открытыми вопросами.
Вливать не проси: слияние принимаю я по критериям успеха.
Подставьте свою задачу. Шаблон связывает постановку, отдельную ветку, проверки и ваше решение о слиянии.
Типичные ошибки
Чат вместо трекера задач
Когда решения остаются в переписке, агенту приходится собирать контекст заново. Сохраняйте итог обсуждения рядом с задачей в выбранной системе: что решили, что уже сделано и какой результат ожидается.
Ручное ведение задач без агентов
Почему ломает: система работает, пока карточки заводятся; вручную это съедает вечер, и однажды вечер не находится. Было: "заведу сам, когда до рук дойдёт". Стало: агент читает источники по расписанию и заводит карточки, вы проверяете раз в день и закрываете.
Дорогая модель на всех этапах
Если Fable выполняет весь цикл, её лимит уходит и на планирование, и на объёмный код, и на повторные проверки. В подписке Claude его может не хватить на остальные задачи.
Оставьте Fable постановку задач и приёмку. Исполнение передайте другой модели, которая справляется с работой. Назначайте модели по сложности задачи и доступному лимиту.
Готово, когда
- У каждой задачи, отданной агенту, есть критерии успеха, названные до старта работы.
- Рабочая версия продукта отделена от работы агента: ветка или копия проекта.
- Задачи и статусы хранятся в выбранной системе; агент обновляет их по согласованным правилам, вы принимаете результат.
- У каждого шага цикла есть подтверждение: текст спеки, план, ветка, пройденный прогон, ваша проверка, опубликованная версия.
- Слияние проходит только после вашей приёмки по критериям из задачи.