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