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

server-hoist-static-io — правило для Claude Code

Правило server-hoist-static-io для Claude Code и Codex, которое помогает избежать повторных операций чтения файлов и сетевых запросов.

MIT ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings
Открыть на GitHub

Что делает server-hoist-static-io

При разработке серверных функций и обработчиков маршрутов часто приходится работать со статическими файлами: шрифты для OG-изображений, логотипы, конфигурации. Если читать их на каждый запрос, это убивает производительность — особенно заметно в Next.js route handlers или при генерации изображений. Правило рекомендует переместить I/O операции на уровень модуля.

Модульный код выполняется один раз при первом импорте, а не на каждый вызов функции. Вместо await fs.readFile() внутри обработчика запроса используй промисы на уровне модуля, которые разрешаются один раз и переиспользуются во всех запросах. Для синхронного чтения подойдёт readFileSync, блокирующий только на этапе инициализации модуля.

Правило работает на Claude Code и Codex. Особенно эффективно на Vercel Fluid Compute, где несколько конкурентных запросов делят один экземпляр функции — статика остаётся в памяти без холодного старта. В традиционном serverless каждый холодный старт переопределяет модульный код, но тёплые вызовы переиспользуют загруженные ресурсы до переработки инстанса.

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

  • избежать повторного чтения файлов шрифтов в генераторе OG-изображений
  • загрузить конфиги и шаблоны один раз для всех запросов
  • снизить задержку обработчика маршрута, переместив I/O на инициализацию
  • кэшировать статические логотипы и иконки в памяти инстанса

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

  • Помогите переместить загрузку шрифтов для OG-изображений из обработчика GET на уровень модуля
  • Покажите, как хоустить config.json и template.html чтобы они читались один раз
  • Переделайте функцию так, чтобы логотип загружался при инициализации модуля, а не при каждом запросе

Как установить server-hoist-static-io

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings

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

.claude/rules/server-hoist-static-io.md

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

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

Вопросы о server-hoist-static-io

Как установить правило server-hoist-static-io в Claude Code?

Откройте командную палитру Claude Code, введите /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install react-skills@claude-settings. После этого правило загрузится из файла .claude/rules/server-hoist-static-io.md.

Что делает это правило?

Правило обучает поднимать операции чтения статических файлов (шрифты, логотипы, конфиги) на уровень модуля. Благодаря этому I/O выполняется один раз при импорте, а не при каждом запросе, что улучшает производительность серверных функций.

Когда НЕ стоит использовать это правило?

Не поднимай на уровень модуля файлы, которые меняются во время работы приложения, а также чувствительные данные, которые не должны оставаться в памяти. Для больших файлов, которые потребляют много памяти, лучше использовать кэширование с TTL вместо постоянной загрузки.

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

server-hoist-static-io.md · MIT
---
title: Hoist Static I/O to Module Level
impact: HIGH
impactDescription: avoids repeated file/network I/O per request
tags: server, io, performance, next.js, route-handlers, og-image
---

## Hoist Static I/O to Module Level

**Impact: HIGH (avoids repeated file/network I/O per request)**

When loading static assets (fonts, logos, images, config files) in route handlers or server functions, hoist the I/O operation to module level. Module-level code runs once when the module is first imported, not on every request. This eliminates redundant file system reads or network fetches that would otherwise run on every invocation.

**Incorrect (reads font file on every request):**

```typescript
// app/api/og/route.tsx
import { ImageResponse } from 'next/og'

export async function GET(request: Request) {
  // Runs on EVERY request - expensive!
  const fontData = await fetch(
    new URL('./fonts/Inter.ttf', import.meta.url)
  ).then(res => res.arrayBuffer())

  const logoData = await fetch(
    new URL('./images/logo.png', import.meta.url)
  ).then(res => res.arrayBuffer())

  return new ImageResponse(
    <div style={{ fontFamily: 'Inter' }}>
      <img src={logoData} />
      Hello World
    </div>,
    { fonts: [{ name: 'Inter', data: fontData }] }
  )
}
```

**Correct (loads once at module initialization):**

```typescript
// app/api/og/route.tsx
import { ImageResponse } from 'next/og'

// Module-level: runs ONCE when module is first imported
const fontData = fetch(
  new URL('./fonts/Inter.ttf', import.meta.url)
).then(res => res.arrayBuffer())

const logoData = fetch(
  new URL('./images/logo.png', import.meta.url)
).then(res => res.arrayBuffer())

export async function GET(request: Request) {
  // Await the already-started promises
  const [font, logo] = await Promise.all([fontData, logoData])

  return new ImageResponse(
    <div style={{ fontFamily: 'Inter' }}>
      <img src={logo} />
      Hello World
    </div>,
    { fonts: [{ name: 'Inter', data: font }] }
  )
}
```

**Correct (synchronous fs at module level):**

```typescript
// app/api/og/route.tsx
import { ImageResponse } from 'next/og'
import { readFileSync } from 'fs'
import { join } from 'path'

// Synchronous read at module level - blocks only during module init
const fontData = readFileSync(
  join(process.cwd(), 'public/fonts/Inter.ttf')
)

const logoData = readFileSync(
  join(process.cwd(), 'public/images/logo.png')
)

export async function GET(request: Request) {
  return new ImageResponse(
    <div style={{ fontFamily: 'Inter' }}>
      <img src={logoData} />
      Hello World
    </div>,
    { fonts: [{ name: 'Inter', data: fontData }] }
  )
}
```

