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

state-context-interface — правило для Claude Code

Правило state-context-interface для Claude Code: отделяет интерфейс компонентов от источника состояния через контекст с частями state, actions и meta. Один UI подключается к разным провайдерам состояния.

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

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

Что делает state-context-interface

Правило предлагает описывать контекст компонента общим интерфейсом из трёх частей: state, actions и meta. UI-компоненты обращаются к этому контракту, а не к конкретному хуку или хранилищу. Так один и тот же интерфейс можно подключить, например, к локальному состоянию формы или к синхронизированному глобальному состоянию канала.

Провайдер задаёт состояние, действия и метаданные, включая ссылку на поле ввода. Компоненты внутри границы провайдера могут читать состояние и вызывать действия, даже если визуально находятся за пределами Composer.Frame. Это правило для архитектуры React-компонентов; без провайдера, реализующего интерфейс, такой UI не получит нужный контекст.

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

  • отвязать UI-компонент от конкретного хука состояния
  • подключить один интерфейс к локальному и глобальному состоянию
  • вынести предпросмотр за пределы Composer.Frame, сохранив доступ к контексту
  • вызвать отправку из кнопки за пределами компоновщика

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

  • Спроектируй контекст компонента с частями state, actions и meta, чтобы UI не зависел от конкретного хука.
  • Переработай этот компонент так, чтобы локальный и глобальный провайдеры реализовывали один интерфейс.
  • Добавь предпросмотр сообщения вне Composer.Frame, сохранив доступ к состоянию провайдера.

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

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

.claude/rules/state-context-interface.md

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

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

Вопросы о state-context-interface

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

Добавьте файл правила по пути .claude/rules/state-context-interface.md. Разместите его в проекте, чтобы Claude Code мог применять правило.

Что делает state-context-interface?

Правило предлагает отделить интерфейс UI-компонентов от реализации состояния с помощью контекста, содержащего state, actions и meta. Разные провайдеры могут реализовать один контракт.

Могут ли компоненты за пределами Composer.Frame читать состояние?

Да. Компоненту достаточно находиться внутри границы провайдера, который предоставляет контекст; визуальная вложенность в Composer.Frame не обязательна.

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

state-context-interface.md · MIT
---
title: Define Generic Context Interfaces for Dependency Injection
impact: HIGH
impactDescription: enables dependency-injectable state across use-cases
tags: composition, context, state, typescript, dependency-injection
---

## Define Generic Context Interfaces for Dependency Injection

Define a **generic interface** for your component context with three parts:
`state`, `actions`, and `meta`. This interface is a contract that any provider
can implement—enabling the same UI components to work with completely different
state implementations.

**Core principle:** Lift state, compose internals, make state
dependency-injectable.

**Incorrect (UI coupled to specific state implementation):**

```tsx
function ComposerInput() {
  // Tightly coupled to a specific hook
  const { input, setInput } = useChannelComposerState()
  return <TextInput value={input} onChangeText={setInput} />
}
```

**Correct (generic interface enables dependency injection):**

```tsx
// Define a GENERIC interface that any provider can implement
interface ComposerState {
  input: string
  attachments: Attachment[]
  isSubmitting: boolean
}

interface ComposerActions {
  update: (updater: (state: ComposerState) => ComposerState) => void
  submit: () => void
}

interface ComposerMeta {
  inputRef: React.RefObject<TextInput>
}

interface ComposerContextValue {
  state: ComposerState
  actions: ComposerActions
  meta: ComposerMeta
}

const ComposerContext = createContext<ComposerContextValue | null>(null)
```

**UI components consume the interface, not the implementation:**

```tsx
function ComposerInput() {
  const {
    state,
    actions: { update },
    meta,
  } = use(ComposerContext)

  // This component works with ANY provider that implements the interface
  return (
    <TextInput
      ref={meta.inputRef}
      value={state.input}
      onChangeText={(text) => update((s) => ({ ...s, input: text }))}
    />
  )
}
```

**Different providers implement the same interface:**

```tsx
// Provider A: Local state for ephemeral forms
function ForwardMessageProvider({ children }: { children: React.ReactNode }) {
  const [state, setState] = useState(initialState)
  const inputRef = useRef(null)
  const submit = useForwardMessage()

  return (
    <ComposerContext
      value={{
        state,
        actions: { update: setState, submit },
        meta: { inputRef },
      }}
    >
      {children}
    </ComposerContext>
  )
}

// Provider B: Global synced state for channels
function ChannelProvider({ channelId, children }: Props) {
  const { state, update, submit } = useGlobalChannel(channelId)
  const inputRef = useRef(null)

  return (
    <ComposerContext
      value={{
        state,
        actions: { update, submit },
        meta: { inputRef },
      }}
    >
      {children}
    </ComposerContext>
  )
}
```

**The same composed UI works with both:**

