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