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

state-ground-truth — правило для Claude Code: состояние, а не визуал

Правило state-ground-truth, которое запрещает хранить в состоянии производные визуальные значения. Учит агента разделять факт и его отображение.

MIT ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings
Открыть на GitHub

Что делает state-ground-truth

Правило state-ground-truth заставляет агента хранить в useState и Reanimated shared values только фактическое состояние: нажато, открыто, прогресс. Визуальные значения — scale, opacity, translateY — должны вычисляться из этого состояния через интерполяцию или простое выражение.

Пример из правила: вместо scale = 0.95 при нажатии храним pressed = 1, а масштаб получаем через interpolate(pressed.get(), [0, 1], [1, 0.95]). Для React то же самое: height = isExpanded ? 200 : 0 вместо хранения height в отдельном useState и синхронизации через useEffect.

Аргументы правила: один источник правды упрощает отладку — pressed = 1 понятнее, чем scale = 0.95. Расширять анимацию проще: opacity, rotation и другие эффекты берутся из того же состояния. Установка через маркетплейс: сначала /plugin marketplace add fcakyon/claude-codex-settings, потом /plugin install react-skills@claude-settings, файл правила — .claude/rules/state-ground-truth.md.

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

  • Разделить фактическое состояние и производный визуал
  • Убрать лишние useEffect для синхронизации значений
  • Упростить добавление новых анимаций к существующему состоянию
  • Сделать отладку состояний понятнее через осмысленные имена

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

  • Проверь этот компонент: состояние должно отражать факт, а не визуал
  • Перепиши анимацию нажатия, чтобы хранить pressed, а не scale
  • Найди места, где useState хранит производные значения, и упрости их

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

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings

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

.claude/rules/state-ground-truth.md

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

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

Вопросы о state-ground-truth

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

Выполните /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install react-skills@claude-settings. Правило появится в .claude/rules/state-ground-truth.md.

Что делает правило state-ground-truth?

Оно требует, чтобы useState и Reanimated shared values хранили только фактическое состояние — pressed, progress, isOpen. Визуальные значения вроде scale или opacity должны вычисляться из состояния через интерполяцию.

Применяется ли правило к обычному React без Reanimated?

Да. В правиле есть пример с React: вместо хранения height в отдельном useState и обновления через useEffect, значение вычисляется напрямую из isExpanded.

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

state-ground-truth.md · MIT
---
title: State Must Represent Ground Truth
impact: HIGH
impactDescription: cleaner logic, easier debugging, single source of truth
tags: state, derived-state, reanimated, hooks
---

## State Must Represent Ground Truth

State variables—both React `useState` and Reanimated shared values—should
represent the actual state of something (e.g., `pressed`, `progress`, `isOpen`),
not derived visual values (e.g., `scale`, `opacity`, `translateY`). Derive
visual values from state using computation or interpolation.

**Incorrect (storing the visual output):**

```tsx
const scale = useSharedValue(1)

const tap = Gesture.Tap()
  .onBegin(() => {
    scale.set(withTiming(0.95))
  })
  .onFinalize(() => {
    scale.set(withTiming(1))
  })

const animatedStyle = useAnimatedStyle(() => ({
  transform: [{ scale: scale.get() }],
}))
```

**Correct (storing the state, deriving the visual):**

```tsx
const pressed = useSharedValue(0) // 0 = not pressed, 1 = pressed

const tap = Gesture.Tap()
  .onBegin(() => {
    pressed.set(withTiming(1))
  })
  .onFinalize(() => {
    pressed.set(withTiming(0))
  })

const animatedStyle = useAnimatedStyle(() => ({
  transform: [{ scale: interpolate(pressed.get(), [0, 1], [1, 0.95]) }],
}))
```

**Why this matters:**

State variables should represent real "state", not necessarily a desired end
result.

1. **Single source of truth** — The state (`pressed`) describes what's
   happening; visuals are derived
2. **Easier to extend** — Adding opacity, rotation, or other effects just
   requires more interpolations from the same state
