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

perf-zustand-selectors — правило для Claude Code про селекторы Zustand

Правило perf-zustand-selectors для ИИ-агента: подписка в компоненте идёт на отдельный срез Zustand-стора, поэтому перерисовка случается только при изменении нужных данных.

MIT ★ 4 719 обновлён 2026-10-24

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

Что делает perf-zustand-selectors

Правило задаёт агенту одну линию: компонент берёт из стора конкретный срез, а не весь объект стора. В файле два примера. Один компонент читает useGameStore() целиком и перерисовывается, когда меняются score или health. Второй просит только playerX через useGameStore(state => state.playerX).

Дальше случаи посложнее: несколько значений сразу через shallow из zustand/shallow, подписка через useGameStore.subscribe() без перерисовок для величин, которые меняются каждый кадр, и getState() внутри useFrame для анимации. В конце — таблица сравнения методов и пример устройства стора, где действия и геттеры отделены от состояния.

Голый вызов useStore() в этой таблице помечен как «Never use»: если такой код уже стоит в компоненте, правило его подсветит. Файл рассчитан на Claude и Codex и лежит в проекте по пути .claude/rules/perf-zustand-selectors.md — через пакетный менеджер ничего не ставится.

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

  • убрать перерисовки компонента, который читает из стора одно поле
  • подписать компонент сразу на несколько значений через shallow
  • двигать меш каждый кадр без ререндера React
  • вынести действия и производные значения из подписки на стор

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

  • Перепиши подписку в компоненте: нужен только playerX, а не весь стор.
  • Компонент перерисовывается на каждое изменение score — переведи его на селектор Zustand.
  • Позиция меняется каждый кадр: сделай подписку через useGameStore.subscribe(), без перерисовок.

Как установить perf-zustand-selectors

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

.claude/rules/perf-zustand-selectors.md

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

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

Вопросы о perf-zustand-selectors

Как установить perf-zustand-selectors в Claude Code?

Положите текст правила в файл .claude/rules/perf-zustand-selectors.md внутри проекта.

Что делает perf-zustand-selectors?

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

Что будет, если оставить useGameStore() без селектора?

Компонент будет перерисовываться на любое изменение стора, включая score и health. В таблице сравнения такой вызов помечен как «Never use».

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

perf-zustand-selectors.md · MIT
# perf-zustand-selectors

**Use Zustand selectors to minimize re-renders.**

## Why It Matters

Subscribing to the entire Zustand store means your component re-renders whenever ANY value changes. Selectors let you subscribe to specific slices, so components only re-render when their specific data changes.

## Bad Example

```jsx
// BAD - Re-renders on ANY store change
function BadComponent() {
  const store = useGameStore(); // Subscribes to entire store
  return <mesh position-x={store.playerX} />;
}
```

If `score`, `health`, or any other value changes, this component re-renders even though it only uses `playerX`.

## Good Example

```jsx
// GOOD - Re-renders only when playerX changes
function GoodComponent() {
  const playerX = useGameStore(state => state.playerX);
  return <mesh position-x={playerX} />;
}
```

## Multiple Values with Shallow

```jsx
import { shallow } from 'zustand/shallow';

// GOOD - Re-renders only when x, y, or z changes
function PositionComponent() {
  const { x, y, z } = useGameStore(
    state => ({ x: state.x, y: state.y, z: state.z }),
    shallow // Use shallow comparison for objects
  );
  return <mesh position={[x, y, z]} />;
}
```

## Transient Subscriptions (No Re-renders)

For values that change every frame (like positions), use transient subscriptions:

```jsx
function TransientComponent() {
  const meshRef = useRef();

  useEffect(() => {
    // Subscribe without causing re-renders
    const unsubscribe = useGameStore.subscribe(
      state => state.playerPosition,
      position => {
        meshRef.current.position.copy(position);
      }
    );
    return unsubscribe;
  }, []);

  return <mesh ref={meshRef} />;
}
```

## getState() in useFrame

For animation, use `getState()` which doesn't subscribe:

```jsx
function AnimatedComponent() {
  const meshRef = useRef();

  useFrame(() => {
    // No subscription, no re-renders
    const { targetPosition, speed } = useStore.getState();
    meshRef.current.position.lerp(targetPosition, speed);
  });

  return <mesh ref={meshRef} />;
}
```

## Store Design for Performance

