--- name: postfx-router description: Router for Three.js post-processing effects domain. Use when implementing visual effects like bloom, glow, chromatic aberration, vignette, depth of field, color grading, or any screen-space effects. Routes to 3 specialized skills for bloom, effects, and composer setup. --- # Post-Processing Router Routes to 3 specialized skills based on post-processing requirements. ## Routing Protocol 1. **Classify** — Identify effect type from user request 2. **Match** — Apply signal matching rules below 3. **Combine** — Most production scenes need 2-3 skills together 4. **Load** — Read matched SKILL.md files before implementation ## Quick Route ### Tier 1: Core (Start Here) | Need | Skill | Signals | |------|-------|---------| | Pipeline setup, effect ordering | `postfx-composer` | EffectComposer, setup, pipeline, render target, custom pass, multi-pass | | Glow, luminance effects | `postfx-bloom` | bloom, glow, neon, emissive, luminance, UnrealBloom, selective bloom | | Cinematic polish, color | `postfx-effects` | vignette, chromatic, DOF, grain, color grade, LUT, aberration | ## Signal Matching ### Primary Signals **postfx-composer** (always start here for new projects): - "set up post-processing" - "configure effect pipeline" - "create custom effect/pass" - "render targets", "effect ordering" **postfx-bloom**: - "bloom", "glow", "luminance", "neon", "emissive" - "selective bloom", "object glow", "UnrealBloomPass" **postfx-effects**: - "chromatic aberration", "vignette", "depth of field", "DOF" - "film grain", "noise", "color grading", "LUT", "tone mapping" - "scanlines", "CRT", "god rays" ### Confidence Scoring - **High (3+ signals)** — Route directly to matched skill - **Medium (1-2 signals)** — Route with composer as foundation - **Low (0 signals)** — Start with `postfx-composer` for setup ## Common Combinations ### Basic Post-Processing Setup (2 skills) ``` postfx-composer → Pipeline architecture, effect ordering postfx-bloom → Basic glow effects ``` ### Cinematic Scene (3 skills) ``` postfx-composer → Pipeline setup, tone mapping postfx-bloom → Subtle glow on lights postfx-effects → Vignette, grain, color grading ``` ### Neon/Cyberpunk Aesthetic (2 skills) ``` postfx-bloom → High-intensity selective bloom postfx-effects → Chromatic aberration, vignette ``` ### Custom Effect Development (1-2 skills) ``` postfx-composer → Custom Effect class, shader writing postfx-effects → Reference existing effects ``` ## Decision Table | Effect Type | Complexity | Primary Skill | Supporting Skill | |-------------|------------|---------------|------------------| | Glow/bloom only | Simple | bloom | composer | | Cinematic look | Medium | effects | composer + bloom | | Custom effect | Complex | composer | - | | Selective bloom | Medium | bloom | composer | | Color grading | Simple | effects | composer | | Full production | Complex | All three | - | ## Effect Categories ### Lighting Effects → postfx-bloom - Bloom/glow, selective bloom, emissive enhancement, HDR luminance ### Camera Effects → postfx-effects - Chromatic aberration, vignette, depth of field, lens distortion ### Color Effects → postfx-effects - Tone mapping, color grading, LUT, hue/saturation ### Texture Effects → postfx-effects - Film grain, noise, scanlines, CRT ### Architecture → postfx-composer - EffectComposer setup, effect ordering, custom effects, render targets ## Integration with Other Domains ### With R3F (r3f-*) ``` r3f-fundamentals → Scene setup postfx-composer → Effect pipeline postfx-bloom → Object glow ``` ### With Shaders (shaders-*) ``` shaders-glsl → Custom effect shader code postfx-composer → Wrap in Effect class ``` ### With Particles (particles-*) ``` particles-systems → Particle emitters postfx-bloom → Particle glow postfx-effects → Atmosphere ``` ### With Audio (audio-*) ``` audio-analysis → Frequency data postfx-bloom → Audio-reactive bloom postfx-effects → Audio-reactive aberration ``` ## Quick Reference | Effect | Skill | |--------|-------| | Bloom | `postfx-bloom` | | Selective Bloom | `postfx-bloom` | | Vignette | `postfx-effects` | | Chromatic Aberration | `postfx-effects` | | Depth of Field | `postfx-effects` | | Film Grain/Noise | `postfx-effects` | | Color Grading | `postfx-effects` | | LUT | `postfx-effects` | | Tone Mapping | `postfx-effects` | | Custom Effects | `postfx-composer` | | Render Targets | `postfx-composer` | ## Temporal Collapse Stack ``` postfx-composer → HDR pipeline, tone mapping, adaptive quality postfx-bloom → Cosmic glow on digits, particles, UI postfx-effects → Vignette (void edge), subtle chromatic, grain ``` ## Fallback Behavior - **No framework context** → Assume @react-three/postprocessing - **Unclear effect type** → Start with `postfx-composer` + `postfx-bloom` - **Performance concerns** → Prioritize `postfx-composer` optimization patterns