Spec-Driven Development · Qwen Code + OpenSpec

Спецификация — контракт, а не ритуал

Практический туториал по внедрению SDD в команде с микросервисами, десятком репозиториев и своими NuGet-библиотеками. Включая главный вопрос: где заводить проект для спецификаций.

$ npm install -g @fission-ai/openspec@latest
$ cd payments-service && openspec init --tools qwen

qwen> /opsx-propose limit-refund-window
      ✓ proposal.md — зачем и что меняем
      ✓ specs/      — требования и сценарии
      ✓ design.md   — техническое решение
      ✓ tasks.md    — чек-лист реализации
qwen> /opsx-apply     # агент реализует по чек-листу
qwen> /opsx-archive   # дельта влилась в openspec/specs/

Сквозной кейс

Команда «Синтез»

Весь туториал построен на одном кейсе — вымышленной, но узнаваемой команде B2B-платформы. Если у вас микросервисы, разные репозитории и общие библиотеки — это про вас.

Сервисы
7 микросервисов на .NET, у каждого свой репозиторий
Библиотеки
2 NuGet-пакета в отдельном репозитории, свой фид
Команда
6 инженеров, каждый уже пользуется ИИ-агентом по-своему
Боль
требования живут в чатах; агенты уверенно строят не то

Программа

Шесть частей

  1. 01Зачем нужна спецификацияПочему промпт — это неявное знание, а спека — явный контракт. Что такое spec-driven development и чем он не waterfall.~7 мин
  2. 02Инструменты: Qwen Code и OpenSpecУстановка и настройка Qwen Code CLI, инициализация OpenSpec, цикл explore → propose → apply → archive.~9 мин
  3. 03Монорепозиторий или мультирепо: где живут спекиГлавный архитектурный выбор: openspec/ в каждом репо, центральный репозиторий спецификаций (Store) или гибрид. Плюсы, минусы, рекомендация.~12 мин
  4. 04Первая фича через спецификациюПошаговый прогон в одном сервисе: init, propose, ревью дельта-спеки, apply, archive.~10 мин
  5. 05Сквозная фича: несколько сервисов и NuGet-пакетДвухслойная схема со Store: общий контракт в репозитории планирования, реализация — локальными изменениями в каждом репо.~11 мин
  6. 06Внедрение в командеПилот, конвенции, ревью спеки до ревью кода, openspec validate в CI и типовые ошибки внедрения.~8 мин