**Incorrect (reads config on every call):**

```typescript
import fs from 'node:fs/promises'

export async function processRequest(data: Data) {
  const config = JSON.parse(
    await fs.readFile('./config.json', 'utf-8')
  )
  const template = await fs.readFile('./template.html', 'utf-8')

  return render(template, data, config)
}
```

**Correct (hoists config and template to module level):**

```typescript
import fs from 'node:fs/promises'

const configPromise = fs
  .readFile('./config.json', 'utf-8')
  .then(JSON.parse)
const templatePromise = fs.readFile('./template.html', 'utf-8')

export async function processRequest(data: Data) {
  const [config, template] = await Promise.all([
    configPromise,
    templatePromise,
  ])

  return render(template, data, config)
}
```

When to use this pattern:

- Loading fonts for OG image generation
- Loading static logos, icons, or watermarks
- Reading configuration files that don't change at runtime
- Loading email templates or other static templates
- Any static asset that's the same across all requests

When not to use this pattern:

- Assets that vary per request or user
- Files that may change during runtime (use caching with TTL instead)
- Large files that would consume too much memory if kept loaded
- Sensitive data that shouldn't persist in memory

With Vercel's [Fluid Compute](https://vercel.com/docs/fluid-compute), module-level caching is especially effective because multiple concurrent requests share the same function instance. The static assets stay loaded in memory across requests without cold start penalties.

In traditional serverless, each cold start re-executes module-level code, but subsequent warm invocations reuse the loaded assets until the instance is recycled.

© fcakyon · MIT · fcakyon/claude-codex-settings

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

Все правила IDE по теме «Бэкенд и API» →
static-rendering patterns.dev Скилл static-rendering для Claude Code, Codex и других агентов — учит статическому рендерингу (SSG), когда HTML собирается на этапе сборки. Включается в работу на страницах, которые не меняются от запроса к запросу. CX Codex +1 991установок nextjs-advanced-routing wsimmonds Скилл nextjs-advanced-routing для Claude Code и пяти других платформ, который учит агента работать с App Router: Route Handlers, Server Actions, Parallel Routes, Intercepting Routes и Suspense. CX Codex +1 336установок rendering-hoist-jsx tech-leads-club Правило rendering-hoist-jsx выносит неизменяемые JSX-элементы за пределы компонентов, чтобы они не создавались заново при каждом рендере. CX Codex +1 ★ 7 191звёзд репо nextjs-expert BuildWithClaude Community Плагин nextjs-expert для Claude Code и Cursor — пять скиллов и три слэш-команды по Next.js App Router: маршруты, серверные компоненты, формы, авторизация. ★ 3 785звёзд репо procedure finom Скилл procedure для Claude Code описывает типизированную серверную логику в Vovk.ts. Он включается при работе с данными на сервере, обработчиками форм и API. CX Codex +1 ★ 57звёзд репо performance-audit-static Paweł Huryn Команда performance-audit-static для статического аудита кода, созданного ИИ, на проблемы с производительностью. Указывает на перенос в репозиторий product-engineering. CX Codex +1 ★ 28 211звёзд репо

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

Весь набор →
setup Скилл setup для Claude Code и Codex настраивает сессионную куку Overleaf для плагина overleaf-skills. Запускается при ошибках авторизации 401 и протухшей сессии. CX Codex +1 ★ 1 216звёзд репо update-readme Команда update-readme для Claude Code и Codex обновляет разделы плагинов в README.md. Она сверяет их с файлами плагинов и данными маркетплейса. CX Codex +1 ★ 1 216звёзд репо openship-deploy Скилл openship-deploy для развёртывания и сопровождения самостоятельного инстанса OpenShip через CLI: деплой приложений, домены, бэкапы, обновления. CX Codex +1 ★ 1 216звёзд репо list-performance-function-references Правило list-performance-function-references запрещает трансформировать массивы перед передачей в виртуализированные списки. Оно заставляет переносить вычисления внутрь элементов, сохраняя стабильные ссылки на данные. CX Codex +1 ★ 1 216звёзд репо slides Скилл slides собирает PowerPoint-презентации через PptxGenJS с хелперами для вёрстки, рендером в PNG и проверкой на переполнение слайдов. CX Codex +1 ★ 1 216звёзд репо ui-menus Правило ui-menus для Claude Code и Codex, которое переключает кодогенерацию меню с кастомных JS-компонентов на нативные платформенные элементы через zeego. Срабатывает при создании выпадающих списков и контекстных меню. CX Codex +1 ★ 1 216звёзд репо schema Скилл schema для Claude Code и Codex проверяет и исправляет структурированные данные JSON-LD. Помогает выбрать тип разметки и понять, почему страница не получает расширенный результат. CX Codex +1 ★ 1 216звёзд репо python-guidelines Скилл python-guidelines задаёт правила написания и ревью Python-кода: интеграция в существующий код, запрет на лишние абстракции и единый формат докстрингов. CX Codex +1 ★ 1 216звёзд репо

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

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