summaryrefslogtreecommitdiff
path: root/CLAUDE.md
diff options
context:
space:
mode:
Diffstat (limited to 'CLAUDE.md')
-rw-r--r--CLAUDE.md78
1 files changed, 61 insertions, 17 deletions
diff --git a/CLAUDE.md b/CLAUDE.md
index cdc9e0e..f8dcd05 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,27 +1,65 @@
-# 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
+# ============================================
+# 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 Gemini-CLI
@@ -29,3 +67,9 @@ 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
+
+# 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