bundle-dynamic-imports — правило для Claude Code: суть и установка
bundle-dynamic-imports — правило для Claude Code, которое предписывает загружать тяжёлые компоненты через next/dynamic с отключённым SSR, если они не нужны при первой отрисовке. Это уменьшает стартовый бандл и ускоряет первую отрисовку.
лицензия не указана ★ 1 064 обновлён 2026-01-21
.claude/rules/bundle-dynamic-imports.mdЧто делает bundle-dynamic-imports
Правило требует от ассистента откладывать импорт массивных компонентов страницы, которые не нужны в момент первой отрисовки. Вместо прямого import для них используется функция next/dynamic. Подобный подход выносит вспомогательный код из основного клиентского чанка в отдельные файлы.
В правиле приведён шаблон с динамическим вызовом import() и параметром { ssr: false }. Это нужно модулям вроде редакторов кода, работающим только в браузере. Инструкция защищает метрики TTI и LCP от разрастания стартового бандла. Но синтаксис next/dynamic рассчитан исключительно на Next.js, поэтому в других сборщиках директива приведёт к ошибке.
Какие задачи решает
- настроить отложенную загрузку тяжёлых блоков через
next/dynamic - убрать вспомогательный код редактора или виджета из основного чанка
- предотвратить ухудшение метрик TTI и LCP из-за раздутого бандла
- отключить серверный рендеринг для сугубо клиентских интерфейсов
Примеры запросов агенту
- Добавь компонент редактора на страницу статьи через динамический импорт
- Отрефактори импорты в
monaco-panel.tsx, чтобы тяжёлый модуль не попадал в стартовый бандл - Сделай отложенную загрузку графиков в панели аналитики без SSR
Как установить bundle-dynamic-imports
Вручную: положить файлы
.claude/rules/bundle-dynamic-imports.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/bundle-dynamic-imports.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/bundle-dynamic-imports.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/bundle-dynamic-imports.mdВручную: положить файлы
.clinerules/bundle-dynamic-imports.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о bundle-dynamic-imports
Как установить bundle-dynamic-imports в Claude Code?
Сохраните файл правила по пути .claude/rules/bundle-dynamic-imports.md в корне вашего проекта. Ассистент будет автоматически учитывать его при генерации кода.
Что делает правило bundle-dynamic-imports?
Оно запрещает статический импорт массивных компонентов и заставляет агента применять next/dynamic. В результате тяжёлые модули скачиваются по требованию, а не блокируют первичную загрузку.
Зачем в динамическом импорте задаётся ssr: false?
Параметр отключает рендеринг компонента на сервере. Это защищает от ошибок гидратации модули, которым нужен доступ к объектам браузера вроде window или document.