К основному содержанию
правило CX Codex

design-review-gate — правило для Claude Code: обзор и установка

Правило design-review-gate проверяет черновик архитектуры перед формированием design.md. Находит пробелы в спецификациях и связывает каждый пункт требований с файловой структурой.

MIT ★ 3 774 обновлён 2026-10-22

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/design-review-gate.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
design-reviewer serpro69 Субагент design-reviewer проверяет проектные спецификации и планы задач без контекста прошлых обсуждений. Помогает найти противоречия и технические риски до написания кода. CX Codex ★ 155звёзд репо feature-forge https://github.com/Jeffallan Скилл feature-forge проводит интервью по требованиям и превращает идею фичи в спецификацию: EARS-требования, критерии приёмки, чек-лист реализации. CX Codex +1 4 600установок elicit juxt Скилл elicit для Claude Code и Codex ведёт structured discovery-сессию и превращает разговор с агентом в спецификацию Allium. Закрывает системы и фичи без описания. CX Codex +1 2 800установок prompt-optimizer daymade Скилл prompt-optimizer для Claude Code и других агентов: превращает расплывчатый запрос в проверяемую спецификацию по EARS. Находит отсутствующие триггеры и измеримые критерии. CX Codex +1 2 200установок gsd-spec-phase open-gsd Скилл gsd-spec-phase для Claude Code уточняет требования к фазе проекта и создаёт SPEC.md перед обсуждением способа реализации. Агент сначала изучает кодовую базу, затем задаёт вопросы и оценивает неоднозначность ответов. CX Codex +1 575установок specify Rudolf S. Скилл specify превращает короткое описание фичи или требования в полную спецификацию. Перед написанием документа задаёт вопросы про намерения и допущения. CX Codex +1 ★ 587звёзд репо

Из того же набора12

Весь набор →
design-synthesis Правило design-synthesis для структурированного анализа собранных требований перед написанием design-документа. Три линзы — обобщение, выбор между построением и интеграцией, упрощение — помогают выбрать правильный масштаб решения. CX Codex +1 ★ 3 774звёзд репо steering-principles Правило steering-principles задаёт стандарты файлов памяти проекта: фиксирует паттерны и архитектуру без перегрузки агента полными списками файлов. CX Codex +1 ★ 3 774звёзд репо tasks-parallel-analysis Правило tasks-parallel-analysis для Claude Code: отмечает в tasks.md задачи, которые можно выполнять параллельно, учитывая зависимости между ними. CX Codex +1 ★ 3 774звёзд репо requirements-review-gate Правило requirements-review-gate останавливает работу и требует отремонтировать черновик требований перед тем, как начать писать requirements.md. Проверяет полноту охвата, формат EARS и структуру. CX Codex +1 ★ 3 774звёзд репо ears-format Правило ears-format задаёт формат EARS для критериев приёмки: условие, система и действие. Пригодится в spec-driven разработке. CX Codex +1 ★ 3 774звёзд репо design-discovery-full Правило design-discovery-full проводит систематическое исследование требований, существующего кода, технологий и рисков перед тем, как начать дизайн. Помогает выбрать архитектуру на основе фактов, а не предположений. CX Codex +1 ★ 3 774звёзд репо design-review Правило design-review оценивает технический дизайн-документ перед началом кодинга и выносит вердикт GO или NO-GO. Ограничивает замечания тремя критическими пунктами со ссылками на требования. CX Codex +1 ★ 3 774звёзд репо cc-sdd-new-agent Скилл cc-sdd-new-agent помогает добавить нового coding-агента в cc-sdd по готовому SOP: от исследования формата до тестов и dry-run. CX Codex +1 ★ 3 774звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой