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

server-cache-react — правило для Claude Code

Правило server-cache-react учит ассистента мемоизировать серверные запросы через React.cache() и избегать повторных обращений к базе данных.

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

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

Что делает server-cache-react

Правило настраивает генерацию кода с React.cache() для дедупликации операций внутри одного серверного запроса. Это актуально для проверок сессий, вызовов Prisma или Drizzle и чтения файлов.

React.cache() сравнивает аргументы через Object.is. Если передавать инлайн-объекты вроде { uid: 1 }, каждый вызов создаёт новую ссылку, поэтому кэш сбрасывается. Правило запрещает такие аргументы и требует использовать примитивные типы либо заранее объявленные ссылки.

В проектах на Next.js вызовы fetch уже дедуплицируются автоматически. Мемоизация через React.cache() остаётся обязательной для любых сторонних асинхронных операций.

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

  • дедуплицировать запросы к базе данных внутри одного HTTP-запроса
  • предотвратить промахи кэша из-за передачи инлайн-объектов в аргументах
  • мемоизировать повторные проверки сессий пользователей
  • разгрузить тяжёлые асинхронные вычисления в серверных компонентах

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

  • Оберни запрос текущего пользователя в React.cache
  • Проверь, почему вызов функции с React.cache не попадает в кэш
  • Напиши хелпер для загрузки профиля через Prisma с мемоизацией

Как установить server-cache-react

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

.claude/rules/server-cache-react.md

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

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

Вопросы о server-cache-react

Как установить server-cache-react в Claude Code?

Сохраните файл правила по пути .claude/rules/server-cache-react.md.

Что делает правило server-cache-react?

Оно заставляет модель оборачивать серверные запросы к БД и проверки авторизации в React.cache() и защищает от создания некэшируемых аргументов-объектов.

Нужен ли React.cache для fetch в Next.js?

Нет, Next.js автоматически мемоизирует одинаковые вызовы fetch. Однако для Drizzle, Prisma и файловых операций React.cache() по-прежнему необходим.

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

server-cache-react.md · MIT
---
title: Per-Request Deduplication with React.cache()
impact: MEDIUM
impactDescription: deduplicates within request
tags: server, cache, react-cache, deduplication
---

## Per-Request Deduplication with React.cache()

Use `React.cache()` for server-side request deduplication. Authentication and database queries benefit most.

**Usage:**

```typescript
import { cache } from 'react'

export const getCurrentUser = cache(async () => {
  const session = await auth()
  if (!session?.user?.id) return null
  return await db.user.findUnique({
    where: { id: session.user.id }
  })
})
```

Within a single request, multiple calls to `getCurrentUser()` execute the query only once.

**Avoid inline objects as arguments:**

`React.cache()` uses shallow equality (`Object.is`) to determine cache hits. Inline objects create new references each call, preventing cache hits.

**Incorrect (always cache miss):**

```typescript
const getUser = cache(async (params: { uid: number }) => {
  return await db.user.findUnique({ where: { id: params.uid } })
})

// Each call creates new object, never hits cache
getUser({ uid: 1 })
getUser({ uid: 1 })  // Cache miss, runs query again
```

**Correct (cache hit):**

```typescript
const getUser = cache(async (uid: number) => {
  return await db.user.findUnique({ where: { id: uid } })
})

// Primitive args use value equality
getUser(1)
getUser(1)  // Cache hit, returns cached result
```

If you must pass objects, pass the same reference:

```typescript
const params = { uid: 1 }
getUser(params)  // Query runs
getUser(params)  // Cache hit (same reference)
```

**Next.js-Specific Note:**

In Next.js, the `fetch` API is automatically extended with request memoization. Requests with the same URL and options are automatically deduplicated within a single request, so you don't need `React.cache()` for `fetch` calls. However, `React.cache()` is still essential for other async tasks:

- Database queries (Prisma, Drizzle, etc.)
- Heavy computations
- Authentication checks
- File system operations
- Any non-fetch async work

