r3f-scene-architect
Installation
SKILL.md
r3f-scene-architect
Purpose
Own the shape of a react-three-fiber scene: how the component tree maps to the Three.js scene graph, what runs each frame and in what order, how repeated objects are drawn, and how GPU resources are created and released. A scene that is architected well stays at frame budget as it grows and does not leak across mounts. This skill is the spine the other r3f skills build on — settle structure before reaching for materials, lights, or post-processing.
Use when
- Starting a new scene and deciding the component/module boundaries.
- A scene has accreted dozens of
useFramehooks, prop-drilled refs, or ad-hoc state. - Frame time is uneven and you suspect the update loop, not the GPU.
- Many similar meshes exist (nodes, particles, tiles) without instancing or pooling.
- Objects, geometries, materials, or textures may not be disposed on unmount/scene change.
- You are about to add effects and want the foundation checked first.