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

composition · maxtrigify — правило для Claude Code: что делает и как установить

Правило composition для Claude Code помогает разбивать крупные UI-компоненты на небольшие субагенты с четкими задачами. Оно применяется при проектировании библиотек и сложных интерфейсов.

Apache-2.0 ★ 141 обновлён 2026-11-17

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

Что делает composition

Это правило навязывает паттерн компоновки вместо использования большого числа пропсов. Каждый компонент делится на узкоспециализированные части: Root управляет состоянием через контекст, Trigger отвечает за взаимодействие, Content отображает информацию.

Применение подхода требует структурирования кода через пространства имён, где Root, Item, Trigger и Content экспортируются как единый объект.

Какие задачи решает

  • разбиение монолитных компонентов на части
  • настройка гибкой структуры UI
  • создание переиспользуемых библиотек компонентов
  • организация передачи состояния между элементами

Примеры запросов агенту

  • Добавь правило composition, чтобы рефакторить текущий компонент Accordion.
  • Примени паттерн состава для моей формы регистрации.
  • Используй правило composition для разделения ответственности в компоненте модального окна.

Как установить composition

Вручную: положить файлы

.claude/rules/composition.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о composition

Как установить composition в Claude Code?

Создайте файл .claude/rules/composition.md и поместите в него содержимое правила.

Что делает composition?

Оно задаёт архитектурный паттерн для разбиения сложных интерфейсов на мелкие взаимодействующие компоненты.

Когда использовать это правило?

Применяйте его, когда компонент перегружен пропсами или требует глубокой кастомизации структуры пользователем.

Исходный текст

composition.md · Apache-2.0
---
title: Component Composition
impact: HIGH
impactDescription: Foundation of component architecture
tags: composition, patterns, sub-components, context, root, trigger, content
---

## Component Composition

Composition is the foundation of building modern UI components. Instead of cramming all functionality into a single component with dozens of props, break components down into smaller, focused sub-components that work together.

**Incorrect (monolithic, hard to customize):**

```tsx
<Accordion data={data} />
```

**Correct (composable, each layer customizable):**

```tsx
<Accordion.Root open={open} setOpen={setOpen}>
  {data.map((item) => (
    <Accordion.Item key={item.title}>
      <Accordion.Trigger>{item.title}</Accordion.Trigger>
      <Accordion.Content>{item.content}</Accordion.Content>
    </Accordion.Item>
  ))}
</Accordion.Root>
```

### Building Composable Components

#### 1. Root Component

The main container that holds sub-components and manages shared state using Context:

```tsx
const AccordionContext = createContext<AccordionContextValue>({
  open: false,
  setOpen: () => {},
});

export const Root = ({
  children,
  open,
  setOpen,
  ...props
}: AccordionRootProps) => (
  <AccordionContext.Provider value={{ open, setOpen }}>
    <div {...props}>{children}</div>
  </AccordionContext.Provider>
);
```

#### 2. Item Component

A simple wrapper for each item:

```tsx
export const Item = (props: AccordionItemProps) => <div {...props} />;
```

#### 3. Trigger Component

Handles user interaction:

```tsx
export const Trigger = ({ asChild, ...props }: AccordionTriggerProps) => {
  const { open, setOpen } = useContext(AccordionContext);
  return (
    <button onClick={() => setOpen(!open)} aria-expanded={open} {...props} />
  );
};
```

#### 4. Content Component

Displays the main content:

```tsx
export const Content = ({ asChild, ...props }: AccordionContentProps) => {
  const { open } = useContext(AccordionContext);
  if (!open) return null;
  return <div {...props} />;
};
```

#### 5. Export Pattern

Export components as a namespace:

```tsx
export const Accordion = { Root, Item, Trigger, Content };

// Usage
<Accordion.Root open={open} setOpen={setOpen}>
  <Accordion.Item>
    <Accordion.Trigger>Title</Accordion.Trigger>
    <Accordion.Content>Content</Accordion.Content>
  </Accordion.Item>
</Accordion.Root>;
```

### Naming Conventions

- **Root** - Main container component
- **Trigger** - Element that initiates an action
- **Content** - Element containing the main content
- **Header/Body/Footer** - Structured content areas
- **Title/Description** - Informational components

### Best Practices

