core-web-vitals — правило для Claude Code: что делает и как установить
Правило core-web-vitals для Claude Code: грузит модели и текстуры в 3D-сценах на Three.js так, чтобы LCP, FID и CLS не проседали. Не даёт тяжёлому 3D тормозить первую отрисовку.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/core-web-vitals.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/core-web-vitals.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/core-web-vitals.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/core-web-vitals.mdВручную: положить файлы
.clinerules/core-web-vitals.mdПо шагам, с командами для каждой платформы: 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