# object-pooling

Правило object-pooling учит агента переиспользовать снаряды, частицы и NPC из пула, вместо того чтобы создавать и удалять меши каждый кадр.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 4719 у репозитория
- Автор: zebbern
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/three-best-practices/rules/object-pooling.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/object-pooling

## Что делает

Правило задаёт агенту паттерн пула для сцен Three.js: класс `ObjectPool` с `factory`, `reset` и стартовым размером, методы `acquire` и `release`, предварительный прогрев объектов на загрузке. В списке применений — пули, частицы, снаряды, спавн врагов и коллекционные предметы.

Внутри лежит markdown-файл с готовым классом и примером пула пуль. Все меши делят одну геометрию и материал, прячутся через `visible = false` вместо удаления со сцены и возвращаются в пул, когда длина позиции перевалит за 100. Рядом антипаттерн: новый `SphereGeometry` и `MeshBasicMaterial` на каждый спавн внутри `setTimeout`, без освобождения — память растёт.

Сбрасывать состояние при `release` правило просит не зря. Не обнулили `userData.velocity` — следующий снаряд полетит по старой траектории. Примеры написаны на JavaScript под Three.js, в другом движке класс придётся адаптировать.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/object-pooling.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/object-pooling.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/object-pooling.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/object-pooling.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/object-pooling.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/three-best-practices/rules/object-pooling.md

## Когда брать
- переиспользовать снаряды вместо нового меша на каждый выстрел
- убрать паузы сборщика мусора из игрового цикла
- держать память сцены в предсказуемых рамках
- прогреть пул частиц на этапе загрузки
- найти утечку в спавне, где геометрия и материал не освобождаются

## Примеры запросов агенту
- Сделай пул пуль для сцены Three.js: заготовь 50 мешей с общей геометрией и материалом, выдавай через `acquire`, возвращай через `release`.
- Переделай спавн частиц по правилу object-pooling: никаких новых `SphereGeometry` и `MeshBasicMaterial` в игровом цикле.
- Добавь сброс состояния при `release`: обнуляй `userData.velocity` и прячь объект через `visible = false`.

## Похожие
- [webgl-3d-object](https://affpapa.org/nevibecode/skills/webgl-3d-object.md) — скилл · 2000 установок
- [groups-and-containers](https://affpapa.org/nevibecode/skills/groups-and-containers.md) — скилл · 984 установки
- [game-object-components](https://affpapa.org/nevibecode/skills/game-object-components.md) — скилл · 978 установок
- [threejs-performance](https://affpapa.org/nevibecode/skills/threejs-performance.md) — скилл · 7100 установок
- [threejs-game](https://affpapa.org/nevibecode/skills/threejs-game.md) — скилл · 1200 установок
- [add-feature](https://affpapa.org/nevibecode/skills/add-feature.md) — скилл · 1100 установок

Из того же набора: [zebbern/claude-code-guide](https://affpapa.org/nevibecode/by/zebbern/claude-code-guide.md) — 86 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
