bundle-preload — правило для Claude Code: что делает и как установить
Правило bundle-preload учит агента предзагружать тяжёлые бандлы при наведении курсора или включении фичефлага. Это снижает видимую задержку интерфейса.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/bundle-preload.mdЧто делает bundle-preload
Правило инструктирует Claude Code внедрять предзагрузку модулей по намерению пользователя. Вместо ожидания клика код запускает динамический импорт заранее — по событиям onMouseEnter и onFocus, либо при активации соответствующего флага в провайдере.
В шаблонах обязательно используется проверка typeof window !== 'undefined'. Без этого условия модуль попадает в серверную сборку при SSR, что раздувает серверный бандл и замедляет сборку проекта.
Какие задачи решает
- предзагружать тяжёлые клиентские модули до клика
- вызывать динамический импорт при наведении курсора или фокусе
- подгружать код редактора при включении фичефлага
- защитить серверный бандл от клиентских зависимостей при SSR
Примеры запросов агенту
- Сделай ленивую загрузку редактора с предзагрузкой по наведению на кнопку
- Оптимизируй загрузку тяжёлого компонента через динамический импорт по фокусу
- Добавь предзагрузку модуля в FlagsProvider при включении флага
Как установить bundle-preload
Вручную: положить файлы
.claude/rules/bundle-preload.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/bundle-preload.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/bundle-preload.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/bundle-preload.mdВручную: положить файлы
.clinerules/bundle-preload.mdПо шагам, с командами для каждой платформы: 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