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

state-decouple-implementation — правило для Claude Code

Правило state-decouple-implementation для Claude Code: провайдер управляет стейтом, UI-компонент знает только интерфейс контекста. Одна смена провайдера — useState, Zustand или серверный sync — не трогает ни одного UI-компонента.

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

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

Что делает 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 и 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

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

Все правила IDE по теме «Фронтенд и UI» →
zustand-state-management Mindrally Скилл zustand-state-management задаёт правила архитектуры сторов Zustand в React и TypeScript: от нарезки слайсов до SSR и тестов. Помогает избежать лишних ререндеров и ошибок гидратации. CX Codex +1 1 000установок react-state-fallback alexj11324 Правило react-state-fallback для Claude Code настраивает работу с состоянием через резервные значения. Модель перестаёт копировать пропсы в useState и сохраняет реактивность. CX Codex +1 ★ 88звёзд репо state-management agent-skills Скилл state-management для Claude Code помогает настраивать загрузку данных, кэширование и клиентское состояние через React Query и Zustand. Активируется при работе с useQuery, useMutation и хранилищами Zustand. CX Codex +1 849установок frontend-state-management aj-geddes Скилл frontend-state-management для работы с состоянием фронтенда: подсказывает, как организовать Redux, MobX, Zustand или Context API в приложении. CX Codex +1 487установок zustand-state-builder patricio0312rev Скилл zustand-state-builder для Claude Code управляет состоянием приложения через Zustand: лёгкий API, TypeScript, сохранение в хранилище и devtools. CX Codex +1 264установок legend-state-best-practices LegendApp Скилл legend-state-best-practices задаёт правила работы с @legendapp/state: где хранить состояние, как подписываться и что делать с персистентностью. Пригодится при рефакторинге и аудите реактивного кода. CX Codex +1 490установок

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

Весь набор →
bundle-barrel-imports Правило bundle-barrel-imports для Claude Code подсказывает импортировать модули напрямую, а не через barrel-файлы. Указывает прямые пути модулей в React-пакетах и библиотеках с большим числом реэкспортов. CX Codex +1 ★ 7 191звёзд репо patterns-explicit-variants Правило patterns-explicit-variants требует собирать каждый режим компонента отдельным компонентом вместо набора булевых пропсов. По вызову сразу видно, что отрисуется. 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звёзд репо rerender-functional-setstate Правило rerender-functional-setstate подсказывает использовать функциональное обновление React-состояния, когда новое значение зависит от текущего. Это помогает избежать устаревших замыканий в обработчиках. CX Codex +1 ★ 7 191звёзд репо state-lift-state Правило state-lift-state учит выносить состояние React в компонент-провайдер, чтобы соседние компоненты вне основного UI читали и меняли его без пропсов и ref. CX Codex +1 ★ 7 191звёзд репо js-batch-dom-css Правило js-batch-dom-css запрещает чередовать чтение геометрии DOM с записью стилей. Защищает код от синхронного reflow и просадок FPS при анимациях. CX Codex +1 ★ 7 191звёзд репо docs-writer Скилл docs-writer для Claude Code пишет, редактирует и проверяет документацию в проекте. Работает с README, Markdown-файлами и страницами docs/. CX Codex +1 ★ 7 191звёзд репо

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

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