3. **Debugging** — Inspecting `pressed = 1` is clearer than `scale = 0.95`
4. **Reusable logic** — The same `pressed` value can drive multiple visual
   properties

**Same principle for React state:**

```tsx
// Incorrect: storing derived values
const [isExpanded, setIsExpanded] = useState(false)
const [height, setHeight] = useState(0)

useEffect(() => {
  setHeight(isExpanded ? 200 : 0)
}, [isExpanded])

// Correct: derive from state
const [isExpanded, setIsExpanded] = useState(false)
const height = isExpanded ? 200 : 0
```

State is the minimal truth. Everything else is derived.

© fcakyon · MIT · fcakyon/claude-codex-settings

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

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
react-state-minimize alexj11324 Правило react-state-minimize для Claude Code учит помощника убирать лишние переменные состояния React. Оно требует вычислять значения прямо в момент рендера. CX Codex +1 ★ 88звёзд репо Ground Truth anishdasmail Ground Truth проверяет публичные URL, цены, заголовки безопасности и фактические утверждения. Подключите его, когда агенту нужны свежие данные с веб-страниц и подтверждения для выводов. CX Codex +1 215установок component-state-auditor ShuaiMXu Скилл component-state-auditor для Claude Code сравнивает задокументированные состояния компонентов с правилами из файла rubric.json. Он помогает выявить недостающие состояния в коде и дизайне перед релизом. CX Codex +1 ★ 529звёзд репо mcp-state-sidecar askadvaith MCP-сервер mcp-state-sidecar выносит состояние многоагентных воркфлоу в отдельный MCP-сервер: ключи, воркфлоу, лизы и история переживают падение процесса. CX Codex +1 ★ 7звёзд репо state-management statelyai Скилл state-management для Claude Code моделирует состояние приложения до выбора библиотеки. Проверяет и рефакторит модели, сокращает исходные данные и устраняет невозможные состояния. CX Codex +1 181установок rendering-activity jarrodwatts Правило rendering-activity для Claude подсказывает агенту держать дорогие React-компоненты в <Activity>, чтобы при скрытии не терялись состояние и DOM. CX Codex +1 ★ 1 064звёзд репо

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

Весь набор →
setup Скилл setup настраивает Paper Search CLI в окружении ассистента вместо MCP-сервера. Помогает подключить поиск научных статей и прописать ключи провайдеров. CX Codex +1 ★ 1 216звёзд репо review-pr Скилл review-pr проверяет pull request на баги, регрессии, рисковые изменения и пропущенные тесты. Запустите его, когда нужно разобрать PR и получить список проблем по важности. CX Codex +1 ★ 1 216звёзд репо animation-gpu-properties Правило animation-gpu-properties уводит анимации с width, height, top, left, margin и padding на transform и opacity, чтобы не пересчитывать layout на каждом кадре. CX Codex +1 ★ 1 216звёзд репо rerender-no-inline-components Правило rerender-no-inline-components помогает находить компоненты React, объявленные внутри других компонентов. Такая структура приводит к перемонтированию при каждом рендере и потере состояния. CX Codex +1 ★ 1 216звёзд репо ui-styling Правило ui-styling задаёт современные стандарты стилизации React Native: скругления со сглаживанием, отступы через gap, синтаксис boxShadow и градиенты без сторонних библиотек. CX Codex +1 ★ 1 216звёзд репо ui-measure-views Правило ui-measure-views предписывает измерять размеры View в React Native через связку useLayoutEffect и onLayout, предотвращая лишние ререндеры. CX Codex +1 ★ 1 216звёзд репо create-issue Скилл create-issue для Claude Code помогает создать или переписать issue: оформить баг, запросить функцию или улучшить заголовок и описание. Перед публикацией он проверяет шаблон репозитория и ищет похожие обращения. CX Codex +1 ★ 1 216звёзд репо list-performance-item-memo Правило list-performance-item-memo для строк списка в React: отдавать в элемент отдельные примитивы вместо объекта целиком, чтобы memo() сравнивал props и не перерисовывал строку без изменений. CX Codex +1 ★ 1 216звёзд репо

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

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