blob: a9de297c312a1fb7a1cd29bda68b4a212a21241e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
# ============================================
# TIER 1: CRITICAL CONTEXT (Always Loaded)
# ============================================
@PROJECT_CONTEXT.md
@TODO.md
@README.md
# ============================================
# TIER 2: TECHNICAL REFERENCE (Always Loaded)
# ============================================
@doc/HOWTO.md
@doc/CONTRIBUTING.md
@doc/AI_RULES.md
# ============================================
# TIER 3: DESIGN DOCS (Load On-Demand)
# ============================================
# 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
#
# 3D & Graphics:
# @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
#
# Testing & Tools:
# @doc/test_demo_README.md - test_demo tool documentation
# ============================================
# TIER 4: HISTORICAL ARCHIVE (Load Rarely)
# ============================================
# Load these only for historical context or debugging:
#
# Completion History:
# 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
#
# Agent Handoffs:
# @doc/HANDOFF_CLAUDE.md
# @doc/HANDOFF.md
# @doc/HANDOFF_2026-02-04.md
#
# Task Tracking:
# @doc/TASKS_SUMMARY.md
# ============================================
# PROJECT RULES (IMPORTANT)
# ============================================
IMPORTANT:
- Follow all rules in doc/AI_RULES.md
- This repository is shared with Claude-Code
- You are working in turns with another AI agent
- 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
# Context Maintenance:
- See @doc/CONTEXT_MAINTENANCE.md for keeping context clean
- Archive completed work to doc/COMPLETED.md regularly
- Keep PROJECT_CONTEXT.md focused on current status
- Keep TODO.md focused on active/next tasks only
# ============================================
# CURRENT STATE SNAPSHOT (Gemini-Specific)
# ============================================
<state_snapshot>
<overall_goal>
Begin work on Task #75: WGSL Uniform Buffer Validation & Consolidation to prevent future alignment bugs.
</overall_goal>
<active_constraints>
- All tests are passing (33/33), removing the previous blocker.
</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.
</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.
</artifact_trail>
<recent_actions>
- Finished debugging and fixing the `DemoEffectsTest` SEGFAULT.
- Confirmed that all 33 tests are passing.
- Updated `GEMINI.md` to reflect the successful completion of Task #74 and set the stage for Task #75.
</recent_actions>
<task_state>
1. [COMPLETED] Task #74: Fix `DemoEffectsTest` SEGFAULT.
2. [IN PROGRESS] Task #75: WGSL Uniform Buffer Validation & Consolidation.
3. [PAUSED] Task #5: Spectral Brush Editor.
4. [PAUSED] Task #18: 3D System Enhancements.
</task_state>
</state_snapshot>
|
