summaryrefslogtreecommitdiff
path: root/GEMINI.md
diff options
context:
space:
mode:
Diffstat (limited to 'GEMINI.md')
-rw-r--r--GEMINI.md92
1 files changed, 70 insertions, 22 deletions
diff --git a/GEMINI.md b/GEMINI.md
index b828621..c57c12d 100644
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -1,34 +1,82 @@
-# Project Context
+# ============================================
+# TIER 1: CRITICAL CONTEXT (Always Loaded)
+# ============================================
@PROJECT_CONTEXT.md
@TODO.md
-
-# helping and quick-start tutorials
@README.md
-@doc/HOWTO.md
-# design docs
-@doc/ASSET_SYSTEM.md
-@doc/BUILD.md
-@doc/FETCH_DEPS.md
-@doc/3D.md
-@doc/SPEC_EDITOR.md
-@doc/TRACKER.md
-@doc/PROCEDURAL.md
-@doc/ANALYSIS_VARIABLE_TEMPO.md
-@doc/ANALYSIS_VARIABLE_TEMPO_V2.md
-
-# coding guidelines
+# ============================================
+# TIER 2: TECHNICAL REFERENCE (Always Loaded)
+# ============================================
+@doc/HOWTO.md
@doc/CONTRIBUTING.md
@doc/AI_RULES.md
-# AI rules
+# ============================================
+# 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:
+# @doc/COMPLETED.md - Detailed milestone 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
-follow rules in AI_RULES.md !
-You are working in a repo shared with Claude-Code.
-Work only on the tasks explicitly requested.
-Do not modify files outside the current scope.
+# 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
+# ============================================
+# CURRENT STATE SNAPSHOT (Gemini-Specific)
+# ============================================
<state_snapshot>
<overall_goal>
Evolve the demo into a robust 3D engine with dynamic physics, BVH acceleration, and a modular shader architecture, targeting a 64k binary limit.