HSDollyCam/project-context.md

project_name	user_name	date	sections_completed	existing_patterns_found
HS_DollyCam	mita	Wed May 06 2026	technology_stack implementation_rules patterns	7

Project Context for AI Agents

This file contains critical rules and patterns that AI agents must follow when implementing code in this project. Focus on unobvious details that agents might otherwise miss.

---

Technology Stack & Versions

• Language: LSL (Linden Scripting Language)
• Platform: Second Life
• Core Communication: llMessageLinked (Linkset Message)
• Configuration: .properties files (e.g., HS_CamEngine.properties)
• Key Components: Specialized LSL scripts (Controller, Playlist, imEngineTour, Core, etc.)

Critical Implementation Rules

• Memory Management (CRITICAL):
  • Avoid large or mixed-type lists to prevent memory pressure.
  • Minimize the use of llParseString2List in hot paths (e.g., timer events or frequent llMessageLinked receivers).
  • Use targeted parsing (token-based or separator-based) for payloads like CE_INT_SET_CAM.
  • Prefer short-lived data and targeted field extraction.
• Communication Protocol:
  • Adhere to the defined CE_INT_* and CE_CMD_* constants for inter-script communication.
  • Use llRegionSayTo for marker communication when the target key is known to reduce region-wide listener wakeups.
• Parsing & Data Handling:
  • For high-frequency updates (e.g., camera frames), use optimized parsing helpers as seen in HS_CamEngineCore.lsl.
  • When reading presets, avoid full string splitting if only a subset of fields is required.
• Workflow Constraints:
  • Keep continuous tour runtime lists in script memory (HS_CamEngineTour.lsl) rather than Linkset Data to ensure performance during timer ticks.

Existing Patterns & Conventions

• Naming Conventions:
  • Scripts follow the HS_Cam[Name].lsl pattern.
  • Communication constants use the CE_CMD_, CE_INT_, MN_CMD, etc., prefixes.
• Code Organization:
  • Modules are split by responsibility (Controller, Playlist, Engine, etc.).
  • Use specialized helper scripts for secondary workflows (e.s. HS_CamTourCommands.lsl) to reduce memory pressure on main scripts.
• Error Handling/Validation:
  • Local checks should include brace-balance and conflict marker searches.
  • Use targeted rg scans to detect accidental reintroductions of inefficient llParseString2List calls.