Бесплатный вебинар Хекслета

Как выстроить сквозной SDLC для ИИ-агентов:от идеи и спек до слияния пул-реквеста

Spec-Driven Development Handoff Quality Gates

26 октября, 19:00 · 1,5 часа · в прямом эфире

Алексей Могильников

Цифровые руки передают и дополняют общий пакет контекста

Команда и продукт

Интернет-магазин

Каталог Поиск товаров Корзина Наушники Рюкзак Кроссовки АналитикФормулирует требованияк поведению системыРазработчикРеализует измененияв кодеТестировщикПроверяет поведениесистемы

Процесс разработки

Люди решают свои задачи и передают артефакты

JiraТикетJiraConfluenceТикет + страницаJira + ConfluenceGitLabТикет + страница+ MRАналитикРазработчикТестировщик

Вопрос к аудитории

Что изменилось за последний год?

Появились агенты

Агенты ускоряют работу отдельных специалистов

Процесс не изменился

JiraТикетJiraConfluenceТикет, страницаJira, ConfluenceGitLabТикет, страница, MRАналитикClaudeРазработчикCodexТестировщикGemini

Новая задача

Добавить отписку от рекламы

Jira Проекты Задачи Создать Поиск Магазин ДоскаБэклог Задачи Отчёты Интернет-магазин / SHOP-42 Добавить возможность отписатьсяот рекламной рассылки Прикрепить файл Связать задачу Описание ФТ · Функциональные требования Покупатель может отказаться от рекламных писем. НФТ · Нефункциональные требования К выполнению Сведения ИсполнительРазработчик МеткиРассылки Связанные материалыПродуктовые требования

Вопрос к аудитории

Что часто идёт не так?

Что дальше?

Задача идёт по процессу

Аналитик Разработчик Тестировщик Уточнил требования После отписки рекламане должна приходить. Даже подготовленная заранее. Реализовал отписку Тесты зелёные Ревью пройдено Проверил задачу Отказ сохраняетсяПодтверждение видноРеклама не приходитПовторное нажатие работает Задача принята Изменение включают в релиз

Проблема

Приёмочное тестирование показало

ДЕЙСТВИЯ ПОКУПАТЕЛЯ ЧТО ВИДЯТ ДРУГИЕ ПОКУПАТЕЛИ Последний пылесос 123 Оформил заказ Отписался от рекламы Не оплатил 4 Срок оплаты истёк Бронь не снялась Пылесос На складе есть Нет в наличии Другой покупатель не может его купить

Причина

Общая очередь отложенных задач

Отписка Отменить все задачипользователя ОБЩАЯ ОЧЕРЕДЬ · ОДИН ПОКУПАТЕЛЬ Отправить рекламное письмо Отменено Снять бронь неоплаченного заказа Тоже отменено Отбор по покупателю, без ограничения по типу задания Код заказов и склада не менялся

А как же тесты?

Агент и тесты переписал 😄

1 Написал новый код Тесты упали 2 Несколько раз правил код и тесты и запускал тесты заново Всё ещё падают 3 Тогда переписал тесты под новое поведение кода Тесты зелёные Тесты проходят, но прежнее поведение нарушено

А как же ревью?

Агенты генерируют больше кода, команда не успевает валидировать

На 30% больше кода Процесс ревью на 49% дольше MR · Отписка Очередь на ревью Поверхностная проверка Одобрено Дефект пропущен [1] Chen и Stratton · 718 компаний · 2026 ↗

В чём причины

Две типичные проблемы

ОБЪЁМ ПРОВЕРКИ Команда не успевает Кода больше, ревью поверхностное. Дефекты остаются незамеченными. КОНТЕКСТ АГЕНТА Не знает, что сохранить Меняет существующее поведение и тесты вместе с кодом. Разбор, исправление и повторная проверка задерживают релиз

Следствие

Ускорение?

КОД ПОСТАВКА КАЧЕСТВО +30% строк кода [1] Значимого ростазавершённых задачне выявлено [1] +240% коммитов [2] +30% релизов [2] +75% проблем логикии корректности В AI-PR относительночеловеческих PR [3] [1] Chen и Stratton · 2026 ↗ [2] Demirer, Musolff и Yang · NBER, 2026 ↗ [3] CodeRabbit · 470 PR · 2025 ↗

Вопрос

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

Что делать?

Вводим SDD: разработку по спецификациям

Спека Комплект связанных спецификаций Требования Сценарии и бизнес-правила Ограничения Критерии приёмки Устройство решения Подсистемы и их связи Интерфейсы Данные Проверка Что и как тестируем Соответствие требованиям Сохранность поведения Разделы одного документа или отдельные связанные файлы Общее основание для разработки, ревью и тестирования

Зачем?

Агент знает, что изменить и что сохранить

