Spec-Driven Development через все роли команды: как мы внедрили единый процесс в монолит с 10-летней историей

Доклад · 2026

Spec-Driven Development через все роли команды:
как мы внедрили единый процесс
в монолит с 10-летней историей


Иван Поддубный
Иван Поддубный CTO Вебпрактик

Кто я

  1. 15+ лет в IT. Прошёл путь fullstack → teamlead → CTO
Логотипы клиентов Вебпрактик — крупные корпорации

Вебпрактик — веб-интегратор для корпораций

О чём поговорим

Что такое SDD

Spec-Driven Development — подход, где спецификация становится единственным источником истины.

Сначала фиксируем намерение в спеке — из неё рождается код, тесты и задачи.

🙋 Кто использует SDD

Поднимите руку, если это про вас:

Как мы пришли к SDD

Две истории

  1. Через глубину adoption
  2. Через ошибку на проектировании уровня автономности

История первая

🙋 Вопросы залу про adoption

Поднимите руку, если это про вас:

К концу 2025 года мы через путь терний пришли к 100% adoption среди разработчиков

Кратко о пути до 100% adoption
среди разработчиков

Ширина есть.
Как теперь качать глубину используемых практик?

Матрица зрелости разработчика

4 уровня. Уровень определялся использованием инженерных практик в работе с агентом.

Уровень Что демонстрирует Кешбэк подписки
L1 · базаРешает задачи агентом, базовый промптингмладшая / средняя
L2Контекст, правила, ревью результатасредняя
L3Харнесс, декомпозиция, проверкивыше средней
L4 · максСистемная работа с практикамимакс

Подталкивали через трекеров… а потом остановились.

Почему остановили гонку за глубиной

Поняли: приход SDD и общих скилов во многом закрывает этот слой.

История вторая

SDD

Spec-Driven Development как ответ на проблему контекста и разнобоя

Предыстория про матрицу зрелости

Модель зрелости внедрения AI в SDLC: уровни 0–4 (без AI → AI-чат → локальный агент → background-агент → полная автономность) для аналитика, разработчика и QA

Автономность снижает бас-фактор

Логика простая:

Кейс стратегической сессии

Попросили руководителей цехов нарисовать, как они видят выход на L3.

Мост, который строили с двух сторон, не сошёлся посередине

Нужен единый
фреймворк и платформа

Управленческая ошибка, которую совершают многие

Ответ для нас — сквозной SDD: единый язык и процесс через всю цепочку SDLC.

Выбор фреймворка

Из чего выбирали инструмент для сквозного SDD — и на чём остановились

Из чего выбирали

Типовые фреймворки сквозного SDD и их популярность на GitHub*:

GitHub Spec Kit ★ ~90k

Флагман от GitHub, широкая дистрибуция и экосистема

BMAD-METHOD ★ ~49k

Агентные роли, «команда агентов» на весь цикл

наш выбор OpenSpec ★ ~58k

Простой вход, два состояния контекста, brownfield-идеология

* порядок звёзд GitHub, середина 2026 — цифры ориентировочные.

Почему OpenSpec

🙋

Кто уже пробовал OpenSpec?

Основы OpenSpec
на пальцах

Два состояния контекста, артефакты change и его жизненный цикл

База OpenSpec:
два состояния контекста

Change живёт, проходит ревью и реализацию → затем вливается в источник истины.

Базовые артефакты — структура папок

openspec/
├── specs/                # ИСТОЧНИК ИСТИНЫ (domains)
│   └── <domain>/
│       └── spec.md
└── changes/              # активные предложения
    └── <change-id>/
        ├── proposal.md   # смысл: зачем и что
        ├── design.md     # ADR / решения
        ├── tasks.md      # план реализации
        └── specs/        # дельта к источнику истины

Жизненный цикл change

опциональноexplore

Прожарить идею: собрать контекст, накидать варианты. Аналог /grillme и /brainstorm

1propose

Создаём change: proposal + дельта спеки

2apply

Реализуем change агентом по tasks

3archive

Вливаем дельту в источник истины

propose → apply → archive — база. Один и тот же артефакт ведёт задачу от смысла до прод-кода.

Сквозной SDD
vs SDD разработчика

Многие внедряют SDD только в разработку. Но основной профит — в сквозном внедрении.

Антипаттерн: SDD только в разработке

Jira / Confluence спецификация во внешней системе — источник требований
↓ требования падают тикетами и текстом ↓
Аналитик / продукт пишет требования в Jira/Confluence
→
Разработчик
SDD генерит свой слой спек только под себя
→
Тестировщик вне SDD, свои сценарии

SDD живёт островом у разработчика · требования дублируются · трассировка рвётся

Сквозной SDD: одна платформа на всю команду

Спеки в том же репозитории единый источник истины вместо Jira / Confluence

единая SDD-платформа · аналитик · разработчик · тестировщик

Аналитик
/explore/propose
quality
gate
Разработчик
/apply
quality
gate
merge / prod
Тестировщик держит quality gate после аналитика и после разработчика

Одни спеки, один язык, сквозная трассировка — основной профит именно здесь

Ошибка:
пережиток старого мышления

v1 · как мы сначала думали делать e2e

Аналитик
/explore/propose
quality
gate
Разработчик
/apply
Тестировщик пишет e2e автотесты
отдельным скилом
merge / prod

Думали, что e2e напишут тестировщики отдельным шагом — а это разрывает цикл «код ↔ тесты»

Правильно: e2e в одном цикле с кодом

v2 · e2e отдаём агенту разработчика

Аналитик
/explore/propose
quality
gate
Разработчик
/apply
код ⇄ e2e
quality
gate
merge / prod
Тестировщик держит quality gate после аналитика и после разработчика

