O que é Diorama?
O Diorama é um manual que um agente de programação lê antes de montar uma pequena cena 3D no navegador: um cenário sobre uma base, visto de uma câmera em três quartos que você pode girar, com bonecos em escala de brinquedo que andam, nadam ou lutam. A cena é desenhada com Three.js e finalizada em um de três visuais: pixel art (uma paleta de 64 cores com pontilhado e contorno a nanquim), toon com traço, ou os dois combinados.
O núcleo é o SKILL.md, um longo arquivo de instruções com frontmatter de skill (nome, descrição, versão 5.7.0), para que o Claude Code e outros agentes compatíveis com skills possam carregá-lo pelo nome. Em volta ficam arquivos temáticos em references/ para sessões longas, módulos JavaScript para copiar em templates/ (câmera, iluminação, rigs, água, efeitos) e oito scripts de QA que controlam o Chromium para capturar e pontuar quadros congelados.
É JavaScript sob licença MIT de Nehal Kanak (sloemo), criado em 24 de outubro de 2026, com cerca de 656 estrelas e 61 forks. Instala-se pelo npm como @sloemo/diorama, que registrou 1.913 downloads na semana até 17 de novembro de 2026.
Diorama vale a pena?
O Diorama é menos uma biblioteca de código e mais um contrato sobre como um agente deve trabalhar, e essa é a sua força. Antes da primeira malha, o agente precisa fazer duas perguntas, qual visual usar e se os modelos vêm de bibliotecas licenciadas ou são feitos à mão, e depois pesquisar o tema real em vídeo, registrar cada busca de recursos em SOURCES.md e anotar as licenças em CREDITS.md. Recursos não comerciais, sem obras derivadas ou sem licença declarada são um bloqueio total. Poucas skills de agente levam a procedência tão a sério.
O desenho da verificação é o outro motivo para olhar. Cada cena é uma função pura do tempo, então ?t=12.4 sempre mostra o mesmo quadro, e os scripts em templates/qa/ o congelam, capturam e pontuam via playwright-core. O script frames.mjs grava cada ator separadamente e o marca como FROZEN, TELEPORT, EMPTY ou OFFSCREEN, de modo que um boneco que parou de animar não consegue se esconder atrás de um vizinho agitado. Agentes costumam declarar sucesso em cenas que nunca olharam; aqui eles precisam apresentar provas.
O porém: é pesado. A instalação pelo npm copia cerca de 155 arquivos e 1,6 MB, e o prompt de instalação manda o agente ler o SKILL.md inteiro, o índice de referências, vários modelos e os exemplos antes de construir. Isso custa contexto a cada nova sessão, e o README admite que construções longas vão esbarrar na compactação de contexto, que ele resolve guardando o estado em arquivos. O prompt de instalação também manda os agentes usarem o npm em vez de clonar o repositório para que a contagem de downloads reflita o uso, o que faz desse número um sinal mais fraco do que parece. O projeto tem três semanas e meia, não tem versões marcadas no GitHub e passou por muitas versões da skill muito rápido.
Nossa opinião: para uma ilustração pontual ou a explicação de um mecanismo, o processo vale os tokens, porque os scripts de QA pegam os problemas que um revisor humano acharia depois. Para visuais rápidos e descartáveis, o Teardown ou um prompt simples são mais leves; o Diorama compensa o custo quando a cena tem vários atores em movimento.
Onde ele se destaca
Um desenvolvedor de jogos indie montando a atmosfera de uma fase
Conseguir uma cena animada em pixel art de um lugar sem eu mesmo modelar
Instale a skill e diga o tema; o agente pesquisa, preenche o DESIGN.md, busca modelos CC0 ou CC-BY e roda os scripts de QA antes de mostrar quadros. O custo é tempo de agente e tokens; o código é gratuito.
Um professor de engenharia criando uma explicação web de um motor de quatro tempos
Mostrar um mecanismo funcionando que os alunos possam desmontar com cliques
Peça uma cena educativa: o modo educativo do manual adiciona um cartão lateral, peças clicáveis com explicações curtas, seleção pelo teclado e checagens de que a simplificação não apagou peças que funcionam.
Uma designer de marketing num estúdio pequeno que faz clipes em loop para redes sociais
Transformar um roteiro numa cena animada curta com créditos seguros para publicar
O agente registra cada recurso e sua licença no CREDITS.md, recusa os não comerciais e depois entrega quadros congelados e tiras de movimento para revisão antes de qualquer publicação.
Antes de decidir
- Configuração
- Cole o prompt de instalação do README num agente com acesso ao shell; ele roda npx @sloemo/diorama numa pasta (Node 18+), confere a contagem de arquivos, lê o manual e reporta antes de construir.
- Integrações
- Three.js r170; frontmatter de skill para agentes de programação compatíveis; QA via playwright-core e Chromium, mais dois utilitários em Python; mídia de demonstração opcional em @sloemo/diorama-media (20 MB).
- Dados e privacidade
- Tudo roda localmente no seu projeto; segundo o README, a cópia não instala nada globalmente nem executa nada depois. A pesquisa de recursos usa o acesso web do seu próprio agente. Licença MIT.
- Limites
- Pesado em contexto em construções longas; sem versões marcadas; a qualidade depende de o agente seguir um manual longo, e as cenas exibidas são demos do próprio autor.
O que é bom
- Vem como SKILL.md que agentes com skills carregam pelo nome
- Cenas determinísticas: qualquer instante mostra o mesmo quadro
- Oito scripts de QA, incluindo veredictos por ator e por quadro
- Regras rígidas de licença e registro de cada recurso importado
O que não é
- Manual grande consome contexto no início de cada sessão
- Três semanas e meia de vida, sem versões marcadas no GitHub
- Estilo próprio fixo; outros visuais exigem brigar com o manual
- O prompt de instalação empurra o npm para inflar downloads
Ideal para
Desenvolvedores que querem que um agente produza cenas animadas em Three.js com estilo pixel ou toon consistente e prove que cada quadro funciona.
Alternativas ao Diorama
Diorama: perguntas frequentes
- Diorama vale a pena?
- O Diorama transforma um pedido vago de uma cena 3D bonita numa construção disciplinada, com pesquisa, visual fixo e checagem quadro a quadro, e cobra bastante contexto do agente em troca. Damos nota 3.8 de 5.
- Quanto custa Diorama?
- Gratuito e de código aberto (MIT). Você paga pelo agente de programação e pelo modelo que o usam.
- Quais são as desvantagens de Diorama?
- Manual grande consome contexto no início de cada sessão; três semanas e meia de vida, sem versões marcadas no GitHub; estilo próprio fixo; outros visuais exigem brigar com o manual; o prompt de instalação empurra o npm para inflar downloads.
- Para quem Diorama é indicado?
- Desenvolvedores que querem que um agente produza cenas animadas em Three.js com estilo pixel ou toon consistente e prove que cada quadro funciona.
- Diorama é seguro para dados da empresa?
- Tudo roda localmente no seu projeto; segundo o README, a cópia não instala nada globalmente nem executa nada depois. A pesquisa de recursos usa o acesso web do seu próprio agente. Licença MIT.
- Quais são as melhores alternativas ao Diorama?
- As alternativas mais próximas que analisamos são teardown, motionmaxxing e HyperFrames.
Respostas verificadas em 18 de nov. de 2026.