1. **Single Responsibility** - Each sub-component should have one clear purpose
2. **Context for State** - Use React Context to share state between sub-components
3. **Extend HTML Attributes** - Always extend native HTML element props
4. **Consistent Naming** - Follow established conventions
5. **Namespace Exports** - Export components as a namespace for clean API
6. **Composition Over Configuration** - Prefer multiple components over many props

### When to Use Composition

**Use composition when:**

- A component has multiple responsibilities
- Customization requires CSS overrides
- You need flexible layouts or structures
- Building a component library
- Components need to work together but remain independent

**Avoid composition for:**

- Simple, single-purpose components
- Components that don't need customization
- Over-engineering simple UI elements

© maxtrigify · Apache-2.0 · maxtrigify/Otto

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

Все правила IDE по теме «Фронтенд и UI» →

Сначала — composition от других авторов.

composition Devin-AXIS Правило composition задаёт стандарты компоновки UI-компонентов: структуру карточек, обёртки для пунктов меню, доступность модальных окон и готовые примитивы вместо кастомных тегов. CX Codex +1 ★ 7 523звёзд репо vercel-composition-patterns vercel Скилл vercel-composition-patterns для Claude Code задаёт правила перехода от Boolean props к compound components и общему контексту в React. CX Codex +1 464 000установок react-hooks-composition Claude MPM Team Скилл react-hooks-composition для Claude Code помогает собирать React-хуки для загрузки данных, поиска с задержкой и контекстов. Связывает состояние интерфейса с запросами к API. CX Codex +1 206установок critique-composition Owl-Listener Скилл critique-composition оценивает баланс, пустое пространство, ритм и гештальт-группировку на готовом экране. Помогает, когда в макете всё на месте по иерархии, но композиция выглядит разваленной. CX Codex +1 2 500установок shot-composition iart-ai Скилл shot-composition для Claude Code планирует композицию кадра: сетку, фокусную точку, слои глубины и движение камеры. Раскладывает сцену по слоям и пересчитывает её под 16:9, 9:16 и 1:1. CX Codex +1 6 000установок photo-composition-critic curiositech Скилл photo-composition-critic для Claude Code разбирает композицию, цвет и визуальный баланс фото и предлагает улучшения. Критика снимков и сравнение вариантов кадрирования. CX Codex +1 674установок patterns-explicit-variants tech-leads-club Правило patterns-explicit-variants требует собирать каждый режим компонента отдельным компонентом вместо набора булевых пропсов. По вызову сразу видно, что отрисуется. CX Codex +1 ★ 7 191звёзд репо

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

Весь набор →
npm Правило npm для Claude Code задаёт стандарты публикации компонентов в виде пакетов с версионированием. Настраивает package.json, сборку через tsup и директивы Tailwind. CX Codex +1 ★ 141звёзд репо registry Правило registry для Claude Code описывает публикацию UI-компонентов как исходного кода. Оно задаёт формат метаданных и шаги размещения реестра. CX Codex +1 ★ 141звёзд репо marketplaces Правило marketplaces для Claude Code систематизирует поиск и интеграцию компонентов из внешних реестров. Оно помогает агенту оценивать качество готового кода перед добавлением в проект. CX Codex +1 ★ 141звёзд репо design-tokens Правило design-tokens для Claude Code заменяет жёстко заданные цвета семантическими токенами. Переключение светлой и тёмной темы меняет значения переменных, а не классы компонентов. CX Codex +1 ★ 141звёзд репо overview Правило overview для Claude Code задаёт принципы создания доступных и составных UI-компонентов. Оно подключается при проектировании компонентов и их API. CX Codex +1 ★ 141звёзд репо types Правило types для Claude Code стандартизирует описание пропсов компонентов в TypeScript. Оно задаёт архитектуру для создания гибких и типизированных интерфейсов в React-проектах. CX Codex +1 ★ 141звёзд репо data-attributes Правило data-attributes для Claude Code задаёт паттерны data-state и data-slot для стилизации состояний и связи компонентов. CX Codex +1 ★ 141звёзд репо principles Правило principles для Claude Code, Codex, Cursor, GitHub Copilot, Windsurf и Cline задаёт шесть критериев проектирования компонентов для оценки кода, рефакторинга и создания интерфейсов. CX Codex +1 ★ 141звёзд репо

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

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