Design Synthesis — правило для Claude Code
Правило design-synthesis для структурированного анализа собранных требований перед написанием design-документа. Три линзы — обобщение, выбор между построением и интеграцией, упрощение — помогают выбрать правильный масштаб решения.
MIT ★ 3 774 обновлён 2026-10-22
.claude/rules/design-synthesis.mdЧто делает design-synthesis
После сбора требований, перед тем как писать design-документ, нужно посмотреть на них через три фильтра. Design Synthesis предлагает конкретный процесс.
Первая линза — обобщение: если несколько требований — варианты одной задачи, спроектируй общее решение, которое их все покрывает. Ограничь реализацию текущими потребностями, но сделай интерфейс гибким. Вторая — выбор между своим и чужим: для каждого компонента спроси, решена ли задача уже. Ищи стандарты, проверенные библиотеки, встроенные возможности. Если принимаешь чужое решение, проверь, что оно поддерживается, совместимо со стеком и удовлетворяет требованиям к производительности. Если пишешь своё — задокументируй, почему существующие подходы не подошли.
Третья линза — упрощение: есть ли компоненты, которые существуют только «на случай»? Если интерфейс имеет одну реализацию и не видно второй, может быть, лишний слой абстракции? Меньше, согласованных компонентов лучше, чем много мелких. Это правило помогает не раздувать дизайн и держать его расширяемым там, где это важно.
Какие задачи решает
- выбрать правильный масштаб архитектуры под текущие требования
- найти баланс между переиспользованием и переразработкой
- определить, что нужно обобщить, а что оставить специфичным
- решить, строить ли компонент или взять готовый
Примеры запросов агенту
- Применяю линзы design-synthesis к требованиям перед тем, как рисовать архитектуру
- Спрашиваю агента: есть ли стандартное решение для этого компонента, или нам нужно писать своё?
- Проверяю, нет ли в дизайне слоёв абстракции, которые имеют одну реализацию
Как установить design-synthesis
Вручную: положить файлы
.claude/rules/design-synthesis.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/design-synthesis.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/design-synthesis.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/design-synthesis.mdВручную: положить файлы
.clinerules/design-synthesis.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о design-synthesis
Как установить Design Synthesis в Claude Code?
Создай файл .claude/rules/design-synthesis.md в корне проекта и добавь содержимое правила. Claude Code будет использовать его автоматически при следующем открытии проекта.
Что даёт это правило?
Правило помогает структурировать анализ требований перед проектированием. Три лены — обобщение, выбор между build и adopt, упрощение — направляют к дизайну, который не раздут и остаётся расширяемым.
Когда применять Design Synthesis?
После сбора требований и перед написанием design-документа. Процесс требует полной картины и не распараллеливается.
Исходный текст
design-synthesis.md · MIT
# Design Synthesis After discovery and before writing the design document, apply these three lenses to the collected findings. This step requires the full picture — do not parallelize. ## 1. Generalization Look across all requirements as a group. Identify cases where multiple requirements are variations of the same underlying problem. - If feature A is a special case of a more general capability X, design X with an interface that naturally supports A (and potentially B, C later) - Keep the implementation scope to what the current requirements demand — generalize the interface, not the implementation - Record identified generalizations in `research.md` under Design Decisions ## 2. Build vs. Adopt For each major component in the emerging design, ask: is this problem already solved? - Search for established standards (RFCs, protocols), battle-tested libraries, or platform-native capabilities that address the requirement - Prefer adopting existing solutions over building custom ones when they fit the requirements without significant adaptation - If adopting: verify the solution is actively maintained, compatible with the project's stack (check steering), and meets non-functional requirements - If building: document why existing solutions were rejected (capture in `research.md`) ## 3. Simplification For each component and abstraction layer in the emerging design, ask: is this necessary? - Remove components that exist "just in case" or for hypothetical future requirements not in the current spec - Flatten unnecessary abstraction layers — if an interface has only one implementation with no foreseeable second, it may not need the indirection - Prefer fewer, cohesive components over many fine-grained ones - The right design is the smallest one that satisfies all requirements and remains extensible at the interface level
© gotalab · MIT · gotalab/cc-sdd