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

patterns-explicit-variants — правило для Claude Code: явные варианты

Правило patterns-explicit-variants требует собирать каждый режим компонента отдельным компонентом вместо набора булевых пропсов. По вызову сразу видно, что отрисуется.

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

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

Что делает patterns-explicit-variants

Правило разбирает частый случай: один компонент через булевы пропсы превращается в несколько разных режимов. Вместо этого предлагается отдельный компонент на каждый режим. В примере из файла Composer с флагами isThread, isEditing и showAttachments заменяется на ThreadComposer, EditMessageComposer и ForwardMessageComposer.

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

Файл кладут в .claude/rules/, это markdown-документ, а не скрипт, поэтому проверки за ним нет: сработает, только если модель реально прочитает правило в контексте. Старые компоненты с десятком булевых пропсов сами не перепишутся, рефакторить придётся руками.

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

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

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

  • Этот Composer оброс флагами isThread, isEditing и showAttachments. Разнеси его на явные варианты по правилу patterns-explicit-variants.
  • Сделай отдельные компоненты для ветки, редактирования и пересылки сообщения, а общие части оставь в Composer.Frame.
  • Проверь новые компоненты: не осталось ли булевых пропсов, которые переключают режим.

Как установить patterns-explicit-variants

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

.claude/rules/patterns-explicit-variants.md

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

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

Вопросы о patterns-explicit-variants

Как установить patterns-explicit-variants в Claude Code?

Скопируйте файл правила в проект по пути .claude/rules/patterns-explicit-variants.md.

Что делает patterns-explicit-variants?

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

Чем явные варианты отличаются от одного компонента с флагами?

В варианте сразу видно провайдер, состав интерфейса и доступные действия. Комбинаций пропсов, дающих недостижимое состояние, там просто нет.

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

patterns-explicit-variants.md · MIT
---
title: Create Explicit Component Variants
impact: MEDIUM
impactDescription: self-documenting code, no hidden conditionals
tags: composition, variants, architecture
---

## Create Explicit Component Variants

Instead of one component with many boolean props, create explicit variant
components. Each variant composes the pieces it needs. The code documents
itself.

**Incorrect (one component, many modes):**

```tsx
// What does this component actually render?
<Composer
  isThread
  isEditing={false}
  channelId='abc'
  showAttachments
  showFormatting={false}
/>
```

**Correct (explicit variants):**

```tsx
// Immediately clear what this renders
<ThreadComposer channelId="abc" />

// Or
<EditMessageComposer messageId="xyz" />

// Or
<ForwardMessageComposer messageId="123" />
```

Each implementation is unique, explicit and self-contained. Yet they can each
use shared parts.

**Implementation:**

```tsx
function ThreadComposer({ channelId }: { channelId: string }) {
  return (
    <ThreadProvider channelId={channelId}>
      <Composer.Frame>
        <Composer.Input />
        <AlsoSendToChannelField channelId={channelId} />
        <Composer.Footer>
          <Composer.Formatting />
          <Composer.Emojis />
          <Composer.Submit />
        </Composer.Footer>
      </Composer.Frame>
    </ThreadProvider>
  )
}

function EditMessageComposer({ messageId }: { messageId: string }) {
  return (
    <EditMessageProvider messageId={messageId}>
      <Composer.Frame>
        <Composer.Input />
        <Composer.Footer>
          <Composer.Formatting />
          <Composer.Emojis />
          <Composer.CancelEdit />
          <Composer.SaveEdit />
        </Composer.Footer>
      </Composer.Frame>
    </EditMessageProvider>
  )
}

function ForwardMessageComposer({ messageId }: { messageId: string }) {
  return (
    <ForwardMessageProvider messageId={messageId}>
      <Composer.Frame>
        <Composer.Input placeholder="Add a message, if you'd like." />
        <Composer.Footer>
          <Composer.Formatting />
          <Composer.Emojis />
          <Composer.Mentions />
        </Composer.Footer>
      </Composer.Frame>
    </ForwardMessageProvider>
  )
}
```

Each variant is explicit about:

- What provider/state it uses
- What UI elements it includes
- What actions are available

No boolean prop combinations to reason about. No impossible states.

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

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

Все правила IDE по теме «Фронтенд и UI» →
vercel-composition-patterns vercel Скилл vercel-composition-patterns для Claude Code задаёт правила перехода от Boolean props к compound components и общему контексту в React. CX Codex +1 464 000установок react-composition-patterns vercel Скилл react-composition-patterns для Claude Code задаёт правила композиции React-компонентов: помогает заменять булевы пропсы составными компонентами и выносить состояние в провайдеры. CX Codex +1 502установок react-patterns jezweb Скилл react-patterns для Claude Code проверяет компоненты React 19 на водопады, размер бандла и лишние ререндеры, предлагая исправления композиции. Используется при написании, ревью и рефакторинге кода. CX Codex +1 1 300установок shadcn-component-boundaries purrfold Скилл shadcn-component-boundaries задаёт правила размещения UI-компонентов в проектах с shadcn. Изолирует примитивы реестра от продуктового кода и следит за односторонними импортами. CX Codex +1 5 700установок composition maxtrigify Правило composition для Claude Code помогает разбивать крупные UI-компоненты на небольшие субагенты с четкими задачами. Оно применяется при проектировании библиотек и сложных интерфейсов. CX Codex +1 ★ 141звёзд репо react-composition-2026 patterns.dev Скилл react-composition-2026 учит агента заменять булевы пропсы и жёсткие API компонентов на композицию: compound-компоненты, явные варианты, children вместо render props. CX Codex +1 1 200установок

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

Весь набор →
server-cache-react Правило server-cache-react учит ассистента мемоизировать серверные запросы через React.cache() и избегать повторных обращений к базе данных. CX Codex +1 ★ 7 191звёзд репо architecture-avoid-boolean-props Правило architecture-avoid-boolean-props запрещает раздувать компоненты булевыми пропсами и предлагает собирать варианты через композицию. Пригодится при проектировании React-компонентов. CX Codex +1 ★ 7 191звёзд репо 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звёзд репо async-suspense-boundaries Правило async-suspense-boundaries направляет Claude Code выносить загрузку данных в отдельные компоненты с Suspense, чтобы каркас страницы рендерился без задержек. CX Codex +1 ★ 7 191звёзд репо architecture-compound-components Правило architecture-compound-components предлагает собирать сложные компоненты из частей с общим контекстом. Оно пригодится, когда монолитный компонент обрастает условиями и render props. 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звёзд репо

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

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