design-system-compound-components — правило для Claude Code
Правило design-system-compound-components для Claude Code запрещает передавать строки в невизуальные узлы без текстовой обёртки. Направляет агента делить интерфейс на составные элементы вроде ButtonText.
AGPL-3.0 ★ 88 обновлён 2026-11-17
.claude/rules/design-system-compound-components.mdЧто делает design-system-compound-components
Правило запрещает создавать компоненты, которые принимают обычную строку как потомка, если сам элемент не является специализированным текстовым узлом. Если контейнеру вроде кнопки или плашки нужен текст вместе с иконкой, агент обязан проектировать составную структуру.
Вместо объединения типов в children: string | React.ReactNode и ручных проверок типов инструкция требует заводить явные дочерние блоки — например, ButtonText и ButtonIcon. Такой подход убирает скрытые ветвления в разметке и делает состав элементов очевидным при чтении кода.
Инструкция сохраняется обычным Markdown-файлом в дереве проекта. Для её работы не требуются сторонние утилиты или дополнительные пакеты.
Какие задачи решает
- запретить неявные строковые пропсы в невизуальных компонентах
- разделить контейнеры интерфейса на составные дочерние части
- устранить проверки типов внутри свойств children
- унифицировать API кнопок и карточек в дизайн-системе
Примеры запросов агенту
- Сделай компонент кнопки с иконкой и текстом по правилам дизайн-системы
- Отрефактори карточку товара, разделив её на составные части с отдельным текстом
Как установить design-system-compound-components
Вручную: положить файлы
.claude/rules/design-system-compound-components.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/design-system-compound-components.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/design-system-compound-components.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/design-system-compound-components.mdВручную: положить файлы
.clinerules/design-system-compound-components.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о design-system-compound-components
Как установить design-system-compound-components в Claude Code?
Создайте файл .claude/rules/design-system-compound-components.md в корне репозитория и скопируйте в него текст правила.
Зачем нужно правило design-system-compound-components?
Оно убирает полиморфные строковые потомки, вынуждая агента всегда оборачивать надписи в выделенные текстовые узлы вроде ButtonText.
Для каких библиотек подходит это правило?
Паттерн ориентирован на проекты с React и React Native, где контейнеры вроде Pressable не должны принимать неразмеченный текст напрямую.