Перейти к содержанию

sdd-workflow

Практичный workflow Spec-Driven Development для команд, которым нужны чёткие границы scope, предсказуемые этапы поставки и сохраняемый контекст проекта.

Схема workflow

Начало работы

bash git clone https://github.com/avatarsik6699/sdd-workflow.git /tmp/sdd-workflow cd /tmp/sdd-workflow /workflow-init /path/to/target-project cd /path/to/target-project

Инициализация выполняется один раз, затем для каждой фазы повторяется цикл:

  1. /spec-init — создать или обновить docs/SPEC.md
  2. /phase-init 01 — сгенерировать docs/PHASE_01.md + docs/PHASE_01_NOTES.md с task ID
  3. (опционально) /impl-brief 01 — сгенерировать планы реализации по каждой задаче
  4. Реализовать scope фазы (вручную, силами агента или гибрид)
  5. (опционально) /impl-assist 01 — агент реализует невыполненные задачи
  6. /phase-gate 01 — автоматические проверки + architect review notes
  7. /context-update 01 — фаза помечается done, синхронизируются CONTEXT / STATE / CHANGELOG
  8. (опционально) /project-sync — отправить статусы задач в GitHub Issues + Kanban-доску

Что даёт этот репозиторий

  • Канонические playbooks (docs/playbooks/), где зафиксированы процедуры каждого шага workflow.
  • Готовые обёртки для Claude Code и Codex, позволяющие запускать один и тот же процесс в разных агентных средах.
  • Шаблоны контрактной документации: SPEC, STATE, CONTEXT, CHANGELOG, PHASE и PHASE_NOTES, чтобы синхронизировать планирование и реализацию.
  • Workflow-ассеты, которые доставляются через git clone, без CLI-пакета и без привязки к runtime.

Репозиторий намеренно построен как documentation-first: процедурная логика хранится в playbooks, а обёртки остаются тонким интерфейсным слоем.

Куда идти дальше

Быстрые ответы

Это CLI-инструмент?

Нет. Команды работают как навыки/обёртки агента, а логика хранится в Markdown-плейбуках.

Подойдёт ли для моего стека?

Да. Workflow стек-агностичен. Gate-команды задаются в docs/STACK.md уже в интегрированном проекте.

Обязательно ли использовать impl-brief и impl-assist?

Нет. Это опциональные помощники. Можно реализовывать все задачи вручную и просто отмечать чекбоксы. Используйте их, когда хотите поручить агенту планирование или реализацию.

Нужен ли GitHub?

Нет. /project-sync — опционален и специфичен для GitHub. Все остальные навыки workflow работают без GitHub-удалённого репозитория.