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

architecture-compound-components — правило для Claude Code

Правило architecture-compound-components предлагает собирать сложные компоненты из частей с общим контекстом. Оно пригодится, когда монолитный компонент обрастает условиями и render props.

MIT ★ 7 191 обновлён 2026-10-24

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

Что делает architecture-compound-components

Сложный компонент делится на Provider, Frame и самостоятельные части: например, Input, Submit и Footer. Части читают общее состояние и вызывают действия через контекст, а не получают их через props. Так потребитель выбирает нужный состав без скрытых условий.

Родительский Provider передаёт состояние, действия и метаданные. Это позволяет использовать одну структуру компонента с разными наборами зависимостей. Если части должны работать с общим состоянием, его нужно передать Provider.

Пример в правиле показывает Composer на React и TypeScript: поле ввода обновляет состояние через действие, а кнопка вызывает отправку. Установка для Claude Code — добавить файл правила в .claude/rules/architecture-compound-components.md.

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

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

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

  • Перестрой компонент Composer на составные части с общим контекстом.
  • Замени флаги и функции рендеринга в компоненте на Provider, Frame, Input и Footer.
  • Покажи, как передать состояние и действия через Provider и собрать форму из нужных частей.

Как установить architecture-compound-components

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

.claude/rules/architecture-compound-components.md

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

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

Вопросы об architecture-compound-components

Как установить architecture-compound-components в Claude Code?

Добавьте правило по пути .claude/rules/architecture-compound-components.md.

Что делает architecture-compound-components?

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

Как компоненты получают состояние и действия?

Родительский Provider передаёт состояние, действия и метаданные через общий контекст. Части обращаются к контексту, а не получают эти значения через props.

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

architecture-compound-components.md · MIT
---
title: Use Compound Components
impact: HIGH
impactDescription: enables flexible composition without prop drilling
tags: composition, compound-components, architecture
---

## Use Compound Components

Structure complex components as compound components with a shared context. Each
subcomponent accesses shared state via context, not props. Consumers compose the
pieces they need.

**Incorrect (monolithic component with render props):**

```tsx
function Composer({
  renderHeader,
  renderFooter,
  renderActions,
  showAttachments,
  showFormatting,
  showEmojis,
}: Props) {
  return (
    <form>
      {renderHeader?.()}
      <Input />
      {showAttachments && <Attachments />}
      {renderFooter ? (
        renderFooter()
      ) : (
        <Footer>
          {showFormatting && <Formatting />}
          {showEmojis && <Emojis />}
          {renderActions?.()}
        </Footer>
      )}
    </form>
  )
}
```

**Correct (compound components with shared context):**

```tsx
const ComposerContext = createContext<ComposerContextValue | null>(null)

function ComposerProvider({ children, state, actions, meta }: ProviderProps) {
  return (
    <ComposerContext value={{ state, actions, meta }}>
      {children}
    </ComposerContext>
  )
}

function ComposerFrame({ children }: { children: React.ReactNode }) {
  return <form>{children}</form>
}

function ComposerInput() {
  const {
    state,
    actions: { update },
    meta: { inputRef },
  } = use(ComposerContext)
  return (
    <TextInput
      ref={inputRef}
      value={state.input}
      onChangeText={(text) => update((s) => ({ ...s, input: text }))}
    />
  )
}

function ComposerSubmit() {
  const {
    actions: { submit },
  } = use(ComposerContext)
  return <Button onPress={submit}>Send</Button>
}

// Export as compound component
const Composer = {
  Provider: ComposerProvider,
  Frame: ComposerFrame,
  Input: ComposerInput,
  Submit: ComposerSubmit,
  Header: ComposerHeader,
  Footer: ComposerFooter,
  Attachments: ComposerAttachments,
  Formatting: ComposerFormatting,
  Emojis: ComposerEmojis,
}
```

**Usage:**

