bundle-defer-third-party — правило для Claude Code: установка
Правило bundle-defer-third-party запрещает прямо импортировать сторонние трекеры в начальный бандл. Агент оборачивает аналитику и логирование в динамическую загрузку после гидратации.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/bundle-defer-third-party.mdЧто делает bundle-defer-third-party
Правило предписывает выносить некритичные сторонние библиотеки за пределы стартового клиентского бандла. Код систем аналитики, логирования и мониторинга ошибок не должен задерживать отрисовку интерфейса или блокировать взаимодействие пользователя со страницей.
Вместо прямого импорта компонентов вроде @vercel/analytics/react в RootLayout агент настраивает ленивую загрузку. В Next.js для этого используется next/dynamic с флагом ssr: false, поэтому браузер подтягивает скрипт уже после завершения гидратации.
Инструкция ориентирована на код компонентов React и Next.js. Если в проекте нет next/dynamic, предложенный пример кода придётся адаптировать под текущий сборщик или стек.
Какие задачи решает
- Убрать блокировку первичного рендера тяжёлыми скриптами аналитики
- Настроить отложенную загрузку
@vercel/analytics/reactчерезnext/dynamic - Предотвратить попадание трекеров ошибок и логов в базовый бандл приложения
- Отключить серверный рендеринг для некритичных библиотек мониторинга
Примеры запросов агенту
- Проверь
RootLayoutи вынеси сторонние счётчики из основного бандла - Оптимизируй импорт
@vercel/analytics/reactв корневом макете - Настрой ленивую загрузку аналитики без SSR
Как установить bundle-defer-third-party
Вручную: положить файлы
.claude/rules/bundle-defer-third-party.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/bundle-defer-third-party.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/bundle-defer-third-party.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/bundle-defer-third-party.mdВручную: положить файлы
.clinerules/bundle-defer-third-party.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о bundle-defer-third-party
Как установить bundle-defer-third-party в Claude Code?
Сохраните текст правила в файл .claude/rules/bundle-defer-third-party.md внутри вашего репозитория.
Что делает правило bundle-defer-third-party?
Оно указывает ИИ загружать некритичные сторонние библиотеки только после завершения гидратации, чтобы они не блокировали стартовый интерфейс.
Для каких библиотек применяется эта инструкция?
Она предназначена для аналитики, логирования и трекинга ошибок, а в примерах разбирает интеграцию @vercel/analytics/react.
Исходный текст
bundle-defer-third-party.md · MIT
---
title: Defer Non-Critical Third-Party Libraries
impact: MEDIUM
impactDescription: loads after hydration
tags: bundle, third-party, analytics, defer
---
## Defer Non-Critical Third-Party Libraries
Analytics, logging, and error tracking don't block user interaction. Load them after hydration.
**Incorrect (blocks initial bundle):**
```tsx
import { Analytics } from '@vercel/analytics/react'
export default function RootLayout({ children }) {
return (
<html>
<body>
{children}
<Analytics />
</body>
</html>
)
}
```
**Correct (loads after hydration):**
```tsx
import dynamic from 'next/dynamic'
const Analytics = dynamic(
() => import('@vercel/analytics/react').then(m => m.Analytics),
{ ssr: false }
)
export default function RootLayout({ children }) {
return (
<html>
<body>
{children}
<Analytics />
</body>
</html>
)
}
```
© tech-leads-club · MIT · tech-leads-club/agent-skills