architecture-compound-components — правило для Claude Code
Правило architecture-compound-components предлагает собирать сложные компоненты из частей с общим контекстом. Оно пригодится, когда монолитный компонент обрастает условиями и render props.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/architecture-compound-components.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/architecture-compound-components.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/architecture-compound-components.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/architecture-compound-components.mdВручную: положить файлы
.clinerules/architecture-compound-components.mdПо шагам, с командами для каждой платформы: 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