Как выстроить сквозной SDLC для ИИ-агентов:от идеи и спек до слияния пул-реквеста
Spec-Driven DevelopmentHandoffQuality Gates
26 октября, 19:00 · 1,5 часа · в прямом эфире
Алексей Могильников
Команда и продукт
Интернет-магазин
Процесс разработки
Люди решают свои задачи и передают артефакты
Вопрос к аудитории
Что изменилось за последний год?
Появились агенты
Агенты ускоряют работу отдельных специалистов
Процесс не изменился
Новая задача
Добавить отписку от рекламы
Вопрос к аудитории
Что часто идёт не так?
Что дальше?
Задача идёт по процессу
Проблема
Приёмочное тестирование показало
Причина
Общая очередь отложенных задач
А как же тесты?
Агент и тесты переписал 😄
А как же ревью?
Агенты генерируют больше кода, команда не успевает валидировать
В чём причины
Две типичные проблемы
Следствие
Ускорение?
Вопрос
Что должно быть у агента в контексте, чтобы он мог реализовывать и проверять изменение с учётом ожидаемого поведения системы?
Что делать?
Вводим SDD: разработку по спецификациям
Зачем?
Агент знает, что изменить и что сохранить
Где хранится спека
Спека хранится рядом с кодом
Что внутри?
У каждого файла своя задача
Спеки накапливаются
Описываем систему постепенно
Спеки используют все
Как каждая роль использует спеки
Спека проходит по процессу
Спека пополняется по ходу задачи
proposal.md
Зачем и что меняем
spec.md
Какое поведение требуется
design.md
Как устроим решение
tasks.md
Какие шаги нужно выполнить
Сложна!
Не так сложно
Формат и порядок работы знает скилл
Фреймворки для SDD
Три подхода к работе со спеками
Что важно запомнить
Спеки помогают сохранять поведение
Что важно запомнить
Контекст передаётся и накапливается по мере движения задачи по потоку
Журнал решений
Выбор разработчика
Выбрали способ реализации и отправили на ревью
Решение осталось в чате
Ревьюер предлагает другой способ. Вы объясняете выбор заново
Decision log
Записываем решение и почему его приняли
Журнал решений в потоке
Контекст передаётся и накапливается по мере движения задачи по потоку
Ревью большого PR
Ревьюить не хочется. Но надо
Решения агента
Большинство решений принимает агент
АгентСравнивает вариантыПринимает решениеЗаписывает выбор,альтернативы и причиныDecision log · журнал решенийВОПРОСКак проверять ссылку на отписку?РЕШЕНИЕТокен с HMAC-подписьюАЛЬТЕРНАТИВАСлучайный токен, хранимый в БДАРГУМЕНТЫВЫБОРАНе нужна отдельная таблица токенов.Подпись защищает от подмены данных.Нужно управлять ротацией ключей.КТО И КОГДААгент · дата и время принятияФиксируем решения с существенными последствиямиПоведение · архитектура · данные · безопасность · производительность · проверки
Ревью журнала решений
Достаточно ревью журнала решений
УСЛОВИЕ: ПОДРОБНЫЕ СПЕКИ И ДОСТАТОЧНОЕ ПОКРЫТИЕ ПРОВЕРКАМИАвтоматика проверяет реализациюЧеловек ревьюит решенияДесятки тысячстрок кодаТесты по требованиямПроверка типов и линтерыАнализаторы кодаБольшая часть проверок — автоматическиЖурнал ключевых решенийЧто выбрано и почемуАльтернативы и компромиссыРиски и их проверкиУчитываем требования, ограниченияи знания команды, которыеещё не записаны в документацииВместо всего кода — короткий журнал решенийНе ревьюим код
Опыт Роберта Мартина
Не читать код — звучит безумно?
Большую часть времени95% кода я вообще не вижуРоберт Мартин · Uncle BobАвтор Clean Code и Clean ArchitectureЧтения меньше. Проверки остаются.Тесты поведения · мутационные тесты · метрики качестваАрхитектура и работа системы — под контролем человека[1] Robert C. Martin · интервью Aviator · 24 сентября 2026 ↗
Решения на всех этапах
Решения принимает не только разработчик
Аналитик+ агентГраницы и требования«Заказ оформлен.Вот ещё товары для вас…»Делим смешанные письмана сервисные и рекламныеРеклама — только по подпискеРазработчик+ агентТехническое решениеКак остановить рекламу?Проверяем подпискуперед отправкой письмаОбщую очередь не меняемТестировщик+ агентСтратегия проверкиКак проверить интеграцию?Проверяем на стендес реальной очередьюБез подмены очередиФиксируем выбор, альтернативы и причины сразуЖурнал решений начинается с аналитики
Журнал решений по всему потоку
Журнал решений пополняется с самого начала
ИдеяАналитик+ агентНамерениеТребованияЖурнал решенийРазработчик+ агентНамерениеТребованияДизайн и задачиКодЖурнал решенийРевьюерЧеловек или агент в PRНамерениеТребованияДизайн и задачиКодЖурнал решенийРезультат ревьюТестировщик+ агентНамерениеТребованияДизайн и задачиКодЖурнал решенийРезультат ревьюТесты и результатыАналитик → разработчик → тестировщик дополняют журнал
Quality Gates
Цена возвратов
Возвраты затягивают поставку
Один PR может пройти десятки круговРазработкаИсправляетРевьюНаходит замечанияТестированиеНаходит дефектыНа доработкуСнова на доработкуДЕФЕКТ В СПЕКАХ НАШЛИ В АНАЛИТИКЕИсправляем спекуТОТ ЖЕ ДЕФЕКТ НАШЛИ НА ТЕСТИРОВАНИИПеределываем спеку, код и тестыПовторяем ревью и проверкиРаньше нашли — меньше переделок и быстрее поставка
Quality Gates в потоке
Проверяем готовность перед передачей
Аналитик+ агентНамерениеТребованияЖурнал решений1Разработчик+ агентНамерениеТребованияДизайн и задачиКодЖурнал решений2РевьюерЧеловек или агент в PRНамерениеТребованияДизайн и задачиКодЖурнал решенийРезультат ревью3Тестировщик+ агентНамерениеТребованияДизайн и задачиКодЖурнал решенийРезультат ревьюТесты и результаты4ГотовоНадоработку1 · Спеки готовыТребования проверяемыГраницы и риски определеныКритерии приёмки заданыВопросы и противоречия снятыФорматы соблюденыСпеки и журнал согласованы2 · Реализация готоваКод и тесты отвечают спекамТесты, типы и линтеры прошлиБезопасность проверенаПокрытие рисков достаточноФорматы соблюденыКод и журнал согласованыАрхитектура без нарушений3 · Ревью пройденоРешения и тесты провереныЗамечания закрытыРевью текущего коммитапройденоКонтекст для проверки готовСреда и данные готовыРиски переданы тестировщику4 · Результат готов?Приёмка и регрессии пройденыНФТ проверены по рискамТесты текущего коммитапройденыБлокирующих дефектов нетОстаточные риски принятыЖурнал и отчёт актуальны
Как это выглядит на практике?
Поток в Git и pull request
Одна ветка, общий контекст, четыре этапа
Одна ветка feature/unsubscribe · один pull requestАналитикГотовит требованияи создаёт PRproposal.mdspec.mddecisions.mdРазработчикПодхватывает тот же PRи реализует изменениеВсе предыдущиеартефакты веткиdesign.mdtasks.mdsrc/ + tests/decisions.mdРевьюерАгент в pull requestпроверяет изменениеВсе предыдущиеартефакты веткиreview.mdТестировщикБерёт ветку, запускает агентаи готовит тест-планВсе предыдущиеартефакты веткиtest-plan.mdtests/test-report.mddecisions.md1234Создаёт ветку и PRдо первого гейтаДобавляет код и документыНазначает ревьюераВозвращает на доработкуили добавляет review.mdВыбирает сценарии и критерииПроводит тестыСохраняет результатыФинальный гейтGitHub ActionsChecks в PRВливаем PRНадоработкуОдин PR проходит аналитику, разработку, ревью и тестированиеQuality Gates 1–4: GitHub Actions запускает проверки, результаты видны в Checks PRstage:analysisstage:developmentstage:reviewstage:testing
Общий итог
От отдельных агентов к сквозному процессу
СпекиЧто должноработатьОжидаемое поведениеи границы измененияЖурнал решенийЧто выбралии почемуАльтернативы, аргументыи существенные рискиQuality GatesМожно липередать дальшеКритерии готовностии подтверждения проверокHarnessОрганизованный сквозной процесс работы агентовОбщий контекст · понятные передачи · проверяемая готовностьЧеловек задаёт правила, контролирует риски и границы полномочий
Материалы к вебинару
Справочник по агентному SDLC
Процесс, роли, документы, передача работы и проверки
Когда пригодитсяРазобрать сбой в процессеНастроить роли и документыПередать задачу другой ролиПроверить результат агентаВыбрать скиллы и инструментыРабочие таблицы и готовые шаблоныЧто внутри01Настроить и запустить работу02Контекст и передача работы03Выбрать документ04Проверить готовность05Шаблоны06Полезные ссылкиПередайте документ своему агенту и обсуждайте с ним свои вопросы