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

rerender-use-ref-transient-values — правило для Claude Code

Правило rerender-use-ref-transient-values учит агента хранить часто меняющиеся значения в useRef, а не в useState, чтобы избежать перерисовок компонента на каждое обновление.

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

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

Что делает rerender-use-ref-transient-values

Когда значение меняется часто — координаты курсора, счётчики интервалов, временные флаги — обновление через useState вызывает перерисовку компонента при каждом изменении. Правило предписывает использовать useRef для таких значений: обновление .current не триггерит рендер, и компонент остаётся быстрым.

В примере из правила трекер мыши на useState рендерится на каждое движение курсора, а версия на useRef напрямую меняет transform DOM-элемента через dotRef.current.style — без лишних рендеров. Импакт правила обозначен как средний: оно убирает ненужные перерисовки при частых обновлениях.

Правило работает для React-компонентов. Агент будет выбирать useRef для значений, которые нужны внутри обработчиков или эффектов, но не влияют на отображаемый UI.

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

  • избежать перерисовки компонента при частом обновлении значения
  • хранить координаты курсора или счётчик без рендера
  • обновлять DOM напрямую из useEffect без триггера состояния

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

  • Сделай трекер мыши, который обновляет позицию элемента без перерисовки компонента
  • Храни последнее значение таймера в рефе, чтобы не рендерить компонент каждую секунду
  • Перепиши этот счётчик на useRef, чтобы убрать лишние рендеры

Как установить rerender-use-ref-transient-values

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

.claude/rules/rerender-use-ref-transient-values.md

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

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

Вопросы о rerender-use-ref-transient-values

Как установить rerender-use-ref-transient-values в Claude Code?

Положи файл правила в .claude/rules/rerender-use-ref-transient-values.md в корне проекта. Claude Code подхватит его автоматически.

Что делает правило rerender-use-ref-transient-values?

Оно учит агента хранить часто меняющиеся значения в useRef вместо useState, чтобы избежать перерисовок компонента на каждое обновление. Обновление .current не вызывает рендер.

Когда использовать useRef вместо useState по этому правилу?

Когда значение меняется часто (координаты мыши, интервалы, временные флаги) и не влияет напрямую на JSX. Для UI-состояния оставляй useState.

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

rerender-use-ref-transient-values.md · MIT
---
title: Use useRef for Transient Values
impact: MEDIUM
impactDescription: avoids unnecessary re-renders on frequent updates
tags: rerender, useref, state, performance
---

## Use useRef for Transient Values

When a value changes frequently and you don't want a re-render on every update (e.g., mouse trackers, intervals, transient flags), store it in `useRef` instead of `useState`. Keep component state for UI; use refs for temporary DOM-adjacent values. Updating a ref does not trigger a re-render.

**Incorrect (renders every update):**

```tsx
function Tracker() {
  const [lastX, setLastX] = useState(0)

  useEffect(() => {
    const onMove = (e: MouseEvent) => setLastX(e.clientX)
    window.addEventListener('mousemove', onMove)
    return () => window.removeEventListener('mousemove', onMove)
  }, [])

  return (
    <div
      style={{
        position: 'fixed',
        top: 0,
        left: lastX,
        width: 8,
        height: 8,
        background: 'black',
      }}
    />
  )
}
```

**Correct (no re-render for tracking):**

```tsx
function Tracker() {
  const lastXRef = useRef(0)
  const dotRef = useRef<HTMLDivElement>(null)

  useEffect(() => {
    const onMove = (e: MouseEvent) => {
      lastXRef.current = e.clientX
      const node = dotRef.current
      if (node) {
        node.style.transform = `translateX(${e.clientX}px)`
      }
    }
    window.addEventListener('mousemove', onMove)
    return () => window.removeEventListener('mousemove', onMove)
  }, [])

  return (
    <div
      ref={dotRef}
      style={{
        position: 'fixed',
        top: 0,
        left: 0,
        width: 8,
        height: 8,
        background: 'black',
        transform: 'translateX(0px)',
      }}
    />
  )
}
```

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

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

Все правила IDE по теме «Фронтенд и UI» →
rerender-derived-state jarrodwatts Правило rerender-derived-state для Claude Code предлагает подписываться на производное булево состояние, чтобы React-компоненты реже перерисовывались. Переключает мобильный и обычный режимы интерфейса. CX Codex +1 ★ 1 064звёзд репо rerender-no-inline-components fcakyon Правило rerender-no-inline-components помогает находить компоненты React, объявленные внутри других компонентов. Такая структура приводит к перемонтированию при каждом рендере и потере состояния. CX Codex +1 ★ 1 216звёзд репо rerender-dependencies jarrodwatts Правило rerender-dependencies для Claude требует держать в зависимостях useEffect примитивы: user.id вместо user. Тогда эффект не перезапускается на каждое изменение полей объекта. CX Codex +1 ★ 1 064звёзд репо 21st-cli-use 21st-dev Скилл 21st-cli-use ищет, скачивает и ставит React- и shadcn-компоненты, темы и SVG-логотипы из каталога 21st.dev через утилиту 21st. Срабатывает при наличии components.json, избавляя от ручной вёрстки. CX Codex +1 2 600установок use-topbar cognitedata Скилл use-topbar ставит в приложение Flows/Fusion единый топбар из @aura/topbar: хлебные крошки, переключатель темы, кнопка Atlas. CX Codex +1 1 900установок no-use-effect Factory-AI Скилл no-use-effect, который не даёт агенту писать useEffect в React-коде и подсказывает пять замен. Пригодится при рефакторинге и ревью компонентов. CX Codex +1 1 100установок

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

Весь набор →
server-parallel-fetching Правило server-parallel-fetching для Claude Code показывает, как перестроить React Server Components для параллельных независимых запросов данных. Устраняет цепочки загрузки, где компонент ждёт другого. CX Codex +1 ★ 7 191звёзд репо _sections Правило _sections для Claude Code, которое определяет восемь разделов оптимизации производительности, их приоритеты и порядок применения. Устанавливается один раз в проект и служит справочником при анализе кода агентом. CX Codex +1 ★ 7 191звёзд репо client-passive-event-listeners Правило client-passive-event-listeners учит агента добавлять { passive: true } к обработчикам событий скролла и тача, чтобы браузер не задерживал прокрутку страницы. CX Codex +1 ★ 7 191звёзд репо js-cache-storage Правило js-cache-storage требует держать значения localStorage, sessionStorage и cookie в памяти, а не дёргать синхронное хранилище на каждом вызове. CX Codex +1 ★ 7 191звёзд репо js-length-check-first Правило js-length-check-first для Claude Code, которое подсказывает проверять длину массивов перед дорогими операциями вроде сортировки или глубокого сравнения. Если длины не совпадают, массивы точно не равны — операция не нужна. CX Codex +1 ★ 7 191звёзд репо js-tosorted-immutable Правило js-tosorted-immutable заменяет мутирующий .sort() на .toSorted(), чтобы сортировка не меняла массивы в props и state React. CX Codex +1 ★ 7 191звёзд репо patterns-children-over-render-props Правило patterns-children-over-render-props для Claude Code описывает композицию React-компонентов через children вместо renderX-пропсов, в том числе для формы с разросшимися колбэками. CX Codex +1 ★ 7 191звёзд репо js-cache-function-results Правило js-cache-function-results предписывает агенту кешировать результаты повторных вызовов чистых функций через Map на уровне модуля. Это снижает лишние вычисления при рендере в React и обычном JavaScript. CX Codex +1 ★ 7 191звёзд репо

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

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