Спека Нормативная документация Как система должна работать Агент Реализовать новое Реклама после отписки не отправляется Сохранить описанное Бронь неоплаченного заказа снимается по истечении срока Спека задаёт основание для проверки кода и тестов

Где хранится спека

Спека хранится рядом с кодом

shop/ GIT-РЕПОЗИТОРИЙ src/ Код tests/ Тесты openspec/ specs/ changes/ unsubscribe/ ОДИН PULL REQUEST Отписка от рекламы src/… tests/… openspec/… Изменение кода Тесты Описание поведения Общая история версий Совместное ревью изменений OpenSpec: в других подходах имя каталога может отличаться Меняем поведение: обновляем код, тесты и спеку вместе

Что внутри?

У каждого файла своя задача

СТРУКТУРА КАТАЛОГА openspec/changes/unsubscribe/ proposal.md Зачем делаем Цель задачи, границы и затрагиваемые части системы specs/ marketing-unsubscribe/ spec.md Как система должна работать Требования, сценарии, ограничения, приёмка design.md Как устроено решение Подсистемы, их связи и технические решения tasks.md Какие шаги выполняем Реализация, проверки и отметки выполнения

Спеки накапливаются

Описываем систему постепенно

Начали работать по SDD Продолжаем работу по SDD СУЩЕСТВУЮЩАЯ СИСТЕМА ТА ЖЕ СИСТЕМА ЛЕГЕНДА Описано в спеках Ещё не описано Агент лучше понимает, какое поведение нужно сохранить Риск произвольных изменений снижается

Спеки используют все

Как каждая роль использует спеки

СПЕЦИФИКАЦИИ Рассылки Отписка останавливает рекламные письма Заказы и бронь Неоплаченный заказ: бронь снимается по таймеру Общая очередь Отмена джоб одного типа не затрагивает остальные Аналитик Уточняет требования, сценарии и ограничения Разработчик Реализует требования, сохраняет описанное поведение Ревьюер Сверяет код и изменения тестов с требованиями и ограничениями Тестировщик Составляет проверки и ожидаемые результаты

Спека проходит по процессу

Спека пополняется по ходу задачи

Аналитик ИЗ ЗАПРОСА ГОТОВИТ Разработчик ДОБАВЛЯЕТ Тестировщик ИСПОЛЬЗУЕТ КОМПЛЕКТ proposal.md spec.md proposal.md spec.md design.md tasks.md proposal.md spec.md design.md tasks.md Запрос → требования Решение и план работ Готовит и проводит тесты Передаём дальше весь накопленный комплект

proposal.md

Зачем и что меняем

proposal.md## WhyПокупатель не может отказаться от рекламы.Отписка даст контроль над рассылкой.Проблема и мотивация## What Changes- Ссылка отписки в рекламном письме.- Сохранение отказа и подтверждение.Содержание изменения## Capabilities### New Capabilities- marketing-unsubscribe: отказ от рекламных писем.Новые иизменяемые spec.md## ImpactПодписка и отправка писем.Затронутые части системы[1] OpenSpec · шаблон proposal.md ↗

spec.md

Какое поведение требуется

spec.md## PurposeУправляет отказом от рекламных писеми применяет его к последующим отправкам.Назначение возможности## ADDED RequirementsДобавляемые требования### Requirement: ОтпискаСистема НЕ ДОЛЖНА начинатьотправку рекламы после отписки.Обязательное поведение#### Scenario: Письмо в очереди- КОГДА покупатель отписался до отправки- ТО подготовленное письмо не отправляетсяУсловие → результат[1] OpenSpec · шаблон spec.md ↗

design.md

Как устроим решение

design.md## ContextПисьма и бронь используют общую очередь.Устройство и ограничения## Goals / Non-GoalsЦель: остановить рекламу.Не цель: менять общую очередь.Цель и границы## DecisionsПроверять подписку перед отправкой:не затрагиваем общую очередь.Альтернатива: отменять рекламные джобы.Решение,причина, альтернатива## Risks / Trade-offsГонка с отпиской → блокировкана пользователя при старте отправки.Риск → мера защиты[1] OpenSpec · шаблон design.md ↗

tasks.md

Какие шаги нужно выполнить

tasks.md## 1. Подписка- [ ] 1.1 Сохранить отказ; тест: подписка выключена.- [ ] 1.2 Добавить ссылку; тест: подтверждение показано.Реализация вместес тестами## 2. Отправка- [ ] 2.1 Проверять подписку; тест: письмо пропущено.Каждый шаг проверяем## 3. Интеграция- [ ] 3.1 Проверить снятие брони: товар снова доступен.Сквозная проверка[1] OpenSpec · шаблон tasks.md ↗
Условный силуэт головы с взрывом геометрических фигур

Сложна!

Не так сложно

Формат и порядок работы знает скилл

