Hybrid SDD Framework

Гибридный SDD-фреймворк для репозитория: единый процесс спецификации, реализации и верификации изменений через папки артефактов (changes/<change-name>), с поддержкой нескольких AI-агентов, guardrails и воспроизводимой документации.

Для чего это

• Стандартизирует процесс разработки независимо от AI-инструмента.
• Делает статус изменений прозрачным: completed / ready / blocked.
• Снижает риск потери контекста между ветками и участниками команды.
• Формирует PR/MR описание из артефактов, а не из истории чата.

Быстрый старт

Установка CLI:

npm i -g @deepydee/hybrid-sdd
hybrid-sdd --help

Альтернатива без глобальной установки:

npx @deepydee/hybrid-sdd --help

Примеры:

hybrid-sdd bootstrap --ci github --docker compose --overwrite abort --approve-external --agent windsurf
hybrid-sdd new my-first-change
hybrid-sdd status my-first-change
hybrid-sdd instructions my-first-change tasks

Основные документы

• Contributing
• Начало работы
• Рабочий процесс
• Команды CLI
• Сценарии использования
• Troubleshooting

Ключевые возможности

• Bootstrap окружения и интеграций (CI, Docker, agent context).
• Schema-driven workflow артефактов с зависимостями.
• Безопасный импорт внешних skills: allowlist, pinning, static scan, manual approval.
• Генерация и аудит документации (docs --mode generate|audit).
• Генерация PR/MR summary (pr-template <change-name>).

Важные пути

• Конфиг фреймворка: .specify/memory/hybrid-sdd.yaml
• Конфиг агентов: .specify/memory/agents.yaml
• Уроки/guardrails: .specify/memory/lessons/
• Шаблоны артефактов: .specify/templates/artifacts/
• Шаблоны документации: .specify/templates/docs/

Лицо процесса

Фреймворк работает по принципу: сначала артефакты изменения и quality-gates, затем реализация и архивирование. Это делает решение воспроизводимым и проверяемым.