Агент пишет тесты и гоняет их с правками кода в одном цикле — разрыв этого цикла и есть пережиток

План тестирования (test-plan.md)

Tiny teams

Маленькие автономные команды — куда смещается формат работы

🙋

Кто слышал про tiny teams?

Из кого состоит tiny team

tiny team · маленькая автономная команда

Продукт-инженер обязательно
Full-cycle инженер закрывает весь цикл — от смысла до прода

Маленькая команда, где каждый закрывает широкий срез работы

🙋

У кого в командах уже есть
full-cycle инженеры?

Что вбирает full-cycle инженер

Full-cycle инженер
↑ в одного инженера вливаются целые дисциплины ↑
Аналитика закрывает
QA / SDET закрывает
DevOps верхнеуровнево + платформа помогает
Фронтенд ? сеньорный навык
Бэкенд ? сеньорный навык

Требования, тесты и devops закрываются. Фронт и бэк на уровне сеньора — пока открытый вопрос

Переходный период

Пока фронт и бэк не закрывает один инженер — делим работу прямо в плане и катим двумя прогонами.

plan.md

## Фронтенд
- [ ] Форма и состояния UI
- [ ] Интеграция с API
- [ ] Компонентные тесты

## Бэкенд
- [ ] Эндпоинты и валидация
- [ ] Миграции схемы
- [ ] Интеграционные тесты

Аналитика

Как аналитики заходили в сквозной SDD

Переход аналитиков на SDD

  1. У многих уже стоял локальный harness для работы с вопросами к реализации

Документация для стейкхолдеров

Человекочитаемую доку собираем из спек отдельным скилом.

источник истины SDD-спеки

specs/ — поведение системы

→
отдельный скил Экспорт

Человекочитаемый срез

→
стейкхолдеры Confluence

Публикуем при правках

UseCase vs Gherkin

По умолчанию в OpenSpec — Gherkin.

Работа с мультирепо

Идеально — монорепо. Но у нас 2 монолита (фронт и бек) и пачка сервисов и микросервисов вокруг — каждый в своём репозитории.

Мета-репозиторий изнутри

meta-repo/                 # наш harness + OpenSpec
├── Makefile               # make up → клонирует все репы
├── agents.md              # карта: что за проект и куда идти
├── openspec/              # спеки и changes (источник истины)
├── frontend/              # монолит · фронт   ← отдельный репозиторий
│   └── agents.md          # свой контекст, работает рекурсивно
├── backend/               # монолит · бэк     ← отдельный репозиторий
│   └── agents.md
├── service-auth/          # сервис
│   └── agents.md
└── service-billing/       # микросервис
    └── agents.md

Трассировка смысла

От строки кода — к «зачем»: код ↔ коммит ↔ change ↔ источник истины

Трассировка: от строки кода к смыслу

Каждый коммит подписан названием change, на основе которого вносился.

шаг 1 Кусок кода

Агент находит строку, которую нужно понять или поменять

→
шаг 2 · git Коммит

git blame → коммит, подписанный change-id

→
шаг 3 · change Смысл

Открываем change: зачем писался код и каким был дизайн

Связь «код ↔ change» восстанавливается локально, без похода в трекер.

Почему это реально работает

change-центричная парадигма

spek · список changes

Сервис spek: список активных changes с прогресс-барами выполнения задач и секцией Archived

spek · просмотр change

Сервис spek: просмотр одного change с табами Proposal, Design, Specs, Tasks и оглавлением

Один change: proposal · design · specs · tasks — в одном месте

Всё ли делать через change?

Нет. Правки, которые не трогают спеки, запускаем обычными промптами — без change.

Технический change

Сокращённый инженерный change: спеки может не менять, но контекст решения держит.

1Смысл

Зачем меняем — цель и контекст

2Реализация

Как решили — ключевые решения

3План

Проверяемые шаги реализации

Типичный пример — рефакторинг: поведение (спека) не меняется, но смысл, реализация и план всё равно фиксируются в change.

Контроль

Регламент можно нарушить — иногда change создают «мимо» или не создают вовсе.

Harness

Обвязка вокруг агента, на которой едет весь процесс

SDD — фундамент нашего harness

Сверху кладём всё остальное

Инженерные практики Скилы Правила и политики Готовые команды Контекст проекта
Сквозной SDD

Главный и основной источник контекста — единый источник истины для людей и агентов

Практика 2 уровень
локальный агент
3 уровень
облачный runtime
Сквозной SDD фундамент фундамент
Quality gates перед merge усиливает обязательно
Observability трейсов усиливает обязательно
Sandbox: эфемерные окружения + изоляция усиливает обязательно
Action Policy / HITL ручной HITL обязательно
Evals: автотесты агентов усиливает критично
Resource & cost limits собирать данные обязательно
Multi-agent coordination — обязательно
Модельно-независимый harness желательно критично
AI Gateway (LLM-прокси) усиливает обязательно
Агент с выходом на L3 — обязательно
Agent-first IDP (платформа) — критично

Скилы — часть нашего harness

берём из сообщества Готовое
  • superpowers — берём часть, например TDD
  • agent-browser от Vercel
  • skill.sh — независимость от агента

Текущие эффекты
и следствия

Узкое место сместилось

Эффект и бейзлайн

Выводы

Что забираем с собой

  1. Внедряйте AI в SDLC сквозным образом — единый процесс через всю цепочку

Пожалуйста, оставьте
свой отзыв!

QR · оставить отзыв QR · канал техлида @techlead_stream
Иван Поддубный
Иван Поддубный CTO Вебпрактик

@northleshiy