SDD — Spec-Driven Development for Claude Code
Каскадная иерархия спецификаций для промптинга LLM, при котором порождаемый код соблюдает инварианты проекта. Оформлено как Claude Code plugin: 10 slash-команд, 6 bash-скриптов в PATH, 7 шаблонов, 51 регрессионный тест.
Заимствует механики из четырёх SDD-источников: cog (memory + routing), GSD (gates taxonomy + context rot), Pimzino spec-workflow (steering + bug fast track), tylerburleigh/claude-sdd-toolkit (lifecycle + multi-model second opinion).
Установка
Через Claude Code marketplace (рекомендуется)
/plugin marketplace add kainsk/sdd
/plugin install sdd@sdd-marketplace
После этого:
- 10 slash-команд доступны как
/sdd:setup, /sdd:dry-run, /sdd:bug, /sdd:second-opinion, /sdd:housekeeping, /sdd:history, /sdd:evolve, /sdd:foresight, /sdd:reflect, /sdd:scenario
- CLI-обёртка
sdd и скрипты sdd-validate.sh, sdd-link-index.sh, sdd-scorecard.sh, sdd-foresight.sh, sdd-install-hooks.sh, sdd-test.sh появляются в PATH
- Шаблоны (constitution / domain / scenario / patterns / steering-product / steering-tech / steering-structure) доступны через
sdd setup в целевом проекте
Локальная разработка / тест без установки
git clone https://github.com/kainsk/sdd.git
claude --plugin-dir ./sdd
В этом режиме всё работает без копирования в кэш плагинов; правки commands/ и bin/ подхватываются через /reload-plugins.
Бутстрап нового SDD-проекта
/sdd:setup <project-name> <bounded-context>
Создаст в текущем рабочем каталоге specs/, memory/, steering/ со скелетами из шаблонов и запустит /sdd:housekeeping для проверки.
Быстрый старт после установки
- Прочитать Золотые правила — четыре закона + Gates taxonomy.
/sdd:setup my-project billing — каркас.- Заполнить
specs/constitution.md: 5–10 первых статей с RFC 2119 ключевыми словами.
- Добавить сущности и инварианты в
specs/domain/billing.md.
- Описать 3–5 сценариев в
specs/scenarios/billing.md.
- Перед каждой задачей —
/sdd:dry-run первым, код вторым. Verdict: BLOCK запрещает код.
- Перед коммитом —
sdd test (если разрабатываете плагин) или sdd validate specs (если конечный проект).
Навигация по справочнику
Иерархия спецификаций
Диалект (L2)
Gherkin-MD — единственный диалект L2: исполняемый через Cucumber/behave/godog, читаемый бизнесом, инвариантный к языку реализации. L0 и L1 — Markdown + YAML frontmatter.
Процесс
- Context Injection — порядок инъекции, бюджет, слайсинг, context rot и phase restart, параллельная генерация
- Золотые правила — Atomic / SSOT / Dry Run / Stable IDs + Gates taxonomy + maturity ladder
- Pattern Routing — core + satellite операционные правила (cog-inspired)
Toolkit (содержимое плагина)
Справочные материалы
- Глоссарий — канонические определения терминов
Ключевая идея
Спецификации образуют строгую иерархию L0 → L1 → L2. Нижние уровни НЕ ДОЛЖНЫ противоречить верхним. Конституция (L0) — высшая инстанция; при конфликте побеждает L0.
Каждый уровень — исполняемая документация: механически проверяемая (sdd validate), хранящаяся в VCS и внедряемая в контекст модели как источник истины.
L0 Конституция ← высший приоритет
│
├── ограничивает ↓
│
L1 Доменная модель ← сущности, инварианты
│
├── ограничивает ↓
│
L2 BDD-сценарии ← наблюдаемое поведение
Перед генерацией кода модель ОБЯЗАНА выполнить Dry Run через /sdd:dry-run. Канонический протокол — 04-golden-rules.md → Rule 3.
Зрелостная шкала
