# state-ground-truth

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

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1216 у репозитория
- Автор: fcakyon
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/react-skills/skills/react-native-skills/rules/state-ground-truth.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/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`.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add fcakyon/claude-codex-settings
```
В чате агента (не в терминале):
```text
/plugin install react-skills@claude-settings
```

2. **Вручную: положить файлы**
- Файл: `.claude/rules/state-ground-truth.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/state-ground-truth.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/state-ground-truth.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/state-ground-truth.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/state-ground-truth.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/react-skills/skills/react-native-skills/rules/state-ground-truth.md

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

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

## Похожие
- [react-state-minimize](https://affpapa.org/nevibecode/rules/react-state-minimize.md) — правило · ★ 88 у репозитория
- [Ground Truth](https://affpapa.org/nevibecode/mcp/ground-truth.md) — MCP-сервер · 215 установок
- [component-state-auditor](https://affpapa.org/nevibecode/skills/component-state-auditor.md) — скилл · ★ 529 у репозитория
- [mcp-state-sidecar](https://affpapa.org/nevibecode/mcp/mcp-state-sidecar.md) — MCP-сервер · ★ 7 у репозитория
- [state-management](https://affpapa.org/nevibecode/skills/statelyai-state-management.md) — скилл · 181 установка
- [rendering-activity](https://affpapa.org/nevibecode/rules/rendering-activity.md) — правило · ★ 1064 у репозитория

Из того же набора: [fcakyon/claude-codex-settings](https://affpapa.org/nevibecode/by/fcakyon/claude-codex-settings.md) — 113 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