ВАШ ЗАПРОСДобавить отпискуот рекламы Фреймворк / скилл Знает формат, разделы и этап Задаёт вопросы Анализирует коди документацию Находит противоречия Добавляет перекрёстныессылки ГОТОВИТ И ОБНОВЛЯЕТ proposal.mdspec.mddesign.mdtasks.md Вы описываете задачу. Агент ведёт работу с документами.

Фреймворки для SDD

Три подхода к работе со спеками

ФРЕЙМВОРККАК ОРГАНИЗУЕТ РАБОТУ GitHub Spec Kit ↗ Последовательность этаповПринципы → требования → план → задачи OpenSpec ↗ Контекст каждого измененияПредложение, спеки, дизайн и задачи BMAD Method ↗ Роли и рабочие процессыТребования → архитектура → реализация и проверка

Что важно запомнить

Спеки помогают сохранять поведение

010203 Фиксируют ожидаемое поведение системы Пополняются по ходу задачи Аналитика → разработка → тестирование Дают общий контекст на всех этапах Больше контекста у агента → меньше риск ошибок

Что важно запомнить

Контекст передаётся и накапливается по мере движения задачи по потоку

ИдеяАналитик+ агентНамерениеТребованияРазработчик+ агентНамерениеТребованияДизайн и задачиКодРевьюерЧеловек или агент в PRНамерениеТребованияДизайн и задачиКодРезультат ревьюТестировщикИспользует контекстНамерениеТребованияДизайн и задачиКодРезультат ревьюКаждый добавляет своё. Предыдущий контекст сохраняется.Код и контекст — единое целое. Версионируем их вместе в Git.

Журнал решений

Выбор разработчика

Выбрали способ реализации
и отправили на ревью

Как остановить рекламу после отписки? ВЫБРАЛИПроверять подпискуперед отправкой письма РАССМОТРЕЛИ ДРУГОЙ ВАРИАНТОтменять рекламные джобыв общей очереди Проще проверить подпискуСложнее и рискованнее Реализовали → коммит → PR Код и спеки — в PR. Причина выбора — только в чате.

Решение осталось в чате

Ревьюер предлагает другой способ.
Вы объясняете выбор заново

АГЕНТ-РЕВЬЮЕР ПОЛУЧИЛ КОД И СПЕКИПочему выбрали проверку перед отправкой — не знает Агент-ревьюер «Проверка перед каждой отправкойсоздаёт паразитную нагрузку.Давайте лучше отменятьрекламные джобы» Вы снова объясняете «Мы уже рассмотрели оба способа.Управлять очередью рискованнее.Проще проверять подписку» Решение уже принято и обосновано Но ревьюер этого не знает

Decision log

Записываем решение и почему его приняли

АгентЗадаёт вопросыРазработчикПринимает решениеи отвечаетАгентЗаписывает ответыв decision log Decision log · журнал решений ВОПРОСКак остановить рекламу после отписки? РЕШЕНИЕПроверять подписку перед отправкой АЛЬТЕРНАТИВАОтменять рекламные джобы в очереди АРГУМЕНТЫВЫБОРАОтмена: фильтр по типу + гонка с воркером.Ошибка может сломать снятие брони.Проверка меняет только отправку рекламы. КТО И КОГДАРазработчик · дата и время принятия Передаём на ревью код, спеки и журнал решений

Журнал решений в потоке

Контекст передаётся и накапливается по мере движения задачи по потоку

ИдеяАналитик+ агентНамерениеТребованияРазработчик+ агентНамерениеТребованияДизайн и задачиКодЖурнал решенийРевьюерЧеловек или агент в PRНамерениеТребованияДизайн и задачиКодЖурнал решенийРезультат ревьюТестировщикИспользует контекстНамерениеТребованияДизайн и задачиКодЖурнал решенийРезультат ревьюЖурнал решений появляется у разработчика и идёт дальше

Ревью большого PR

Ревьюить не хочется. Но надо

shop / notifications ▾ Type / to search IssuesPull requestsActionsProjectsInsightsCodeSecurity and quality128 Добавить отписку от рекламной рассылки #248 Opencoding-agent хочет влить 18 коммитов в main ConversationCommitsChecksFiles changed 6181295 +28,426−11,937 src/notifications/sender.ts src/subscriptions/service.ts tests/unsubscribe.test.ts specs/notifications/spec.md … ещё 91 файл src/notifications/sender.tsViewed 184@@ -184,5 +184,10 @@ async function sendMarketingEmail(job) {185- await mailer.send(job.payload);186+ const subscription = await subscriptions.find(job.customerId);187+ if (!subscription.marketingEnabled) {188+ return { status: "skipped", reason: "unsubscribed" };189+ }190+ await sendWithSubscriptionLock(subscription, job.payload);Такой объём мы никогда не будем качественно ревьюить. Как быть?

Решения агента

Большинство решений принимает агент

Агент Сравнивает варианты Принимает решение Записывает выбор,альтернативы и причины 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Полезные ссылкиПередайте документ своему агенту и обсуждайте с ним свои вопросы