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

bundle-preload — правило для Claude Code: что делает и как установить

Правило bundle-preload учит агента предзагружать тяжёлые бандлы при наведении курсора или включении фичефлага. Это снижает видимую задержку интерфейса.

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

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

Что делает bundle-preload

Правило инструктирует Claude Code внедрять предзагрузку модулей по намерению пользователя. Вместо ожидания клика код запускает динамический импорт заранее — по событиям onMouseEnter и onFocus, либо при активации соответствующего флага в провайдере.

В шаблонах обязательно используется проверка typeof window !== 'undefined'. Без этого условия модуль попадает в серверную сборку при SSR, что раздувает серверный бандл и замедляет сборку проекта.

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

  • предзагружать тяжёлые клиентские модули до клика
  • вызывать динамический импорт при наведении курсора или фокусе
  • подгружать код редактора при включении фичефлага
  • защитить серверный бандл от клиентских зависимостей при SSR

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

  • Сделай ленивую загрузку редактора с предзагрузкой по наведению на кнопку
  • Оптимизируй загрузку тяжёлого компонента через динамический импорт по фокусу
  • Добавь предзагрузку модуля в FlagsProvider при включении флага

Как установить bundle-preload

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

.claude/rules/bundle-preload.md

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

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

Вопросы о bundle-preload

Как установить bundle-preload в Claude Code?

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

Что делает правило bundle-preload?

Оно задаёт паттерны асинхронного импорта модулей по событиям взаимодействия или флагам конфигурации.

Зачем в коде предзагрузки нужна проверка typeof window?

Проверка typeof window !== 'undefined' предотвращает включение предзагружаемых модулей в серверную сборку при SSR, сохраняя размер бандла сервера.

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

bundle-preload.md · MIT
---
title: Preload Based on User Intent
impact: MEDIUM
impactDescription: reduces perceived latency
tags: bundle, preload, user-intent, hover
---

## Preload Based on User Intent

Preload heavy bundles before they're needed to reduce perceived latency.

**Example (preload on hover/focus):**

```tsx
function EditorButton({ onClick }: { onClick: () => void }) {
  const preload = () => {
    if (typeof window !== 'undefined') {
      void import('./monaco-editor')
    }
  }

  return (
    <button
      onMouseEnter={preload}
      onFocus={preload}
      onClick={onClick}
    >
      Open Editor
    </button>
  )
}
```

**Example (preload when feature flag is enabled):**

```tsx
function FlagsProvider({ children, flags }: Props) {
  useEffect(() => {
    if (flags.editorEnabled && typeof window !== 'undefined') {
      void import('./monaco-editor').then(mod => mod.init())
    }
  }, [flags.editorEnabled])

  return <FlagsContext.Provider value={flags}>
    {children}
  </FlagsContext.Provider>
}
```

The `typeof window !== 'undefined'` check prevents bundling preloaded modules for SSR, optimizing server bundle size and build speed.

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

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

Все правила IDE по теме «Фронтенд и UI» →
preload patterns.dev Скилл preload обучает агента настраивать предзагрузку критических ресурсов сайта. Помогает подтянуть шрифты, ключевые скрипты и баннеры, которые браузер находит слишком поздно. CX Codex +1 1 700установок next-bundle-optimizer vercel Скилл next-bundle-optimizer для Claude Code и других агентов: аудирует начальную загрузку Next.js, находит медленные маршруты, раздутые клиентские бандлы и дублирующиеся зависимости. CX Codex +1 4 800установок rendering-resource-hints fcakyon Правило rendering-resource-hints учит агента вставлять в React-компоненты вызовы API React DOM для подсказок браузеру о ресурсах. Встраивается в серверные компоненты, чтобы загрузка файлов стартовала раньше, чем клиент получит HTML. CX Codex +1 ★ 1 216звёзд репо agentic-bundle-aas-accessibility-inclusive-ux sickn33 and contributors Плагин agentic-bundle-aas-accessibility-inclusive-ux для Claude Code добавляет редакторский набор скиллов об доступности и инклюзивном UX. Он относится к задачам, где обсуждают эти темы. CX Codex ★ 50 109звёзд репо agentic-bundle-aas-mobile-app-builder sickn33 and contributors Плагин agentic-bundle-aas-mobile-app-builder для Claude Code — набор скиллов, инструментов и шаблонов для разработки мобильных приложений. CX Codex ★ 50 109звёзд репо bundle-analyzable-paths fcakyon Правило bundle-analyzable-paths просит оставлять пути импортов и файлов понятными для статического анализа. Это помогает не расширять сборку и трассировку файлов без необходимости. CX Codex +1 ★ 1 216звёзд репо

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

Весь набор →
advanced-use-latest Правило advanced-use-latest для Claude показывает, как в эффектах React брать свежий колбэк, не добавляя его в массив зависимостей. CX Codex +1 ★ 7 191звёзд репо async-api-routes Правило async-api-routes устраняет цепочки водопадов в обработчиках API и Server Actions. Оно запускает независимые асинхронные вызовы сразу, не дожидаясь завершения других промисов. CX Codex +1 ★ 7 191звёзд репо js-early-exit Правило js-early-exit для Claude Code задаёт немедленный возврат результата, как только он определён. Останавливает проверку после первой найденной ошибки. CX Codex +1 ★ 7 191звёзд репо rerender-memo Правило rerender-memo учит агента выносить дорогие вычисления в отдельные мемоизированные компоненты, чтобы избежать лишних расчётов при ранних возвратах. Помогает ускорить рендеринг в React-приложениях. CX Codex +1 ★ 7 191звёзд репо client-swr-dedup Правило client-swr-dedup для Claude Code предлагает использовать SWR, чтобы компоненты делили запросы и получали данные из кэша. Описывает клиентскую загрузку данных в React. CX Codex +1 ★ 7 191звёзд репо rerender-memo-with-default-value Правило rerender-memo-with-default-value предотвращает ломку мемоизации компонентов React из-за того, что новые экземпляры объектов и функций создаются при каждом рендере. Извлекает дефолтные значения в константы. CX Codex +1 ★ 7 191звёзд репо rendering-animate-svg-wrapper Правило rendering-animate-svg-wrapper предписывает оборачивать векторные элементы svg в контейнер div для CSS-анимаций. Это включает аппаратное ускорение в браузерах. CX Codex +1 ★ 7 191звёзд репо rerender-derived-state-no-effect Правило rerender-derived-state-no-effect не даёт хранить вычисляемые значения в состоянии и обновлять их через эффект. Оно пригодится при ревью React-кода. CX Codex +1 ★ 7 191звёзд репо

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

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