```tsx
<Composer.Provider state={state} actions={actions} meta={meta}>
  <Composer.Frame>
    <Composer.Header />
    <Composer.Input />
    <Composer.Footer>
      <Composer.Formatting />
      <Composer.Submit />
    </Composer.Footer>
  </Composer.Frame>
</Composer.Provider>
```

Consumers explicitly compose exactly what they need. No hidden conditionals. And the state, actions and meta are dependency-injected by a parent provider, allowing multiple usages of the same component structure.

© tech-leads-club · MIT · tech-leads-club/agent-skills

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

Все правила IDE по теме «Фронтенд и UI» →
design-system-compound-components alexj11324 Правило design-system-compound-components для Claude Code запрещает передавать строки в невизуальные узлы без текстовой обёртки. Направляет агента делить интерфейс на составные элементы вроде ButtonText. CX Codex +1 ★ 88звёзд репо compound-pattern patterns.dev Скилл compound-pattern для Claude Code: учит агента собирать составные компоненты с общим неявным состоянием — табы, аккордеоны, выпадающие меню. Подкомпоненты согласовывают поведение без прокидывания пропсов. CX Codex +1 1 100установок sort-components rerun-build Скилл sort-components для Claude Code распределяет UI-компоненты по папкам по их назначению. Активируется при добавлении компонента или пересортировке apps/ui/components/. CX Codex +1 ★ 1 120звёзд репо components-build components.build Скилл components-build для Claude Code помогает создавать, проверять и перерабатывать переиспользуемые компоненты React по спецификации components.build. Он подключается к задачам об API компонентов, доступности, стилях и типах TypeScript. CX Codex +1 ★ 141звёзд репо react-component-architecture aj-geddes Скилл react-component-architecture для Claude Code задаёт агенту правила проектирования React-компонентов: функциональные компоненты, хуки, композиция и TypeScript. Держит библиотеку переиспользуемых компонентов в едином стиле. CX Codex +1 687установок building-components vercel Скилл building-components помогает проектировать доступные UI-компоненты, их API, темы и документацию. CX Codex +1 15 400установок

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

Весь набор →
rendering-hydration-no-flicker Правило rendering-hydration-no-flicker учит агента читать локальное хранилище без ошибок серверного рендеринга и без мигания интерфейса до гидратации. CX Codex +1 ★ 7 191звёзд репо bundle-barrel-imports Правило bundle-barrel-imports для Claude Code подсказывает импортировать модули напрямую, а не через barrel-файлы. Указывает прямые пути модулей в React-пакетах и библиотеках с большим числом реэкспортов. CX Codex +1 ★ 7 191звёзд репо patterns-explicit-variants Правило patterns-explicit-variants требует собирать каждый режим компонента отдельным компонентом вместо набора булевых пропсов. По вызову сразу видно, что отрисуется. CX Codex +1 ★ 7 191звёзд репо async-suspense-boundaries Правило async-suspense-boundaries направляет Claude Code выносить загрузку данных в отдельные компоненты с Suspense, чтобы каркас страницы рендерился без задержек. CX Codex +1 ★ 7 191звёзд репо state-decouple-implementation Правило state-decouple-implementation для Claude Code: провайдер управляет стейтом, UI-компонент знает только интерфейс контекста. Одна смена провайдера — useState, Zustand или серверный sync — не трогает ни одного UI-компонента. CX Codex +1 ★ 7 191звёзд репо rerender-functional-setstate Правило rerender-functional-setstate подсказывает использовать функциональное обновление React-состояния, когда новое значение зависит от текущего. Это помогает избежать устаревших замыканий в обработчиках. CX Codex +1 ★ 7 191звёзд репо state-lift-state Правило state-lift-state учит выносить состояние React в компонент-провайдер, чтобы соседние компоненты вне основного UI читали и меняли его без пропсов и ref. CX Codex +1 ★ 7 191звёзд репо js-batch-dom-css Правило js-batch-dom-css запрещает чередовать чтение геометрии DOM с записью стилей. Защищает код от синхронного reflow и просадок FPS при анимациях. CX Codex +1 ★ 7 191звёзд репо

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

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