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