```tsx
// Works with ForwardMessageProvider (local state)
<ForwardMessageProvider>
  <Composer.Frame>
    <Composer.Input />
    <Composer.Submit />
  </Composer.Frame>
</ForwardMessageProvider>

// Works with ChannelProvider (global synced state)
<ChannelProvider channelId="abc">
  <Composer.Frame>
    <Composer.Input />
    <Composer.Submit />
  </Composer.Frame>
</ChannelProvider>
```

**Custom UI outside the component can access state and actions:**

The provider boundary is what matters—not the visual nesting. Components that
need shared state don't have to be inside the `Composer.Frame`. They just need
to be within the provider.

```tsx
function ForwardMessageDialog() {
  return (
    <ForwardMessageProvider>
      <Dialog>
        {/* The composer UI */}
        <Composer.Frame>
          <Composer.Input placeholder="Add a message, if you'd like." />
          <Composer.Footer>
            <Composer.Formatting />
            <Composer.Emojis />
          </Composer.Footer>
        </Composer.Frame>

        {/* Custom UI OUTSIDE the composer, but INSIDE the provider */}
        <MessagePreview />

        {/* Actions at the bottom of the dialog */}
        <DialogActions>
          <CancelButton />
          <ForwardButton />
        </DialogActions>
      </Dialog>
    </ForwardMessageProvider>
  )
}

// This button lives OUTSIDE Composer.Frame but can still submit based on its context!
function ForwardButton() {
  const {
    actions: { submit },
  } = use(ComposerContext)
  return <Button onPress={submit}>Forward</Button>
}

// This preview lives OUTSIDE Composer.Frame but can read composer's state!
function MessagePreview() {
  const { state } = use(ComposerContext)
  return <Preview message={state.input} attachments={state.attachments} />
}
```

The `ForwardButton` and `MessagePreview` are not visually inside the composer
box, but they can still access its state and actions. This is the power of
lifting state into providers.

The UI is reusable bits you compose together. The state is dependency-injected
by the provider. Swap the provider, keep the UI.

© tech-leads-club · MIT · tech-leads-club/agent-skills

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

Все правила IDE по теме «Фронтенд и UI» →
better-interface jakubkrehel Скилл better-interface для Claude Code собирает аудит интерфейса по семи направлениям: от вёрстки и текста до доступности и цвета. Результаты сводятся в единый ранжированный отчёт. CX Codex +1 39 600установок interface-design Dammyjay93 Скилл interface-design для Claude Code проектирует интерфейсы дашбордов, админок, SaaS-приложений и инструментов с проработкой уровня Linear или Vercel. Включается при разработке, ревью или аудите UI продукта. CX Codex +1 34 300установок interface-review jakubkrehel Скилл interface-review для Claude Code проверяет ветку, PR или локальные правки на регрессии в интерфейсе. Запускается перед отправкой изменений в репозиторий. CX Codex +1 26 900установок interface-kit JuliusBrussee Скилл interface-kit для Claude Code, Codex и других ИИ-агентов: задаёт приоритеты при верстке интерфейсов — доступность, типографика, анимация, цветовые системы. Активируется на задачах фронтенда и полировки UI. CX Codex +1 2 400установок build-review-interface ai-evals-course Скилл build-review-interface создаёт браузерный интерфейс для разметки трейсов LLM с сохранением в JSON, CSV или SQLite. Пригодится при сборе человеческой обратной связи и оценке моделей. CX Codex +1 1 100установок reviewing-interface-quality osmontero Скилл reviewing-interface-quality аудитирует готовый интерфейс по скриншотам, стилям и поведению. Нужен перед релизом или когда страница выглядит незавершённой. CX Codex +1 451установок

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

Весь набор →
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звёзд репо nx-workspace Скилл nx-workspace для работы с Nx-монорепозиторием из CLI: список проектов, полная конфигурация, поиск затронутых проектов и affected-команды в CI. CX Codex +1 ★ 7 191звёзд репо perf-web-optimization Скилл perf-web-optimization помогает оптимизировать загрузку веб-страниц: настраивает отложенную загрузку, сокращает размер бандла и выставляет кэш. Пригодится при медленной работе сайта или тяжёлом JS. CX Codex +1 ★ 7 191звёзд репо learning-opportunities Скилл learning-opportunities предлагает короткие учебные упражнения после архитектурной работы в Claude, чтобы код, который написал агент, не остался для вас чёрным ящиком. CX Codex +1 ★ 7 191звёзд репо confluence-assistant Скилл confluence-assistant учит агента работать с Confluence через Atlassian MCP. Помогает искать страницы поиском Rovo, создавать новые записи в разметке Markdown и обновлять документацию прямо из чата. CX Codex +1 ★ 7 191звёзд репо security-threat-model Скилл security-threat-model строит модель угроз по коду репозитория: находит границы доверия, активы и реалистичные пути атаки, а результат сохраняет в Markdown-файл. CX Codex +1 ★ 7 191звёзд репо modular-decomposition Скилл modular-decomposition проводит монолит через пять шагов анализа перед разбивкой на модули: размер и инвентаризация компонентов, дублирование логики, иерархия, связность, группировка по доменам. CX Codex +1 ★ 7 191звёзд репо

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

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