zriptic/roclicks-skills

Pipeline de jogo Roblox

Um jogo, do início ao fim, com o desenvolvedor aprovando cada portão. Esta skill é o maestro: cada fase nomeia a habilidade ou ferramenta que executa o trabalho, o que essa fase deve produzir e como saber se está concluída. Não reescreva o que essas habilidades já dizem; carregue-as quando a fase delas começar.

SK = esta pasta de skill. PB = um playbook opcional seu: uma pasta (<playbook>/) de lições genéricas organizadas em pastas de tópicos como game-design/, building/, engineering/ e thumbnails/. Se você ainda não tem um, ignore as dicas PB abaixo e comece um à medida que lições surgirem.

Skills companheiras nomeadas abaixo (studify, roblox-ui-maker, roblox-vfx, roblox-game-score, claude-music, uma skill de design-advice, jest-luau, scrapling, agent-browser) e o toolkit meshlab (github.com/zriptic/roclicks-skills, pasta meshlab/) são opcionais. Se alguma não estiver instalada, execute aquela fase diretamente com os mesmos "produz" e portão.

Antes de qualquer coisa

1. Encontre ou crie a pasta do jogo: <projects>/<slug>/. Copie SK/templates/GAME.md para dentro dela como GAME.md. Esse arquivo é a fonte única da verdade: status da fase, decisões, ids de lugar e universo, ids de assets, perguntas em aberto. Atualize-o ao final de cada fase e sempre que uma decisão for tomada. Uma nova sessão neste jogo começa lendo GAME.md.
2. Leia a memória deste jogo e as regras fixas do desenvolvedor. O resumo das regras está em SK/references/rules.md; os fatos medidos do motor e ferramentas estão em SK/references/gotchas.md. Leia ambos antes da primeira chamada ao Studio.
3. Encontre o Studio: use um servidor MCP do Studio para todas as edições (esta skill foi escrita para o servidor MCP comunitário robloxstudio; o servidor oficial embutido Roblox_Studio é usado apenas para upload_image). Verifique qual lugar está aberto antes de cada escrita: frequentemente há vários lugares abertos com o mesmo nome padrão.
4. Planeje as fases que você executará para esta solicitação e diga-as em uma única mensagem: fase, o que produz, qual skill. Pule fases que a solicitação não precisa. Uma recriação de um jogo existente começa na fase 0 com "estudo"; uma ideia totalmente nova começa na fase 0 com "conceito".

As fases

#	Fase	Produz	Skill / ferramenta
0	Conceito / estudo	GAME.md pitch + análise de referência	uma skill de design-advice, SK/references/study-a-game.md, scrapling / agent-browser para pesquisa
1	Design + economia	PLAN.md: loop central, progressão, monetização, números; uma sim de ritmo	skill de design-advice, PB/game-design/*, um script sim/ (Python ou luau)
2	Mundo	Mapa no Studio, estilo de stud, cada peça visível um modelo meshlab	meshlab (SK/references/meshlab.md); código de layout posiciona modelos assados; PB/building/* para ideias de layout
3	Modelos	Cada adereço, construção, veículo e peça de equipamento do personagem como modelos meshlab, assados para MeshData	meshlab (SK/references/meshlab.md, agentes de modelagem paralelos); SDF sculpt para criaturas; Meshy/Blender apenas se o desenvolvedor pedir (SK/references/models.md)
4	Sistemas	Luau servidor/cliente: dados, remotes, loop, produtos	PB/engineering/*, jest-luau para testes, CLI luau para lógica pura
5	UI	Cada tela, HTML primeiro, depois um ScreenGui real	roblox-ui-maker (sempre; leia o LESSONS.md dela)
6	VFX	Efeitos de partícula para cada momento chave	roblox-vfx (leia o LESSONS.md dela)
7	Áudio	Dicas musicais + SFX, SoundGroups	roblox-game-score, claude-music*; mantenha seus ids de som de UI reutilizáveis verificados conforme descrito em SK/references/rules.md
8	QA	Lista de defeitos corrigida; screenshots; tempos de loop	SK/references/qa.md
9	Lançamento	Miniaturas, ícone, produtos, lugar publicado, análises	SK/references/launch.md
10	Operações ao vivo	Análises lidas, próxima atualização planejada	SK/references/launch.md (análises), skill de design-advice

As fases 2-7 podem se sobrepor assim que a fase 1 for aprovada: um mundo e sua UI não esperam um pelo outro. Sistemas (4) são o portão para QA (8).

Portões de fase (o que "concluído" significa)

• 0 → 1: o desenvolvedor concorda com o pitch e o loop central em uma frase cada.
• 1 → construção: PLAN.md aprovado pelo desenvolvedor; a sim mostra o ritmo que ele deseja (primeiro upgrade em menos de um minuto, primeiro rebirth na janela alvo, sem trecho morto). Os números vêm da sim, não de impressões.
• Cada fase de construção: verificado por medição e screenshots, não por "compilou" (veja qa.md). Mostre screenshots ao desenvolvedor, pergunte e escreva o feedback no LESSONS.md da skill responsável (UI, VFX) ou na memória.
• 8 → 9: o loop roda do início ao fim em um playtest sem erros em get_runtime_logs, layout mobile verificado, 12+ screenshots de altura do jogador revisadas.
• 9: nada vai a público sem o sim explícito do desenvolvedor (publicação, uploads, produtos Dev, mudanças de preço).

Executando fases em paralelo (lanes)

Para um grande avanço, use subagentes em segundo plano como lanes (ferramenta Agent), uma por fase independente: mundo, UI, VFX, áudio. Regras e prompts de lane prontos estão em SK/references/lanes.md. O Studio é um único recurso compartilhado: apenas uma lane escreve em um determinado lugar por vez; as outras preparam arquivos (HTML UI, texturas, modelos, música) e os entregam para importação.

Sempre

• Estilo stud por padrão a menos que o briefing ou referência diga o contrário.
• Partículas, não objetos 3D, para efeitos.
• UI HTML-first, ícones apenas do pacote de ícones escolhido do projeto, nunca emojis.
• meshlab constrói tudo visível (regra do desenvolvedor): mundo, adereços, veículos, equipamentos. Peças apenas para colisores invisíveis, triggers, assentos e spawns. Asse para MeshData, e o cliente reconstrói + ApplyMeshes (SK/references/meshlab.md). Sem modelos gratuitos.
• Verifique você mesmo com screenshots e medições antes de mostrar ao desenvolvedor.
• Pergunte antes de gastar (créditos Meshy, uploads, produtos com preço em Robux) e antes de qualquer ação pública.
• Empurre Luau via .rbxmx + import_rbxm, nunca set_script_source para nada com \n em strings (gotchas.md).
• Registre cada decisão, id e lição: GAME.md para este jogo, memória para fatos entre jogos, PB para lições genéricas (sem nomes de jogos ou segredos lá).