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

core-web-vitals — правило для Claude Code: что делает и как установить

Правило core-web-vitals для Claude Code: грузит модели и текстуры в 3D-сценах на Three.js так, чтобы LCP, FID и CLS не проседали. Не даёт тяжёлому 3D тормозить первую отрисовку.

MIT ★ 4 719 обновлён 2026-10-24

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

Что делает core-web-vitals

Правило держит тяжёлый 3D в стороне от критического пути загрузки. Контент ниже первого экрана ждёт срабатывания IntersectionObserver, модули Three.js подключаются через динамический import(), а критичные .glb и .ktx2 получают <link rel="preload">.

Дальше идут готовые фрагменты кода: прогрессивная загрузка с подменой low-res модели на high-res и освобождением старой геометрии, каркасная заглушка на время ожидания, физика в Web Worker, стриминг чанков по положению камеры, Suspense для React Three Fiber. Завершает файл таблица бюджета — стартовый JS до 150KB gzip, hero-модель до 500KB, текстуры до 1MB в KTX2, time to interactive до 3 секунд.

Правило узкое: оно про Three.js, и в проекте без 3D-сцен оптимизировать по нему нечего. Числа из таблицы — ориентиры для ревью, а не порог, который файл где-то включает.

Какие задачи решает

  • убрать 3D-сцену с критического пути загрузки
  • разбить бандл Three.js на динамические импорты
  • показать заглушку, пока грузится модель
  • вынести расчёт физики в Web Worker
  • задать бюджет по весу моделей и текстур

Примеры запросов агенту

  • Проверь загрузку сцены на Three.js по правилу core-web-vitals и покажи, что выходит за бюджет.
  • Переделай загрузку модели: сначала low-res, потом подмена на high-res, старую геометрию освободи через dispose().
  • Вынеси физику из главного потока в Web Worker, как описано в правиле.

Как установить core-web-vitals

Вручную: положить файлы

.claude/rules/core-web-vitals.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о core-web-vitals

Как установить core-web-vitals в Claude Code?

Создайте файл .claude/rules/core-web-vitals.md и вставьте в него текст правила.

Что делает core-web-vitals?

Описывает, как грузить 3D-контент, не портя LCP, FID и CLS: ленивая загрузка ниже первого экрана, код-сплит модулей Three.js, прелоад ассетов, прогрессивная подмена моделей.

Для какого стека подходит правило?

Для сцен на Three.js, в том числе в React через React Three Fiber — для него есть отдельный пример с Suspense. В проекте без 3D-графики применять его не к чему.

Исходный текст

core-web-vitals.md · MIT
# Core Web Vitals & Loading

