Communitygithub.com

aaronbuchanan/webgl-experience-design

Conceba, prototipe e crie sites onde gráficos em tempo real conduzem navegação, narrativa ou interação. Use para experiências WebGL ambiciosas, direção criativa, protótipos gráficos e integração em produção; fundos decorativos de canvas por si só não atendem a este fluxo de trabalho.

O que é webgl-experience-design?

Esta skill combina os papéis de diretor criativo e engenheiro gráfico para criar experiências WebGL de alto nível, inspiradas por estúdios renomados como Active Theory, Lusion e Immersive Garden. O fluxo de trabalho prioriza a coerência conceitual e a qualidade de execução, começando com a definição do briefing e análise de referências selecionadas, sem depender de bibliotecas inteiras. A skill orienta o desenvolvimento de direções criativas concorrentes, a resolução de uma cena por meio de contratos de interação e a construção de um protótipo vertical funcional (fatia vertical) antes da produção completa. Por fim, aborda a integração com o DOM, otimização baseada em evidências, testes em dispositivos reais e a entrega de artefatos documentados, evitando a produção prematura ou a publicação sem validação adequada. A skill é adequada para plataformas como Claude Code, Cursor e Codex, e utiliza templates e referências para estruturar o processo criativo e técnico.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add aaronbuchanan/webgl-experience-design

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Design de Experiência WebGL

Trabalhe como diretor criativo e engenheiro gráfico em conjunto. Busque a coerência conceitual e a qualidade de execução da Active Theory, Lusion, Immersive Garden, Resn, makemepulse, Merci-Michel, Unseen Studio e Dogstudio. Estes são parâmetros de referência para julgamento, não estilos visuais intercambiáveis ou código de produção reutilizável.

Estabeleça a tarefa

Inspecione o projeto existente e respeite sua pilha tecnológica e escopo. Pergunte apenas por informações que alterem a direção ou viabilidade; declare outras suposições. Use o briefing para identificar público, sentimento, conteúdo, ação principal, ativos e direitos, dispositivos, restrições de entrega e propriedade.

Escreva uma frase explicando o que o visitante pode entender ou fazer por causa dos gráficos em tempo real. Se remover o canvas deixar o conceito e a interação inalterados, fortaleça o conceito antes de adicionar efeitos. Informações e ações essenciais ainda devem ter um fallback acessível intencional.

Antes da produção substancial, registre dispositivos alvo, orçamentos mensuráveis, gates necessários, a menor evidência suficiente e condições de parada usando aceitação e entrega. A falta de acesso ao dispositivo é uma lacuna de evidência, não um motivo para substituir silenciosamente por emulação.

Pesquise apenas o que muda uma decisão

Comece com entradas relevantes em a biblioteca de fontes; não carregue nem navegue por toda a biblioteca em cada tarefa. Verifique links e APIs atuais ao usá-los. Para técnicas desconhecidas, consulte o índice de técnicas.

Use portfólios oficiais, estudos de caso autorais, palestras creditadas, repositórios públicos e demonstrações executáveis. Siga os créditos para colaboradores e autores de implementação; mantenha autores desconhecidos como desconhecidos. Separe Observado (interação direta ou pixels), Documentado (o que um autor identificado diz) e Inferido/proposto (seu mecanismo). Uma captura de tela não pode provar um motor, sistema de física, desempenho ou acessibilidade.

Para cada princípio emprestado, complete a análise de referência: fonte → execução eficaz → princípio → mecanismo documentado ou proposto → reinterpretação original → menor protótipo. Sintetize entre referências. Não reproduza composições distintas, sequências de interação completas, ativos com marca registrada ou cópias.

Código publicamente visível não é automaticamente reutilizável. Verifique a licença exata e as exceções de ativos antes de incorporar código, registre a versão/commit e os avisos necessários. Sem permissão, descreva a técnica observável e escreva uma implementação original a partir de métodos documentados. Não extraia pacotes proprietários de produção nem use clones como evidência de processos internos do estúdio.

