2 files changed, 22 insertions, 0 deletions
diff --git a/doc/COMPLETED.md b/doc/COMPLETED.md
index 67f223d..01c4408 100644
--- a/doc/COMPLETED.md
+++ b/doc/COMPLETED.md
@@ -31,6 +31,22 @@ Use `read @doc/archive/FILENAME.md` to access archived documents.
 
 ## Recently Completed (February 11, 2026)
 
+- [x] **Effect Render API Refactor**
+    - **Goal**: Simplify effect API and fix uniform initialization bugs
+    - **Root Cause**: Uniform buffers created but not initialized before bind group creation
+    - **Changes**:
+      - Added `get_common_uniforms()` helper to Effect base class
+      - Refactored all render()/compute() signatures from 5 parameters to single `CommonPostProcessUniforms&`
+      - Fixed uninitialized uniforms in CircleMaskEffect and CNNEffect
+      - Updated 19 effect implementations + headers
+      - Fixed WGSL syntax error in FlashEffect (u.audio_intensity → audio_intensity)
+    - **Impact**:
+      - Cleaner API: construct uniforms once per frame, reuse across effects
+      - More maintainable: changes to CommonPostProcessUniforms don't require updating all call sites
+      - Fixes UV coordinate bug in circle_mask_compute.wgsl
+    - **Result**: All 36 tests passing (100%)
+    - **Docs**: Updated EFFECT_WORKFLOW.md with new render() signature
+
 - [x] **CNN Shader Testing Tool**
     - **Goal**: Offline validation of trained CNN shaders with GPU-to-CPU readback
     - **Implementation**:
diff --git a/doc/EFFECT_WORKFLOW.md b/doc/EFFECT_WORKFLOW.md
index 45c47b7..d68d148 100644
--- a/doc/EFFECT_WORKFLOW.md
+++ b/doc/EFFECT_WORKFLOW.md
@@ -31,6 +31,12 @@ Automated checklist for adding new visual effects to the demo.
 - Post-process effects: inherit from `PostProcessEffect`
 - Scene effects: inherit from `Effect`
 
+**Render Signature:**
+```cpp
+void render(WGPURenderPassEncoder pass,
+            const CommonPostProcessUniforms& uniforms) override;
+```
+
 **Template:** See `tools/shadertoy/template.*` or use `convert_shadertoy.py`
 
 ### 2. Add Shader to Assets