robloxstudio-mcp CLAUDE.md

CLAUDE.md — Reglas mandatorias para este proyecto

Entorno

• OS: Windows 11, terminal PowerShell (NO bash)
• Proyecto: Roblox Obby de 20 niveles en Roblox Studio, manipulado via MCP tools

Reglas OBLIGATORIAS

1. PowerShell, NO Bash

• Todos los comandos de terminal DEBEN ser compatibles con PowerShell
• NO usar sintaxis bash (&&, ||, heredocs bash, etc.)
• Usar ; para encadenar comandos, $() para sustitución
• Comillas: usar comillas dobles por defecto en PowerShell

2. Node.js para cálculos y operaciones batch

• Todos los cálculos de gaps, posiciones, y lógica de fix DEBEN ejecutarse como scripts Node.js
• Usar node -e "..." o escribir archivos .js temporales y ejecutar con node script.js
• NUNCA usar .ps1 scripts para lógica compleja
• NUNCA hacer cálculos manuales en el chat — siempre usar código

3. MCP tools — Formato correcto

• set_property con Vector3: usar objeto {"X": n, "Y": n, "Z": n} — NO strings
• mass_get_property NO soporta Vector3 — usar get_instance_properties individual
• mass_set_property NO soporta Vector3 — usar set_property individual
• Máximo ~10 llamadas MCP en paralelo por batch

4. Eficiencia

• NO hacer una llamada MCP por plataforma cuando se puede calcular todo en un script Node.js primero
• Calcular TODOS los cambios necesarios en un solo script, luego aplicar en batch
• Minimizar round-trips: agrupar operaciones

5. Errores conocidos y soluciones

• Error "unexpected EOF while looking for matching": Ocurre al usar comillas simples en node -e dentro de PowerShell. SOLUCIÓN: Escribir el script a un archivo .js temporal y ejecutar con node archivo.js
• Vector3 como string: set_property NO acepta "0, 5, -80". DEBE ser {"X":0, "Y":5, "Z":-80}
• mass_get_property con Vector3: Retorna null/error. Usar get_instance_properties individual
• Bash syntax en PowerShell: && no funciona, heredocs no funcionan. Usar ; o comandos separados

6. Datos del Obby

• 20 niveles (Level_01 a Level_20) + Lobby
• ~135 plataformas total
• Ruta base: game.Workspace.Obby
• KillBricks NO son landable — excluir de cálculos de gaps
• Progresión en eje Z negativo, Y incrementa con altura