Об этом проекте

Шаблон стартера SDD + ADD — это структура управления для ИИ-ассистентов программирования, особенно для Claude Code. Его основная цель — превратить ИИ-ассистента в дисциплинированного партнера по разработке, работающего по рабочему процессу Spec-Driven Development (SDD) в сочетании с Agent-Driven Development (ADD). ## Основной рабочий процесс Шаблон применяет последовательный рабочий процесс разработки: CONTEXT → SPEC → PLAN → TASKS → execute → verify → sync. Каждый шаг имеет контрольную точку и требует одобрения человека, прежде чем агенту будет разрешено выполнять действия. ## Три основополагающих правила 1. **Редактируйте спецификацию, а не код**: Если требование отсутствует или неоднозначно, используйте команду `/sdd-update` для обновления спецификации, затем проверьте её перед изменением поведения. 2. **Никаких технических спекуляций**: План, задачи и выполнение используют только привязки и точные команды проверки, утвержденные в `.sdd/architecture-profile.md`. 3. **Решает человек**: Агент не самоутверждается, не выполняет `git push`, не развертывает и не выполняет автономные физические изменения состояния. ## Владение и выполнение Шаблон разделяет две независимые оси в `.sdd/shared_context.md`: - **Владение проектом** (`solo` или `team`): Определяет действительность проверки человеком и политику доставки Git. По умолчанию — `team`. - **Выполнение агентом** (`direct` или `orchestrated`): `/add-execute` выполняется напрямую в текущем агенте или оркестрирует воркеров после наблюдения за возможностями среды выполнения. ## Документация Шаблон предоставляет комплексную систему документации: - **Быстрый старт** (`docs/sdd-add-quickstart.md`): Пошаговая дорожная карта для новичков. - **Руководство по операциям** (`docs/sdd-add-guide.md`): Понимание артефактов, ворот и владения. - **Краткий справочник** (`docs/sdd-add-field-guide.md`): Выбор команд по сценарию. - **Плейбук сценариев** (`docs/sdd-add-scenario-playbook.md`): Обработка greenfield, brownfield, ошибок и передачи дел. - **Руководство по архитектурному профилю** (`docs/architecture-profile-guide.md`): Выбор привязок и технических команд. - **Руководство по выполнению** (`docs/multi-agent-orchestration-guide.md`): Выполнение задач/функций и оркестрация воркеров. ## Канонические источники - `.claude/skills/`: Контракты для команд. - `.claude/skills/_shared/ai-review-protocol.md`: Протокол проверки, методология и запись действий. - `.sdd/architecture-profile.md`: Технические привязки и точные команды проверки. - `CONSTITUTION.md`: Жесткие правила безопасности, архитектуры и качества. - `AGENTS.md`: Область действия и разрешения агента. ## Утилитарные скрипты - `scripts/self-heal.sh`: Запускает утвержденную команду для сбора доказательств; не изменяет исходный код и не повторяет попытки. - `scripts/template-smoke.sh` / `.ps1`: Статические проверки файлов, ссылок и политических контрактов. - `scripts/adopt.*`: Адаптация шаблона в существующий репозиторий. - `scripts/update.*`: Получение обновлений из шаблона; файлы управления помещаются для проверки человеком.