> Source: [100 Three.js Tips - Utsubo](https://www.utsubo.com/blog/threejs-best-practices-100-tips)

Optimize loading performance to improve LCP, FID, and CLS scores.

## Lazy Load 3D Content Below the Fold

Don't block page load with 3D content that's not visible.

```javascript
const observer = new IntersectionObserver((entries) => {
  if (entries[0].isIntersecting) {
    loadThreeJsScene();
    observer.disconnect();
  }
});

observer.observe(canvasContainer);
```

## Code-Split Three.js Modules

Dynamic imports reduce initial bundle size.

```javascript
// Load Three.js only when needed
const Three = await import('three');
const { GLTFLoader } = await import('three/addons/loaders/GLTFLoader.js');
```

## Preload Critical Assets

Use `<link rel="preload">` for critical resources:

```html
<link rel="preload" href="/model.glb" as="fetch" crossorigin>
<link rel="preload" href="/texture.ktx2" as="fetch" crossorigin>
```

## Progressive Loading

Show low-res content immediately, upgrade when ready:

```javascript
// Show low-res immediately
const lowRes = await loadModel('low.glb');
scene.add(lowRes);

// Load and swap high-res in background
loadModel('high.glb').then(highRes => {
  scene.remove(lowRes);
  lowRes.traverse(child => {
    if (child.geometry) child.geometry.dispose();
    if (child.material) child.material.dispose();
  });
  scene.add(highRes);
});
```

## Placeholder Geometry

Show loading state with placeholder geometry:

```javascript
const placeholder = new THREE.Mesh(
  new THREE.BoxGeometry(1, 1, 1),
  new THREE.MeshBasicMaterial({ color: 0x808080, wireframe: true })
);
scene.add(placeholder);

loadModel().then(model => {
  scene.remove(placeholder);
  placeholder.geometry.dispose();
  placeholder.material.dispose();
  scene.add(model);
});
```

## Offload to Web Workers

Move CPU-intensive work off main thread:

```javascript
// main.js
const worker = new Worker('/physics-worker.js');
worker.postMessage({ positions, velocities });

worker.onmessage = (event) => {
  updatePositions(event.data.positions);
};

// physics-worker.js
self.onmessage = (event) => {
  const result = computePhysics(event.data);
  self.postMessage(result);
};
```

## Stream Large Scenes

Load chunks based on camera position:

```javascript
function updateVisibleChunks(cameraPosition) {
  const visibleChunks = getChunksNear(cameraPosition);

  visibleChunks.forEach(chunk => {
    if (!chunk.loaded) {
      loadChunk(chunk);
    }
  });

  // Unload distant chunks
  loadedChunks.forEach(chunk => {
    if (!visibleChunks.includes(chunk)) {
      unloadChunk(chunk);
    }
  });
}
```

## React Three Fiber: Suspense

```jsx
import { Suspense } from 'react';

function App() {
  return (
    <Canvas>
      <Suspense fallback={<Loader />}>
        <Model />
      </Suspense>
    </Canvas>
  );
}
```

## Performance Budget

| Asset Type | Target |
|------------|--------|
| Initial JS bundle | < 150KB gzipped |
| Hero model | < 500KB compressed |
| Textures | < 1MB total (KTX2) |
| Time to interactive | < 3 seconds |

## Checklist

- [ ] Lazy load 3D content below the fold
- [ ] Code-split Three.js modules
- [ ] Preload critical assets
- [ ] Implement progressive loading
- [ ] Use placeholder geometry during load
- [ ] Offload physics to Web Workers
- [ ] Stream large scenes by chunks
- [ ] Use Suspense in React

© zebbern · MIT · zebbern/claude-code-guide

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

Все правила IDE по теме «Фронтенд и UI» →
performance-and-web-vitals dembrandt Скилл performance-and-web-vitals помогает находить и устранять проблемы с Core Web Vitals и аудитами Lighthouse. Он даёт правила для оптимизации LCP, CLS, INP, изображений, шрифтов и скриптов. CX Codex +1 1 200установок signals-scout-web-vitals PostHog Скилл signals-scout-web-vitals отслеживает p75 LCP, INP, CLS и FCP страниц по событиям PostHog, находит просадки скорости и сопоставляет их с релизами или выкаткой флагов. CX Codex +1 194установок core-web-vitals-tuner patricio0312rev Скилл core-web-vitals-tuner помогает улучшить показатели LCP, INP и CLS с помощью структурированных правок в коде. Они ускоряют рендеринг и отклик страниц. CX Codex +1 322установок core-3d-animation-integration Claude Design Skillstack Субагент core-3d-animation-integration для Claude, который разбирает проекты, где three.js, GSAP, React Three Fiber, Motion и Babylon.js встречаются в одном коде. CX Codex ★ 1 428звёзд репо improve-threejs millionco Скилл improve-threejs для Claude Code находит утечки памяти GPU и просадки FPS в Three.js и React Three Fiber. Включается по запросу аудита или команде /improve-threejs. CX Codex +1 451установок react-three-fiber-architect Claude Design Skillstack Субагент react-three-fiber-architect для проектирования 3D-сцен на React Three Fiber: разбирает архитектуру, ищет узкие места рендера и предлагает план оптимизации. CX Codex ★ 1 428звёзд репо

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

Весь набор →
perf-zustand-selectors Правило perf-zustand-selectors для ИИ-агента: подписка в компоненте идёт на отдельный срез Zustand-стора, поэтому перерисовка случается только при изменении нужных данных. CX Codex +1 ★ 4 719звёзд репо geometry-instanced-mesh Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов. CX Codex +1 ★ 4 719звёзд репо webgpu-renderer Правило webgpu-renderer для Claude Code описывает подключение WebGPU-рендерера Three.js и запасной путь через WebGL 2. Показывает настройку 3D-сцен с вычислениями на GPU. CX Codex +1 ★ 4 719звёзд репо tsl-material-slots tsl-material-slots — правило для Claude Code со справочником слотов TSL в Three.js. Помогает настраивать шейдерную логику через узлы без ошибок в типах и именах свойств. CX Codex +1 ★ 4 719звёзд репо postprocessing-optimization Правило postprocessing-optimization для Three.js и React Three Fiber. Помогает оптимизировать постобработку и объединять шейдерные проходы без просадок FPS. CX Codex +1 ★ 4 719звёзд репо timeline-builder Скилл timeline-builder для Claude Code превращает JSON-данные в интерактивную HTML-хронологию с вертикальной, горизонтальной или двусторонней раскладкой. Отображает этапы проекта, историю выпусков и резюме. CX Codex +1 ★ 4 719звёзд репо loading-suspense Правило loading-suspense требует оборачивать асинхронные компоненты React Three Fiber в Suspense с заглушкой: без границы сцена останется пустой, пока грузится модель или текстура. CX Codex +1 ★ 4 719звёзд репо lighting-shadows-advanced Правило lighting-shadows-advanced для Claude Code настраивает освещение и тени в Three.js с учётом стоимости рендеринга. Оптимизирует тени при множестве источников света. CX Codex +1 ★ 4 719звёзд репо

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

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