postfx-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