```jsx
const useGameStore = create((set, get) => ({
  // State
  playerX: 0,
  playerY: 0,
  score: 0,
  health: 100,

  // Actions (don't subscribe to these)
  movePlayer: (dx, dy) => set(state => ({
    playerX: state.playerX + dx,
    playerY: state.playerY + dy
  })),

  // Derived values as getters
  getPlayerPosition: () => {
    const { playerX, playerY } = get();
    return new THREE.Vector3(playerX, playerY, 0);
  }
}));
```

## Comparison

| Method | Re-renders | Use Case |
|--------|------------|----------|
| `useStore()` | Every change | Never use |
| `useStore(s => s.value)` | When value changes | Most cases |
| `useStore(selector, shallow)` | When any selected value changes | Multiple values |
| `useStore.subscribe()` | Never | Continuous updates |
| `useStore.getState()` | Never | Inside useFrame |

## References

- [Zustand Documentation](https://github.com/pmndrs/zustand)
- [R3F State Management](https://docs.pmnd.rs/react-three-fiber/tutorials/using-with-zustand)

© zebbern · MIT · zebbern/claude-code-guide

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

Все правила IDE по теме «Фронтенд и UI» →
zustand-store-ts Microsoft Скилл zustand-store-ts для Claude Code и GitHub Copilot, который задаёт шаблон стора Zustand на TypeScript. Включается, когда в React-проекте нужно глобальное состояние с подписками и раздельными state/actions. CX Codex +1 3установок zustand vercel-labs Интегрирует Zustand в json-render и синхронизирует состояние приложения. Связывает Zustand-хранилища с компонентами, которые рендерит json-render. CX Codex +1 1 900установок zustand-patterns OrchestKit Скилл zustand-patterns для Claude Code помогает проектировать хранилища на Zustand 5.x с типизацией в TypeScript. Подключается при настройке слайсов, селекторов useShallow и цепочек middleware. CX Codex +1 1 500установок zustand-state-management Mindrally Скилл zustand-state-management задаёт правила архитектуры сторов Zustand в React и TypeScript: от нарезки слайсов до SSR и тестов. Помогает избежать лишних ререндеров и ошибок гидратации. CX Codex +1 1 000установок zustand-5 prowler-cloud Скилл с паттернами управления состоянием в Zustand 5: базовые хранилища, селекторы, persist-middleware и разделение логики на слайсы. Помогает писать чистый реактивный код без лишних ре-рендеров. CX Codex +1 912установок zustand-state-builder patricio0312rev Скилл zustand-state-builder для Claude Code управляет состоянием приложения через Zustand: лёгкий API, TypeScript, сохранение в хранилище и devtools. CX Codex +1 264установок

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

Весь набор →
draw-call-optimization Правило draw-call-optimization для Claude Code описывает оптимизацию сцены Three.js: снизить число вызовов отрисовки до 100 на кадр инстансингом, батчингом и слиянием геометрий. CX Codex +1 ★ 4 719звёзд репо object-pooling Правило object-pooling учит агента переиспользовать снаряды, частицы и NPC из пула, вместо того чтобы создавать и удалять меши каждый кадр. CX Codex +1 ★ 4 719звёзд репо shader-mobile Правило shader-mobile для Claude Code содержит приёмы оптимизации GLSL и Three.js шейдеров под мобильные GPU, помогающие избежать просадок FPS на смартфонах. CX Codex +1 ★ 4 719звёзд репо drei-use-gltf Правило drei-use-gltf для Claude Code задаёт загрузку GLTF-моделей через useGLTF с кэшированием и предварительной загрузкой. Используется в сценах на React Three Fiber. CX Codex +1 ★ 4 719звёзд репо geometry-instanced-mesh Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов. CX Codex +1 ★ 4 719звёзд репо webgpu-renderer Правило webgpu-renderer для Claude Code описывает подключение WebGPU-рендерера Three.js и запасной путь через WebGL 2. Показывает настройку 3D-сцен с вычислениями на GPU. CX Codex +1 ★ 4 719звёзд репо tsl-material-slots tsl-material-slots — правило для Claude Code со справочником слотов TSL в Three.js. Помогает настраивать шейдерную логику через узлы без ошибок в типах и именах свойств. CX Codex +1 ★ 4 719звёзд репо core-web-vitals Правило core-web-vitals для Claude Code: грузит модели и текстуры в 3D-сценах на Three.js так, чтобы LCP, FID и CLS не проседали. Не даёт тяжёлому 3D тормозить первую отрисовку. CX Codex +1 ★ 4 719звёзд репо

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

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