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

bundle-conditional — правило для Claude Code: загрузка по условию

Правило bundle-conditional предлагает загружать крупные модули только при активации функции. Оно пригодится для отложенной загрузки данных и сокращения серверного бандла при SSR.

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

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

Что делает 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 и 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

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

Все правила IDE по теме «Фронтенд и UI» →
next-bundle-optimizer vercel Скилл next-bundle-optimizer для Claude Code и других агентов: аудирует начальную загрузку Next.js, находит медленные маршруты, раздутые клиентские бандлы и дублирующиеся зависимости. CX Codex +1 4 800установок 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звёзд репо import-on-visibility patterns.dev Скилл import-on-visibility для Claude Code учит агента откладывать загрузку компонентов и картинок до появления в области просмотра. Ускоряет отрисовку первого экрана. CX Codex +1 1 700установок import-on-interaction patterns.dev Скилл import-on-interaction учит агента откладывать загрузку тяжёлых компонентов и виджетов до клика, наведения или ввода в форму. CX Codex +1 1 700установок bundle-analyzable-paths fcakyon Правило bundle-analyzable-paths просит оставлять пути импортов и файлов понятными для статического анализа. Это помогает не расширять сборку и трассировку файлов без необходимости. CX Codex +1 ★ 1 216звёзд репо

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

Весь набор →
best-practices Скилл best-practices для Claude Code проверяет веб-код на проблемы безопасности, совместимости с браузерами и качества. Запускается по запросу на аудит или модернизацию кода. CX Codex +1 ★ 7 191звёзд репо js-index-maps Правило js-index-maps заменяет повторные .find() по одному ключу на индекс Map. Оно пригодится при частых поисках в массивах. CX Codex +1 ★ 7 191звёзд репо rendering-hydration-suppress-warning Правило rendering-hydration-suppress-warning гасит предупреждения гидратации там, где сервер и клиент намеренно показывают разное: даты, случайные ID, форматирование по локали. CX Codex +1 ★ 7 191звёзд репо bundle-defer-third-party Правило bundle-defer-third-party запрещает прямо импортировать сторонние трекеры в начальный бандл. Агент оборачивает аналитику и логирование в динамическую загрузку после гидратации. CX Codex +1 ★ 7 191звёзд репо react19-no-forwardref Правило react19-no-forwardref напоминает о двух ключевых изменениях в React 19: ref теперь обычный проп (без forwardRef), а use() заменяет useContext(). Подходит для проектов, переходящих на React 19. CX Codex +1 ★ 7 191звёзд репо advanced-init-once Правило advanced-init-once запрещает запускать глобальную инициализацию приложения в useEffect([]) компонентов и предлагает использовать флаг на уровне модуля или код в точке входа. CX Codex +1 ★ 7 191звёзд репо rerender-defer-reads Правило rerender-defer-reads подсказывает читать динамическое состояние в момент действия, если компонент использует его только внутри callback. Это сокращает лишние подписки. CX Codex +1 ★ 7 191звёзд репо rendering-conditional-render Правило rendering-conditional-render предотвращает случайный рендер нулей и NaN в JSX. Использует явные тернарные операторы вместо && для проверок, чтобы falsy-значения не попадали в DOM. CX Codex +1 ★ 7 191звёзд репо

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

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