feat: Implement dual-mode asset loading and update documentation

This commit introduces a dual-mode asset loading system to enhance developer workflow and optimize release builds.

Key changes include:
- **Dual-Mode Asset Loading:** Assets are now loaded from disk during development (when  is OFF) for faster iteration, particularly for heavy assets like  and  files. For release builds ( ON), all assets are embedded directly into the binary, ensuring a single, self-contained executable.
- **Explicit Asset Typing:** Replaced generic  asset type with specific types (, , , , ) in  and the  enum in  for clearer categorization and more robust processing.
- **Build System Integration:** Modified  to pass a  flag to  in development builds.
- **Asset Packer Updates:**  now generates file paths for disk-loaded assets and embeds data for others based on the build mode.
- **Asset Manager Enhancements:**  includes new logic in  for loading and caching disk-based assets and updates to  for proper memory deallocation.
- **Documentation:** Updated  to reflect the new asset nomenclature and dual-mode loading strategy.
- **Project Rules:** Added a concise rule to  mandating top-level documentation updates for medium/large sub-system changes.

handoff(Gemini): Implemented dual-mode asset loading and updated documentation.

1 files changed, 1 insertions, 0 deletions

diff --git a/doc/AI_RULES.md b/doc/AI_RULES.md
index 5500a9a..27d2d47 100644
--- a/doc/AI_RULES.md
+++ b/doc/AI_RULES.md
@@ -4,6 +4,7 @@
 - All changes must keep tests passing
 - Prefer small, reviewable commits
 - All `cmake --build` commands must use the `-j4` option for parallel building.
+- Medium/large sub-system changes require top-level doc update (summarize, streamline, archive).
 - after a task, a 'big' final commit should contain a short handoff tag like "handoff(Gemini):..." if you're gemini-cli, or "handoff(Claude): ..." if you're claude-code.
 
 ## Adding Visual Effects