EduRRamoss/roblox-rose

Geração assistida de cenários 3D para Roblox Studio, operada como skill do Claude Code via MCP.
The Duskveil, entregue num jogo em produção: bosque de árvores luminosas, ruína com torre e escadaria. 4 887 peças, 216 luzes.
## Visão geral
A ROSE transforma a intenção de um desenvolvedor em cenário 3D construído exclusivamente com parts. O processo é iterativo, e o desenvolvedor decide em cada rodada:
1. Entrevista, começando pelas referências artísticas.
2. Brief com paleta medida, planta e eixos de variação.
3. Exploração com cinco variantes geradas lado a lado no Studio.
4. Autocrítica antes de qualquer apresentação.
5. Refino da variante escolhida.
6. Entrega otimizada no mapa.
7. Aprendizado das preferências do desenvolvedor para as cenas seguintes.
Princípios
| Princípio | Aplicação |
| Receita declarativa | toda cena é um JSON versionado e validado por schema; o gerador Luau a executa de forma determinística por seed |
| Só parts | bloco, cunha, cilindro, CSG; sem Smooth Terrain |
| Elevação em grandes blocos | massas giradas e sobrepostas, com paredões em camadas; sem degraus miúdos em grade |
| Crítica antes da apresentação | variantes com defeito grave ou nota abaixo de 90 são corrigidas ou descartadas sem chegar ao desenvolvedor |
| Medido, não presumido | todo resultado reportado vem de medição no Studio |
| Separação de conhecimento | método, regra do jogo, código do jogo e gosto do desenvolvedor ficam em lugares distintos |
## Arquitetura
mermaid
flowchart LR
C[Claude Code SKILL.md + references] -->|receita JSON| V[validar.js schema]
V --> R[rose.js runner]
R -->|Luau + --#include stdio MCP| S[Roblox Studio Workspace.ROSE]
S -->|medidas| K[criticar.luau 24 detectores]
S -->|capturas| J[juiz.js agente isolado]
K --> C
J --> C
| Componente | Função |
| SKILL.md, references/ | o método: fases, regras e critérios que o Claude segue |
| scripts/rose.js | runner que envia comandos Luau ao StudioMCP.exe por stdio, com a biblioteca injetada; o código não passa pelo contexto da conversa |
| scripts/lib/.luau | o gerador: massa, geografia, relevo, caminhos, estruturas, água, vegetação, acabamento |
| scripts/cmd/.luau | operações no Studio: gerar, criticar, fotografar, entregar, otimizar, auditar |
| scripts/.js | orquestração: rodada, refino, polimento, paleta, planta, canários, juiz |
Os comandos são executados pela própria skill em cada fase; o uso é inteiramente conversacional.
## Fluxo de trabalho
mermaid
flowchart LR
F0[F0 contexto] --> F0b{perfil do jogo?}
F0b -- não --> P[F0b primeira impressão]
F0b -- sim --> F1
P --> F1[F1 entrevista]
F1 --> F2[F2 brief]
F2 --> F3[F3 ativos]
F3 --> F4[F4 exploração]
F4 --> F5[F5 autocrítica]
F5 -- escolha --> F6[F6 refino]
F6 --> F5
F6 --> F7[F7 ajustes]
F7 --> F8[F8 entrega]
F8 --> F9[F9 aprendizado]
| Fase | Descrição |
| F0 · F0b | carrega memória e perfil; em jogo novo, mede o place (escala, kit, pulo) e registra o perfil |
| F1 | entrevista: referências primeiro, depois só o que falta, em blocos de até três perguntas |
| F2 | brief: paleta medida das imagens, planta a partir de contorno, 3–5 decisões grandes, 2 eixos perceptuais; contradições respondidas com a conta |