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