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

state-lift-state — правило для Claude Code: состояние в провайдер

Правило state-lift-state учит выносить состояние React в компонент-провайдер, чтобы соседние компоненты вне основного UI читали и меняли его без пропсов и ref.

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

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

Что делает state-lift-state

Правило требует переносить состояние в отдельный компонент-провайдер. Тогда соседние компоненты вне основного UI читают и меняют его без проброса пропсов и без ссылок через ref. Пример — диалог пересылки: поле ввода живёт в ForwardMessageComposer, а кнопке ForwardButton нужно вызвать actions.submit.

В файле разобраны три тупика: состояние заперто внутри компонента, useEffect синхронизирует его наверх при каждом изменении, а на отправке состояние достают из ref. Вместо этого ForwardMessageProvider держит useState, useForwardMessage и inputRef и отдаёт их через Composer.Provider в state, actions и meta.

Главное: общий контекст видят только компоненты внутри одного провайдера. Кнопка может стоять в другой ветке дерева — это нормально, а вот без провайдера-родителя она контекст не получит.

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

  • Вынести состояние формы в провайдер, чтобы кнопки в другом конце дерева вызвали отправку
  • Убрать useEffect, который гоняет каждое изменение поля наверх в родителя
  • Отказаться от чтения состояния из ref в момент submit
  • Показать на ревью, почему пропсы и рефы не тянут общий стейт диалога

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

  • Отрефакторь ForwardMessageDialog: вынеси состояние в ForwardMessageProvider, а ForwardButton пусть берёт actions.submit из Composer.Context
  • Убери useEffect с onInputChange в ForwardMessageComposer и отдай состояние через провайдер
  • Проверь этот диалог по правилу state-lift-state и перепиши те места, где состояние заперто внутри компонента

Как установить state-lift-state

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

.claude/rules/state-lift-state.md

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

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

Вопросы о state-lift-state

Как установить state-lift-state в Claude Code?

Положите файл правила в проекте по пути .claude/rules/state-lift-state.md.

Что делает state-lift-state?

Описывает перенос состояния в компонент-провайдер: три неверных подхода и рабочий пример с Composer.Provider, где состояние, действия и мета отдаются наружу.

Почему не синхронизировать состояние наверх через useEffect?

Эффект прогоняет каждое изменение через родителя. Провайдер держит состояние один раз, и компоненты берут его из контекста.

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

state-lift-state.md · MIT
---
title: Lift State into Provider Components
impact: HIGH
impactDescription: enables state sharing outside component boundaries
tags: composition, state, context, providers
---

## Lift State into Provider Components

Move state management into dedicated provider components. This allows sibling
components outside the main UI to access and modify state without prop drilling
or awkward refs.

**Incorrect (state trapped inside component):**

```tsx
function ForwardMessageComposer() {
  const [state, setState] = useState(initialState)
  const forwardMessage = useForwardMessage()

  return (
    <Composer.Frame>
      <Composer.Input />
      <Composer.Footer />
    </Composer.Frame>
  )
}

// Problem: How does this button access composer state?
function ForwardMessageDialog() {
  return (
    <Dialog>
      <ForwardMessageComposer />
      <MessagePreview /> {/* Needs composer state */}
      <DialogActions>
        <CancelButton />
        <ForwardButton /> {/* Needs to call submit */}
      </DialogActions>
    </Dialog>
  )
}
```

**Incorrect (useEffect to sync state up):**

```tsx
function ForwardMessageDialog() {
  const [input, setInput] = useState('')
  return (
    <Dialog>
      <ForwardMessageComposer onInputChange={setInput} />
      <MessagePreview input={input} />
    </Dialog>
  )
}

function ForwardMessageComposer({ onInputChange }) {
  const [state, setState] = useState(initialState)
  useEffect(() => {
    onInputChange(state.input) // Sync on every change 😬
  }, [state.input])
}
```

**Incorrect (reading state from ref on submit):**

```tsx
function ForwardMessageDialog() {
  const stateRef = useRef(null)
  return (
    <Dialog>
      <ForwardMessageComposer stateRef={stateRef} />
      <ForwardButton onPress={() => submit(stateRef.current)} />
    </Dialog>
  )
}
```

**Correct (state lifted to provider):**

```tsx
function ForwardMessageProvider({ children }: { children: React.ReactNode }) {
  const [state, setState] = useState(initialState)
  const forwardMessage = useForwardMessage()
  const inputRef = useRef(null)

  return (
    <Composer.Provider
      state={state}
      actions={{ update: setState, submit: forwardMessage }}
      meta={{ inputRef }}
    >
      {children}
    </Composer.Provider>
  )
}

function ForwardMessageDialog() {
  return (
    <ForwardMessageProvider>
      <Dialog>
        <ForwardMessageComposer />
        <MessagePreview /> {/* Custom components can access state and actions */}
        <DialogActions>
          <CancelButton />
          <ForwardButton /> {/* Custom components can access state and actions */}
        </DialogActions>
      </Dialog>
    </ForwardMessageProvider>
  )
}

function ForwardButton() {
  const { actions } = use(Composer.Context)
  return <Button onPress={actions.submit}>Forward</Button>
}
```

The ForwardButton lives outside the Composer.Frame but still has access to the
submit action because it's within the provider. Even though it's a one-off
component, it can still access the composer's state and actions from outside the
UI itself.

**Key insight:** Components that need shared state don't have to be visually
nested inside each other—they just need to be within the same provider.

© 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установок legend-state-best-practices LegendApp Скилл legend-state-best-practices задаёт правила работы с @legendapp/state: где хранить состояние, как подписываться и что делать с персистентностью. Пригодится при рефакторинге и аудите реактивного кода. CX Codex +1 490установок state-management statelyai Скилл state-management для Claude Code моделирует состояние приложения до выбора библиотеки. Проверяет и рефакторит модели, сокращает исходные данные и устраняет невозможные состояния. CX Codex +1 181установок react-state-fallback alexj11324 Правило react-state-fallback для Claude Code настраивает работу с состоянием через резервные значения. Модель перестаёт копировать пропсы в useState и сохраняет реактивность. CX Codex +1 ★ 88звёзд репо 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установок

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

Весь набор →
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звёзд репо 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звёзд репо perf-astro Скилл perf-astro для Claude Code настраивает сборку Astro: встраивает критический CSS, минифицирует файлы, задаёт неблокирующую загрузку шрифтов и preload LCP-картинки. CX Codex +1 ★ 7 191звёзд репо tactical-ddd Скилл tactical-ddd находит анемичные доменные модели и переводит их в богатые сущности по правилам тактического DDD. Он проверяет инкапсуляцию и готовит пошаговый рефакторинг для Claude Code. CX Codex +1 ★ 7 191звёзд репо

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

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