server-serialization — правило для Claude Code: установка
Правило server-serialization для Claude Code помогает сокращать данные, которые React передаёт с сервера на клиент. Оно срабатывает при работе с границей Server/Client в React.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/server-serialization.mdЧто делает server-serialization
server-serialization напоминает передавать через границу Server/Client только свойства, которые использует клиентский компонент. Вместо целого объекта пользователя компоненту можно передать, например, только имя, если остальные поля ему не нужны.
React сериализует переданные свойства и добавляет их в HTML-ответ и последующие RSC-запросы. Размер этих данных влияет на вес страницы и время загрузки. Правило касается передачи свойств в React, а не получения данных на сервере.
Какие задачи решает
- сократить объём свойств, передаваемых клиентскому компоненту
- убрать из клиентского запроса неиспользуемые поля объекта
- передавать компоненту только нужные ему данные
Примеры запросов агенту
- Проверь границу Server/Client и убери из props поля, которые компонент не использует.
- Измени передачу объекта пользователя: клиенту нужно только имя.
Как установить server-serialization
Вручную: положить файлы
.claude/rules/server-serialization.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/server-serialization.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/server-serialization.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/server-serialization.mdВручную: положить файлы
.clinerules/server-serialization.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о server-serialization
Как установить server-serialization в Claude Code?
Добавь файл правила по пути .claude/rules/server-serialization.md.
Что делает server-serialization?
Правило помогает передавать через границу Server/Client только те свойства, которые нужны клиентскому компоненту. Это уменьшает объём сериализованных данных в HTML-ответе и RSC-запросах.
Какие поля передавать через границу Server/Client?
Только те, которые использует клиентский компонент. Если компонент отображает имя пользователя, ему можно передать имя вместо всего объекта.
Исходный текст
server-serialization.md · MIT
---
title: Minimize Serialization at RSC Boundaries
impact: HIGH
impactDescription: reduces data transfer size
tags: server, rsc, serialization, props
---
## Minimize Serialization at RSC Boundaries
The React Server/Client boundary serializes all object properties into strings and embeds them in the HTML response and subsequent RSC requests. This serialized data directly impacts page weight and load time, so **size matters a lot**. Only pass fields that the client actually uses.
**Incorrect (serializes all 50 fields):**
```tsx
async function Page() {
const user = await fetchUser() // 50 fields
return <Profile user={user} />
}
'use client'
function Profile({ user }: { user: User }) {
return <div>{user.name}</div> // uses 1 field
}
```
**Correct (serializes only 1 field):**
```tsx
async function Page() {
const user = await fetchUser()
return <Profile name={user.name} />
}
'use client'
function Profile({ name }: { name: string }) {
return <div>{name}</div>
}
```
© tech-leads-club · MIT · tech-leads-club/agent-skills