state-decouple-implementation — правило для Claude Code
Правило state-decouple-implementation для Claude Code: провайдер управляет стейтом, UI-компонент знает только интерфейс контекста. Одна смена провайдера — useState, Zustand или серверный sync — не трогает ни одного UI-компонента.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/state-decouple-implementation.mdЧто делает state-decouple-implementation
Правило задаёт архитектурный паттерн: логика управления состоянием живёт исключительно в провайдере, а UI-компоненты работают только через контекстный интерфейс. Компонент вроде ChannelComposer не знает, откуда берётся стейт — из локального useState, глобального Zustand или серверного синка.
Внутри правила — примеры на TSX: некорректный вариант, где UI-компонент напрямую вызывает useGlobalChannelState и useChannelSync, и правильный, где ChannelProvider инкапсулирует useGlobalChannel, а ChannelComposer только рендерит Composer.Frame. Показан и сценарий с двумя разными провайдерами — ForwardMessageProvider на локальном стейте и ChannelProvider на глобальном — при одном общем Composer.Input.
Правило устанавливается копированием файла в .claude/rules/state-decouple-implementation.md. Claude Code начнёт применять его при генерации и ревью кода с React-компонентами. Если в проекте UI-компоненты уже напрямую импортируют хуки Zustand или Redux, агент будет предлагать рефакторинг через провайдер.
Какие задачи решает
- вынести управление стейтом из UI-компонента в провайдер
- поменять Zustand на серверный sync без правки компонентов формы
- переиспользовать
Composer.Inputс разными источниками данных - проверить на код-ревью, не утекает ли реализация стейта в UI-слой
- задать агенту архитектурное правило для новых React-компонентов
Примеры запросов агенту
- Отрефактори
ChannelComposer— вынеси весь стейт в отдельный провайдер по правилуstate-decouple-implementation - Сгенерируй
ForwardMessageProviderс локальнымuseStateтак, чтобыComposer.Inputне менялся - Проверь компоненты в
src/features/chat— не вызывают ли они хуки Zustand напрямую
Как установить state-decouple-implementation
Вручную: положить файлы
.claude/rules/state-decouple-implementation.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/state-decouple-implementation.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/state-decouple-implementation.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/state-decouple-implementation.mdВручную: положить файлы
.clinerules/state-decouple-implementation.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о state-decouple-implementation
Как установить state-decouple-implementation в Claude Code?
Скопируйте файл правила в корень проекта по пути .claude/rules/state-decouple-implementation.md. Claude Code подхватит его автоматически при следующем запуске в этом проекте.
Что делает правило state-decouple-implementation?
Оно запрещает UI-компонентам знать о реализации стейта. Провайдер скрывает useState, Zustand или серверный sync за единым контекстным интерфейсом, поэтому UI не меняется при смене источника данных.
Работает ли правило с любым менеджером состояния?
Да — именно в этом смысл паттерна. Один и тот же UI-компонент работает с локальным useState в ForwardMessageProvider и с глобальным useGlobalChannel в ChannelProvider, потому что оба провайдера передают одинаковый контекстный интерфейс.
Исходный текст
state-decouple-implementation.md · MIT
---
title: Decouple State Management from UI
impact: MEDIUM
impactDescription: enables swapping state implementations without changing UI
tags: composition, state, architecture
---
## Decouple State Management from UI
The provider component should be the only place that knows how state is managed.
UI components consume the context interface—they don't know if state comes from
useState, Zustand, or a server sync.
**Incorrect (UI coupled to state implementation):**
```tsx
function ChannelComposer({ channelId }: { channelId: string }) {
// UI component knows about global state implementation
const state = useGlobalChannelState(channelId)
const { submit, updateInput } = useChannelSync(channelId)
return (
<Composer.Frame>
<Composer.Input
value={state.input}
onChange={(text) => sync.updateInput(text)}
/>
<Composer.Submit onPress={() => sync.submit()} />
</Composer.Frame>
)
}
```
**Correct (state management isolated in provider):**
```tsx
// Provider handles all state management details
function ChannelProvider({
channelId,
children,
}: {
channelId: string
children: React.ReactNode
}) {
const { state, update, submit } = useGlobalChannel(channelId)
const inputRef = useRef(null)
return (
<Composer.Provider
state={state}
actions={{ update, submit }}
meta={{ inputRef }}
>
{children}
</Composer.Provider>
)
}
// UI component only knows about the context interface
function ChannelComposer() {
return (
<Composer.Frame>
<Composer.Header />
<Composer.Input />
<Composer.Footer>
<Composer.Submit />
</Composer.Footer>
</Composer.Frame>
)
}
// Usage
function Channel({ channelId }: { channelId: string }) {
return (
<ChannelProvider channelId={channelId}>
<ChannelComposer />
</ChannelProvider>
)
}
```
**Different providers, same UI:**
```tsx
// Local state for ephemeral forms
function ForwardMessageProvider({ children }) {
const [state, setState] = useState(initialState)
const forwardMessage = useForwardMessage()
return (
<Composer.Provider
state={state}
actions={{ update: setState, submit: forwardMessage }}
>
{children}
</Composer.Provider>
)
}
// Global synced state for channels
function ChannelProvider({ channelId, children }) {
const { state, update, submit } = useGlobalChannel(channelId)
return (
<Composer.Provider state={state} actions={{ update, submit }}>
{children}
</Composer.Provider>
)
}
```
The same `Composer.Input` component works with both providers because it only
depends on the context interface, not the implementation.
© tech-leads-club · MIT · tech-leads-club/agent-skills