docs: Sync GEMINI.md with CLAUDE.md structure

Add EFFECT_WORKFLOW.md to Tier 2, update Tier 3/4 references, refresh state snapshot.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

1 files changed, 39 insertions, 39 deletions

diff --git a/GEMINI.md b/GEMINI.md
index 6fa2692..14ac2e6 100644
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -11,6 +11,7 @@
 @doc/HOWTO.md
 @doc/CONTRIBUTING.md
 @doc/AI_RULES.md
+@doc/EFFECT_WORKFLOW.md
 
 # ============================================
 # TIER 3: DESIGN DOCS (Load On-Demand)
@@ -18,27 +19,26 @@
 # Load these only when working on specific subsystems:
 #
 # Audio & Tracker:
-#   @doc/SPEC_EDITOR.md - Spectral editor design
-#   @doc/TRACKER.md - Audio tracker system
-#   @doc/ANALYSIS_VARIABLE_TEMPO_V2.md - Variable tempo analysis
+#   doc/SPECTRAL_BRUSH_EDITOR.md - Spectral editor design
+#   doc/TRACKER.md - Audio tracker system
 #
 # 3D & Graphics:
-#   @doc/3D.md - 3D rendering architecture
-#   @doc/PROCEDURAL.md - Procedural generation
+#   doc/3D.md - 3D rendering architecture
+#   doc/PROCEDURAL.md - Procedural generation
 #
 # Build & Assets:
-#   @doc/ASSET_SYSTEM.md - Asset pipeline details
-#   @doc/BUILD.md - Build system details
-#   @doc/FETCH_DEPS.md - Dependency management
+#   doc/ASSET_SYSTEM.md - Asset pipeline details
+#   doc/BUILD.md - Build system details
+#   doc/FETCH_DEPS.md - Dependency management
 #
 # Testing & Tools:
-#   @doc/test_demo_README.md - test_demo tool documentation
+#   doc/test_demo_README.md - test_demo tool documentation
 #
 # Architecture & Reference:
-#   @doc/ARCHITECTURE.md - Detailed system architecture
-#   @doc/CODING_STYLE.md - Code style examples
-#   @doc/BACKLOG.md - Untriaged future goals
-#   @doc/TOOLS_REFERENCE.md - Developer tools reference
+#   doc/ARCHITECTURE.md - Detailed system architecture
+#   doc/CODING_STYLE.md - Code style examples
+#   doc/BACKLOG.md - Untriaged future goals
+#   doc/TOOLS_REFERENCE.md - Developer tools reference
 
 # ============================================
 # TIER 4: HISTORICAL ARCHIVE (Load Rarely)
@@ -49,19 +49,19 @@
 #   Use: "read @doc/COMPLETED.md" for detailed history
 #
 # Technical Investigations:
-#   @doc/GPU_EFFECTS_TEST_ANALYSIS.md
-#   @doc/PLATFORM_ANALYSIS.md
-#   @doc/PLATFORM_SIDE_QUEST_SUMMARY.md
-#   @doc/PEAK_FIX_SUMMARY.md
+#   doc/GPU_EFFECTS_TEST_ANALYSIS.md
+#   doc/PLATFORM_ANALYSIS.md
+#   doc/PLATFORM_SIDE_QUEST_SUMMARY.md
+#   doc/PEAK_FIX_SUMMARY.md
+#   doc/CNN_DEBUG.md - CNN post-processing binding bug resolution
 #
 # Agent Handoffs:
-#   @doc/HANDOFF_CLAUDE.md
-#   @doc/HANDOFF.md
-#   @doc/HANDOFF_2026-02-04.md
-
+#   doc/HANDOFF_CLAUDE.md
+#   doc/HANDOFF.md
+#   doc/HANDOFF_2026-02-04.md
 #
 # Task Tracking:
-#   @doc/TASKS_SUMMARY.md
+#   doc/TASKS_SUMMARY.md
 
 # ============================================
 # PROJECT RULES (IMPORTANT)
@@ -74,7 +74,6 @@ IMPORTANT:
 - Work only on tasks explicitly requested by the user
 - Do NOT modify files outside the current scope
 - Do NOT perform refactors or cleanups unless explicitly asked
-- **Always use `-j4` for all `cmake --build` commands.**
 - Concise answers only
 - No explanations unless asked
 - Max 100 tokens per reply
@@ -90,36 +89,37 @@ IMPORTANT:
 # ============================================
 <state_snapshot>
     <overall_goal>
-        Begin work on Task #75: WGSL Uniform Buffer Validation & Consolidation to prevent future alignment bugs.
+        Multi-workspace demo system operational. Focus on Priority 1: Spectral Brush Editor (Task #5).
     </overall_goal>
 
     <active_constraints>
-        - All tests are passing (33/33), removing the previous blocker.
+        - All tests passing (36/36 - 100%)
+        - Size-sensitive: 64k target
     </active_constraints>
 
     <key_knowledge>
-        - The `DemoEffectsTest` SEGFAULT has been resolved. The entire test suite is now passing.
-        - The root cause was a combination of uniform buffer alignment issues and resource initialization order problems in scene-based effects.
-        - Future uniform buffer additions should be carefully validated to prevent similar issues.
+        - Workspace system complete (Task #77): Easy switching with -DDEMO_WORKSPACE=<name>
+        - CNN post-processing validated in demo (CNNEffect working)
+        - Uniform buffer guidelines established (doc/UNIFORM_BUFFER_GUIDELINES.md)
+        - 3D: Binary scene loader operational, shader SDF integration pending
     </key_knowledge>
 
     <artifact_trail>
-        - `GEMINI.md`: This file, updated to reflect the new project state.
-        - `src/tests/test_demo_effects.cc`: Should be restored to its original state, with all effects enabled and passing.
-        - `TODO.md`: Shows Task #74 is complete and Task #75 is the next priority.
+        - `GEMINI.md`: This file, synchronized with CLAUDE.md structure
+        - `PROJECT_CONTEXT.md`: Current system status
+        - `TODO.md`: Active priorities (Task #5 in progress)
     </artifact_trail>
 
     <recent_actions>
-        - Completed Task #75: WGSL Uniform Buffer Validation & Consolidation.
-        - Standardized uniform usage across effects (Distort, Fade, ThemeModulation, CircleMask).
-        - Created and integrated `tools/validate_uniforms.py` into the build system.
-        - Added `doc/UNIFORM_BUFFER_GUIDELINES.md` and updated `CONTRIBUTING.md`.
+        - Completed Task #77: Workspace System
+        - Completed Task #75: WGSL Uniform Buffer Validation
+        - Completed Task #74: DemoEffectsTest SEGFAULT fix
     </recent_actions>
 
     <task_state>
-        1. [COMPLETED] Task #74: Fix `DemoEffectsTest` SEGFAULT.
-        2. [COMPLETED] Task #75: WGSL Uniform Buffer Validation & Consolidation.
-        3. [PAUSED] Task #5: Spectral Brush Editor.
-        4. [PAUSED] Task #18: 3D System Enhancements.
+        1. [IN PROGRESS] Task #5: Spectral Brush Editor (Priority 1)
+        2. [COMPLETED] Task #77: Workspace System
+        3. [PENDING] Task #18: 3D System Enhancements (Priority 3)
+        4. [RECURRENT] Task #50: WGSL Modularization (Priority 4)
     </task_state>
 </state_snapshot>
\ No newline at end of file