architecture-avoid-boolean-props — правило для Claude Code
Правило architecture-avoid-boolean-props запрещает раздувать компоненты булевыми пропсами и предлагает собирать варианты через композицию. Пригодится при проектировании React-компонентов.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/architecture-avoid-boolean-props.mdЧто делает architecture-avoid-boolean-props
Правило просит не добавлять пропсы вроде isThread, isEditing и isDMThread, чтобы переключать поведение компонента. Каждый новый boolean увеличивает число возможных состояний и усложняет условную логику. Вместо одного монолитного компонента варианты нужно оформлять отдельными композициями.
В примерах общий Composer собирается из частей: Frame, Header, Input, Footer и отдельных действий. ChannelComposer, ThreadComposer и EditComposer явно задают собственную разметку, при этом внутренние элементы остаются общими. Такой подход убирает вложенные проверки и делает состав каждого варианта видимым.
Без композиции компонент быстро обрастает взаимоисключающими флагами, поэтому правило особенно жёстко относится к boolean-пропсам в архитектуре интерфейса.
Какие задачи решает
- убрать boolean-пропсы из компонента
- разделить варианты интерфейса на композиции
- сократить вложенные условные ветки
- явно описать состав каждого состояния
Примеры запросов агенту
- Проверь
Composerи убери из него пропсыisThread,isEditingиisDMThread. - Перепиши варианты
ChannelComposer,ThreadComposerиEditComposerчерез композицию. - Найди в компоненте взаимоисключающие boolean-пропсы и предложи структуру без условных переключателей.
Как установить architecture-avoid-boolean-props
Вручную: положить файлы
.claude/rules/architecture-avoid-boolean-props.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/architecture-avoid-boolean-props.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/architecture-avoid-boolean-props.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/architecture-avoid-boolean-props.mdВручную: положить файлы
.clinerules/architecture-avoid-boolean-props.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об architecture-avoid-boolean-props
Как установить architecture-avoid-boolean-props в Claude Code?
Скопируйте правило в .claude/rules/architecture-avoid-boolean-props.md.
Что делает architecture-avoid-boolean-props?
Правило помогает не настраивать компонент набором boolean-пропсов. Оно предлагает собирать отдельные варианты через общие композиционные части.
Почему boolean-пропсы создают проблему в компонентах?
Каждый такой пропс увеличивает число возможных состояний. В результате условная логика становится сложной для поддержки, особенно когда флаги взаимоисключают друг друга.
Исходный текст
architecture-avoid-boolean-props.md · MIT
---
title: Avoid Boolean Prop Proliferation
impact: CRITICAL
impactDescription: prevents unmaintainable component variants
tags: composition, props, architecture
---
## Avoid Boolean Prop Proliferation
Don't add boolean props like `isThread`, `isEditing`, `isDMThread` to customize
component behavior. Each boolean doubles possible states and creates
unmaintainable conditional logic. Use composition instead.
**Incorrect (boolean props create exponential complexity):**
```tsx
function Composer({
onSubmit,
isThread,
channelId,
isDMThread,
dmId,
isEditing,
isForwarding,
}: Props) {
return (
<form>
<Header />
<Input />
{isDMThread ? (
<AlsoSendToDMField id={dmId} />
) : isThread ? (
<AlsoSendToChannelField id={channelId} />
) : null}
{isEditing ? (
<EditActions />
) : isForwarding ? (
<ForwardActions />
) : (
<DefaultActions />
)}
<Footer onSubmit={onSubmit} />
</form>
)
}
```
**Correct (composition eliminates conditionals):**
```tsx
// Channel composer
function ChannelComposer() {
return (
<Composer.Frame>
<Composer.Header />
<Composer.Input />
<Composer.Footer>
<Composer.Attachments />
<Composer.Formatting />
<Composer.Emojis />
<Composer.Submit />
</Composer.Footer>
</Composer.Frame>
)
}
// Thread composer - adds "also send to channel" field
function ThreadComposer({ channelId }: { channelId: string }) {
return (
<Composer.Frame>
<Composer.Header />
<Composer.Input />
<AlsoSendToChannelField id={channelId} />
<Composer.Footer>
<Composer.Formatting />
<Composer.Emojis />
<Composer.Submit />
</Composer.Footer>
</Composer.Frame>
)
}
// Edit composer - different footer actions
function EditComposer() {
return (
<Composer.Frame>
<Composer.Input />
<Composer.Footer>
<Composer.Formatting />
<Composer.Emojis />
<Composer.CancelEdit />
<Composer.SaveEdit />
</Composer.Footer>
</Composer.Frame>
)
}
```
Each variant is explicit about what it renders. We can share internals without
sharing a single monolithic parent.
© tech-leads-club · MIT · tech-leads-club/agent-skills