design-review-gate — правило для Claude Code: обзор и установка
Правило design-review-gate проверяет черновик архитектуры перед формированием design.md. Находит пробелы в спецификациях и связывает каждый пункт требований с файловой структурой.
MIT ★ 3 774 обновлён 2026-10-22
.claude/rules/design-review-gate.mdЧто делает design-review-gate
Правило внедряет строгий барьер качества при проектировании системы. Сначала выполняются механические тесты: парсинг числовых идентификаторов из requirements.md и сопоставление их с разделами проекта. В секции структуры файлов запрещены заглушки вроде «TBD», а каждый упомянутый компонент обязан получить чёткий путь в репозитории.
Смысловая часть проверки отсекает спекулятивные абстракции. Если разработчик или модель вводит интерфейсы под гипотетические будущие задачи, правило требует удалить лишний код. Решения о выборе сторонних библиотек и границах параллельной разработки фиксируются сразу, чтобы задачи не блокировали друг друга.
Процесс строго ограничен двумя циклами правок. Если за две попытки устранить несоответствия не удаётся из-за противоречий в спецификации, агент обязан остановить работу и отправить требования на доработку вместо выдумывания архитектурных деталей.
Какие задачи решает
- сопоставить числовые идентификаторы из
requirements.mdс кодовой базой - выявить компоненты без точного пути в файловой структуре проекта
- устранить преждевременные абстракции под неподтверждённый функционал
- остановить генерацию архитектуры при обнаружении противоречий в требованиях
Примеры запросов агенту
- Проверь черновик архитектуры перед тем как создавать
design.md - Запусти механические проверки покрытия для требований из
requirements.md
Как установить design-review-gate
Вручную: положить файлы
.claude/rules/design-review-gate.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/design-review-gate.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/design-review-gate.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/design-review-gate.mdВручную: положить файлы
.clinerules/design-review-gate.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о design-review-gate
Как установить design-review-gate в Claude Code?
Сохраните файл правила по пути .claude/rules/design-review-gate.md. После этого агент будет применять проверки перед созданием финального design.md.
Что делает design-review-gate?
Контролирует готовность архитектурного проекта: сверяет трассировку требований, ищет потерянные компоненты и удаляет заглушки из структуры файлов.
Сколько циклов исправления черновика допускает правило?
Правило ограничивает процесс двумя проходами исправления. Если проблемы остаются из-за неполноты требований, агент возвращает задачу на фазу спецификации, а не додумывает архитектуру самостоятельно.
Исходный текст
design-review-gate.md · MIT
# Design Review Gate Before writing `design.md`, review the draft design and repair local issues until the design passes or a true spec gap is discovered. ## Requirements Coverage Review - Every numeric requirement ID from `requirements.md` must appear in the design traceability mapping and be backed by one or more concrete components, contracts, flows, data models, or operational decisions. - Every requirement that introduces an external dependency, integration point, runtime prerequisite, migration concern, observability need, security constraint, or performance target must be reflected explicitly in `design.md`. - If coverage is missing because the design draft is incomplete, repair the draft and review again. - If coverage cannot be completed cleanly because requirements are ambiguous, contradictory, or underspecified, stop and return to the requirements phase instead of inventing design detail. ## Architecture Readiness Review - Component boundaries must be explicit enough that implementation tasks can be assigned without guessing ownership. - Interfaces, contracts, state transitions, and integration boundaries must be concrete enough for implementation and validation. - Build-vs-adopt decisions that materially affect architecture must be captured in `design.md`, with deeper investigation left in `research.md` when present. - Runtime prerequisites, migrations, rollout constraints, validation hooks, and failure modes must be surfaced when they materially affect implementation order or risk. ## Executability Review - The design must be implementable as a sequence of bounded tasks without hidden prerequisites. - Parallel-safe boundaries should be visible where the architecture intends concurrent implementation. - Avoid speculative abstraction: remove components, adapters, or interfaces that exist only for hypothetical future scope. - If a section is too vague for tasks to reference directly, rewrite it before finalizing the design. ## Mechanical Checks Before applying judgment, verify these mechanically: - **Requirements traceability**: Extract all numeric requirement IDs from `requirements.md`. Scan the design draft for each ID. Report any IDs not found in the design. - **File Structure Plan populated**: The File Structure Plan section must contain concrete file paths (not just "TBD" or empty). Scan for placeholder text in that section. - **No orphan components**: Every component mentioned in the design must appear in the File Structure Plan with a file path. Scan for component names that have no corresponding file entry. ## Review Loop - Run mechanical checks first, then judgment-based review. - If issues are local to the draft, repair the draft and re-run the review gate. - Keep the loop bounded: no more than 2 review-and-repair passes before escalating a real spec gap. - Write `design.md` only after the review gate passes.
© gotalab · MIT · gotalab/cc-sdd