convez.ai
SkillDesign & UIIntermediário
LastrarterotH

Noesis Engine

LastrarterotH/noesis-engine

Animações explicativas embarcáveis em JSON, sem build nem dependências

Ver no GitHub
InicialPluginScore · de 0 a 100

Motor de animações narrativas para explicar conceitos, embarcável em Web Components. Cada cena é um JSON que renderiza animações em pixel art com áudio sintetizado, diálogo e texto acadêmico, sem build, dependências ou tracking.

Instalação

$npx convez-ai LastrarterotH/noesis-engine

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar conteúdo educativo interativo com animações
  • Embutir explicações visuais em documentação técnica
  • Prototipar narrativas pedagógicas com pixel art

Veredito

Ferramenta niche mas bem-executada para autores de conteúdo educativo que querem animações narrativas sem overhead tecnológico. O modelo JSON-based e Web Component tornam-a portável e reutilizável, porém a curva de aprendizado das convenções de cena é significativa.

README

A tradução para o português deste README ainda está na fila.

noesis-engine

Engine ligero para construir animaciones narrativas embebibles que explican conceptos. Cada escena es un archivo JSON que se renderiza dentro de un Web Component <noesis-scene> (Shadow DOM aislado), con pixel-art animado, sonido sintetizado, diálogo y su texto académico al lado.

Conceptos que se ven, no que se memorizan. Sin build, sin npm, sin dependencias, sin tracking.

Cómo se incrusta

<!-- 1. Carga el engine (un solo archivo, como módulo ES) -->
<script type="module" src="engine/noesis-engine.js"></script>

<!-- 2. Incrusta una escena -->
<noesis-scene src="scenes/01-netflix-prize.json" lang="es"></noesis-scene>

Atributos útiles del componente:

  • src ruta al JSON de la escena.
  • lang idioma del texto (es).
  • layout="bare" muestra solo el lienzo animado (sin el ensayo académico): ideal para galerías y miniaturas. En este modo los textos de overlay se contienen para no desbordar contenedores chicos.
  • mute desactiva el audio.

Cómo previsualizar

El engine se sirve estático. Desde la raíz del proyecto:

python3 -m http.server 8765

Y abrir:

  • http://localhost:8765/examples/scene-NN.html una escena con su texto académico (por ahora solo scene-01).

El engine carga las escenas con cache: 'no-store', así que cualquier cambio al JSON se ve al recargar.

Probar

Smoke test headless: corre el engine real en Node con stubs de canvas/DOM, construye cada escena, la tickea, simula un clic y un reset, y falla ante cualquier excepción. Caza los bugs silenciosos de ES modules que node --check no ve.

node tools/smoke.mjs

No reemplaza la verificación visual: confirma que nada explote, no mira píxeles.

Crear una escena

Una escena vive en scenes/NN-slug.json: configuración del lienzo, entidades, props, texto académico y hooks (onInit, onStep, onDraw, onClick, onReset) como cadenas de JS que el engine compila a funciones.

Las convenciones completas (voz, paleta, reglas visuales, coordenadas, anclas) están en CLAUDE.md. El comando /noesis-scene (en .claude/commands/) genera escenas siguiendo esas reglas.

Pre-flight: cada hook no vacío debe compilar con new Function(...args, src), y conviene correr node tools/smoke.mjs.

Estructura

noesis-engine/
├── engine/                 # el motor, en módulos ES (sin build)
│   ├── noesis-engine.js     # entry: registra <noesis-scene>
│   ├── element.js           # custom element, loop RAF, loader
│   ├── world.js             # simulación: tick + orquestación de dibujo
│   ├── draw.js / mood.js / accessories.js   # dibujo de learners
│   ├── prop-draw.js / prop-sprites.js       # props
│   ├── camera.js / ambient.js / scripts.js / forms.js / floor.js
│   ├── animated-props.js / learner.js / interaction.js / fx.js
│   ├── audio.js / sky-presets.js / hooks.js / validate.js / util.js
├── scenes/NN-slug.json     # repertorio real (config + texto + hooks)
├── examples/scene-NN.html  # wrapper por escena
├── tools/                  # smoke.mjs, validate.mjs, ...
├── docs/                   # noesis-vision (charter), spec, rediseno-pedagogico
├── MANUAL.md               # manual práctico de uso
├── .claude/commands/       # /noesis-scene
└── CLAUDE.md               # convenciones de autoría

El engine se carga como módulo ES (<script type="module">). Sin build, sin dependencias.

Repertorio

El repertorio real vive en scenes/ (01 por ahora: el repertorio se reinició para reconstruirlo bajo la modalidad Claude-nativa), cada escena construida deliberadamente alrededor de UNA mecánica visual (un viajero, una población, un umbral, una convergencia...).

Cómo se usa

noesis es un motor nativo de Claude: las escenas se construyen dialogando el concepto con Claude (la skill /noesis o el comando /noesis-scene), que las arma con el vocabulario del motor, las valida con tools/validate.mjs y las previsualiza. No es un producto self-serve para usuarios no técnicos. Visión completa en docs/noesis-vision.md.

Ver o original no GitHub

Bom para

Relacionados