bundle-conditional — правило для Claude Code: загрузка по условию
Правило bundle-conditional предлагает загружать крупные модули только при активации функции. Оно пригодится для отложенной загрузки данных и сокращения серверного бандла при SSR.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/bundle-conditional.mdЧто делает bundle-conditional
bundle-conditional предлагает подключать большие данные и модули только тогда, когда активирована использующая их функция. В примере с React кадры анимации загружаются через import() после включения плеера; пока данные не пришли, показывается заглушка. При ошибке загрузки функция отключается.
Проверка typeof window !== 'undefined' не даёт включать модуль в серверную сборку при SSR, что сокращает её размер и время сборки. Без этой проверки серверный бандл может включить модуль, который нужен только в браузере. Правило Claude Code хранится в .claude/rules/bundle-conditional.md.
Какие задачи решает
- отложить загрузку кадров анимации до включения плеера
- не включать браузерный модуль в серверную сборку
- показать заглушку, пока загружаются данные
- отключить функцию при ошибке импорта
Примеры запросов агенту
- Примени правило
bundle-conditionalк загрузке кадров анимации. - Проверь, можно ли загружать этот модуль только после активации функции.
- Добавь проверку для SSR, чтобы браузерный модуль не попадал в серверную сборку.
Как установить bundle-conditional
Вручную: положить файлы
.claude/rules/bundle-conditional.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/bundle-conditional.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/bundle-conditional.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/bundle-conditional.mdВручную: положить файлы
.clinerules/bundle-conditional.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о bundle-conditional
Как установить bundle-conditional в Claude Code?
Добавьте файл правила по пути .claude/rules/bundle-conditional.md.
Что делает bundle-conditional?
Правило рекомендует загружать крупные модули и данные только при активации нужной функции. В примере кадры анимации подгружаются через import().
Зачем в правиле проверка typeof window !== 'undefined'?
Она не даёт включить браузерный модуль в серверную сборку при SSR. Это сокращает размер серверного бандла и время сборки.
Исходный текст
bundle-conditional.md · MIT
---
title: Conditional Module Loading
impact: HIGH
impactDescription: loads large data only when needed
tags: bundle, conditional-loading, lazy-loading
---
## Conditional Module Loading
Load large data or modules only when a feature is activated.
**Example (lazy-load animation frames):**
```tsx
function AnimationPlayer({ enabled, setEnabled }: { enabled: boolean; setEnabled: React.Dispatch<React.SetStateAction<boolean>> }) {
const [frames, setFrames] = useState<Frame[] | null>(null)
useEffect(() => {
if (enabled && !frames && typeof window !== 'undefined') {
import('./animation-frames.js')
.then(mod => setFrames(mod.frames))
.catch(() => setEnabled(false))
}
}, [enabled, frames, setEnabled])
if (!frames) return <Skeleton />
return <Canvas frames={frames} />
}
```
The `typeof window !== 'undefined'` check prevents bundling this module for SSR, optimizing server bundle size and build speed.
© tech-leads-club · MIT · tech-leads-club/agent-skills