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