Use `React.cache()` to deduplicate these operations across your component tree.

Reference: [React.cache documentation](https://react.dev/reference/react/cache)

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

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

Все правила IDE по теме «Фронтенд и UI» →
runtime-cache официальный Vercel Labs Скилл для Codex и ChatGPT, который учит агента работать с Vercel Runtime Cache — эфемерным key-value хранилищем с инвалидацией по тегам. Запускается при обращении к кешу в Functions, Middleware или сборках Vercel. CX Codex GP ChatGPT +1 6установок nextjs-cache-handler-mcp leejpsd MCP-сервер nextjs-cache-handler-mcp подключает ИИ-агента к Redis-кэшу Next.js: помогает проверить состояние тегов, найти ключи и безопасно выполнить инвалидацию. CX Codex +1 ★ 6звёзд репо nextjs-cache-architecture mohamed-hossam1 Скилл nextjs-cache-architecture выстраивает архитектуру кеширования для Next.js 16+ App Router. Помогает внедрить директиву "use cache", собрать типизированный реестр тегов и настроить границы Suspense. CX Codex +1 5 100установок cache-components laguagu Скилл cache-components даёт экспертные советы по кэшированию компонентов и частичному предрендерингу в Next.js 16.4+. CX Codex +1 222установок next-cache-components официальный Vercel Labs Скилл next-cache-components для Codex помогает настраивать Cache Components в Next.js 16+. Он включается при работе с PPR, кэшированием и переходе с unstable_cache. CX Codex GP ChatGPT +1 4установок next-cache-components-optimizer vercel Скилл next-cache-components-optimizer ускоряет отрисовку статического каркаса страниц в Next.js. Скилл находит медленные Suspense-границы через падающий e2e-тест Playwright и чинит навигацию. CX Codex +1 22 000установок

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

Весь набор →
rerender-lazy-state-init Правило rerender-lazy-state-init напоминает передавать в useState функцию, если начальное значение требует дорогих вычислений. Это пригодится в React-компонентах с данными из хранилища или сложными структурами. CX Codex +1 ★ 7 191звёзд репо async-defer-await Правило async-defer-await учит откладывать операции await только на те ветки кода, где они действительно нужны. Это избегает блокировки путей выполнения, которые могут вернуться раньше. CX Codex +1 ★ 7 191звёзд репо server-dedup-props server-dedup-props — правило для Claude Code о дедупликации данных в React Server Components. Объясняет, почему серверные трансформации массивов дублируют payload и их следует переносить в клиент. CX Codex +1 ★ 7 191звёзд репо rendering-usetransition-loading Правило rendering-usetransition-loading для Claude Code переводит индикатор загрузки в React-компонентах с ручного useState на useTransition. Спиннер живёт на отдельном флаге — правило его убирает. CX Codex +1 ★ 7 191звёзд репо architecture-avoid-boolean-props Правило architecture-avoid-boolean-props запрещает раздувать компоненты булевыми пропсами и предлагает собирать варианты через композицию. Пригодится при проектировании React-компонентов. CX Codex +1 ★ 7 191звёзд репо rendering-hydration-no-flicker Правило rendering-hydration-no-flicker учит агента читать локальное хранилище без ошибок серверного рендеринга и без мигания интерфейса до гидратации. CX Codex +1 ★ 7 191звёзд репо bundle-barrel-imports Правило bundle-barrel-imports для Claude Code подсказывает импортировать модули напрямую, а не через barrel-файлы. Указывает прямые пути модулей в React-пакетах и библиотеках с большим числом реэкспортов. CX Codex +1 ★ 7 191звёзд репо patterns-explicit-variants Правило patterns-explicit-variants требует собирать каждый режим компонента отдельным компонентом вместо набора булевых пропсов. По вызову сразу видно, что отрисуется. CX Codex +1 ★ 7 191звёзд репо

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

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