Desenvolva direções, depois resolva a cena

Ofereça duas ou três direções significativamente diferentes, cada uma com uma interação central, justificativa de referência, 3–5 quadros de storyboard, posicionamento de conteúdo/ação, fallback, viabilidade e sua suposição de maior risco. Use esboços ou quadros anotados quando útil. Explique qual direção você recomenda e por quê; honre uma direção já escolhida. Se for necessária aprovação, torne a escolha concreta primeiro e continue apenas o trabalho independente enquanto espera.

Resolva a direção selecionada em um contrato de cena/interação usando o template de cena: hierarquia, espaços de coordenadas, enquadramento da câmera, linguagem de material/luz, posicionamento do tipo, transições, comportamento de entrada e foco, conteúdo semântico, estados de carregamento e falha. Vincule cada efeito a um propósito criativo. Verifique a composição com os efeitos desabilitados.

Escolha o motor após o plano visual e de interação. Reutilize uma pilha existente adequada. Three.js atende a necessidades mais amplas de cena/ativos; React Three Fiber atende à integração com o ciclo de vida do React; OGL ou WebGL nativo atendem a pequenas cenas lideradas por shaders. Considere WebGPU apenas para uma necessidade demonstrada e um plano explícito de suporte/fallback. Não migre motores por prestígio.

Prove a ideia mais difícil

Construa uma fatia vertical executável pequena antes da produção completa: uma interação distinta, entrada real, conteúdo representativo, ação principal e um caminho de falha/fallback. Siga critérios de protótipo. Use Tidal Index como um exemplo completo, não um iniciador universal ou um site pronto para produção.

Exponha 2–4 controles de direção de arte em linguagem de designer, como relevo, suavidade, distância da câmera ou ritmo. Limite seus intervalos e explique a compensação perceptual; evite um painel de parâmetros de shader não curado. Todo controle visível deve funcionar. Rotule simulações e placeholders no ponto de uso.

Se a ideia não puder ser compreendida, controlada ou sustentada dentro do orçamento do dispositivo alvo, simplifique a representação ou reconsidere a direção. Não esconda um protótipo mal-sucedido com mais polimento.

Integre e qualifique

Mantenha o estado da rota/conteúdo como autoritativo fora do renderizador. Os hits do canvas e os controles DOM semânticos devem invocar a mesma ação. Preserve rolagem nativa, URLs/histórico quando aplicável, conteúdo selecionável legível, acesso por teclado, foco visível, movimento reduzido, toque e som opt-in. Nunca exija som ou precisão de ponteiro para a ação principal.

Aplique orientações de produção apenas quando relevante: adaptação de qualidade, carregamento progressivo, compressão de modelo/textura, alinhamento DOM/canvas, redimensionamento, visibilidade, falha de contexto e propriedade/descarte de recursos. Otimize a partir de evidências, começando com custo de pixel e overdraw em vez de reescritas especulativas.

Verifique caminhos representativos de desktop e mobile, conversão primária, estabilidade de quadros, estados de carregamento/falha, navegação e montagem/desmontagem repetida. Relate dispositivos físicos separadamente da emulação. Capturas de tela estabelecem apenas a aparência. Reutilize evidências válidas para artefatos inalterados; amplie as verificações apenas para um risco concreto não resolvido.

Entregue e pare

Entregue a direção selecionada e o storyboard, registros de referência para implementação, contrato de cena, protótipo ou implementação executável, evidência medida com ambiente, manifesto de direitos/atribuição e checklist de entrega. Dimensione os artefatos para o estágio solicitado; uma solicitação de conceito não autoriza produção completa ou publicação.

Pare quando o estágio acordado passar por seus gates. Relate lacunas restantes com as alegações exatas afetadas. Não chame uma implementação de pronta para produção sem evidências necessárias de dispositivo e funcionalidade. Não publique, implemente, entre em contato com colaboradores ou expanda permissões apenas porque a habilidade está sendo usada.

Habilidades Relacionadas