CRUMB

CRUMB

Generative Game Studio · Demo

De una idea de juego en una línea a un borrador jugable, con el trabajo de los agentes a la vista y abierto a intervención.

CRUMB es un arnés de estudio multiagente para prototipar juegos casuales.

Diseño y desarrollo · hecho con agentes de programación de IA

CLIDemo local
Web StudioDemo local

Los agentes que construyen un juego, separados de la evidencia que lo juzga.

Una demo de estudio local que lleva una idea de juego en una línea por la especificación, el build y las comprobaciones de ejecución. Cada paso queda en una transcripción JSONL, un reducer puro decide los siguientes efectos y solo el dispatcher produce efectos secundarios. La QA de ejecución y el veredicto del modelo se mantienen separados para decidir entre aprobado, rediseño, reparación e intervención humana.

Se propone un juego en una línea y los agentes de Claude Code, Codex y Gemini CLI colaboran mediante Planner → Builder → QA determinista → Verifier, mientras CRUMB Studio muestra los eventos, el avance y los artefactos y acepta intervenciones en lenguaje natural.

Una demo que se clona del repositorio público y se ejecuta en local.

Mapa del sistema · trazado a partir de las rutas de código del commit público f5e17c0

De la idea al juego

Una idea se convierte en especificación, build y ejecución de QA. Cada paso pasa por la transcripción; los actores no se llaman entre sí.

Idea de juego · intervenciónEjecución · juicio: idea · intervenciónEscribir comandos en el inboxpackages/studio
Una idea de juego en una línea y la intervención en lenguaje natural se introducen en Studio, que escribe comandos en el inbox. Studio nunca edita la transcripción directamente.
Escribir comandos en el inboxpackages/studioDatos: eventos userBucle de eventos · reproducción · tailsrc/loop/coordinator.ts
El coordinador lee los comandos del inbox y los registra en la transcripción como eventos user.
Bucle de eventos · reproducción · tailsrc/loop/coordinator.tsEjecución · juicio: reducir en ordenEstado → siguientes efectossrc/reducer
Los eventos en vivo pasan uno a uno de una cola al reducer, lo que mantiene el orden de los efectos de cada evento; el dispatch en sí se ejecuta de forma asíncrona.
Estado → siguientes efectossrc/reducerEjecución · juicio: efectosEjecutar efectos · lanzar actoressrc/dispatcher/live.ts
El reducer es una función pura que solo decide el estado y los siguientes efectos: un goal selecciona al Planner, una spec al Builder, un build un qa_check.
Actor → arnés · modelomodel-config · presetEjecución · juicio: configuración de actoressrc/dispatcher/live.ts
Qué arnés, proveedor y modelo ejecutan un actor se resuelve en el orden flag de CLI > config > preset > ambient > fallback. Un actor no es un proveedor fijo.
Ejecutar efectos · lanzar actoressrc/dispatcher/live.tsEjecución · juicio: ejecutar el PlannerPlanner Lead · especificaciónagent actor · CLI
El dispatcher ejecuta el Planner con una entrada proyectada. La investigación condicional continúa con el plan de investigación del Planner y el traspaso de evidencia, plegados en este mapa.
Planner Lead · especificaciónagent actor · CLIDatos: spectranscript.jsonl · append-onlysrc/transcript
La especificación del Planner se convierte en un evento de transcripción, y a partir de ella el reducer selecciona al Builder. Los actores no se llaman entre sí.
Ejecutar efectos · lanzar actoressrc/dispatcher/live.tsEjecución · juicio: ejecutar el BuilderBuilder · escribe el juegoagent actor · CLI
El dispatcher ejecuta el Builder. Si el mismo actor sigue fallando, se abre un circuito que cambia de adaptador, y se detiene si los fallos continúan.
Builder · escribe el juegoagent actor · CLIDatos: archivosArchivos del juegoartifacts/
El Builder escribe el archivo de entrada, las fuentes y los assets como artefactos.
Builder · escribe el juegoagent actor · CLIDatos: registro del buildtranscript.jsonl · append-onlysrc/transcript
El evento build y artifact.created se registran en la transcripción con la identidad del artefacto.
Ejecutar efectos · lanzar actoressrc/dispatcher/live.tsEjecución · juicio: qa_checkQA de ejecución · comprobacionesdispatcher/qa-runner.ts
Tras un evento build, el reducer emite un efecto qa_check con la identidad del artefacto y del build y las condiciones de aceptación, y el dispatcher lo ejecuta.
Archivos del juegoartifacts/Datos: qué se ejecutaQA de ejecución · comprobacionesdispatcher/qa-runner.ts
La QA de ejecución ejecuta el artefacto real con comprobaciones de código y de navegador. El tiempo de espera por defecto de 120 segundos es un valor de configuración.
QA de ejecución · comprobacionesdispatcher/qa-runner.tsDatos: qa.resulttranscript.jsonl · append-onlysrc/transcript
Con éxito o con fallo, el resultado se registra como un evento de sistema qa.result. Aunque la comprobación lance una excepción, se registra un resultado con los campos fallidos.

Frontera de confianza de la verificación

La QA de ejecución es evidencia de ejecutar realmente el artefacto; el Verifier es un modelo que juzga evidencia proyectada. El reducer concilia ambas antes de elegir el siguiente camino.

QA de ejecución · comprobacionesdispatcher/qa-runner.tsDatos: qa.resulttranscript.jsonl · append-onlysrc/transcript
Con éxito o con fallo, el resultado se registra como un evento de sistema qa.result. Aunque la comprobación lance una excepción, se registra un resultado con los campos fallidos.
transcript.jsonl · append-onlysrc/transcriptDatos: solo evidenciaProyección de la entrada del juezsrc/dispatcher/live.ts
La entrada del Verifier se proyecta a partir de los últimos goal, spec, build, qa.result y artifact.created, más evidencia de investigación seleccionada. Reduce el contexto; no demuestra aislamiento ni ausencia de fugas.
Proyección de la entrada del juezsrc/dispatcher/live.tsDatos: entrada del juezVerifier · veredicto del modeloVerifier actor
El dispatcher ejecuta el Verifier con la entrada proyectada.
Verifier · veredicto del modeloVerifier actorDatos: judge.scoretranscript.jsonl · append-onlysrc/transcript
El veredicto del Verifier se registra como un evento judge.score. Es el juicio de un modelo, no un hecho de la ejecución.
Estado → siguientes efectossrc/reducerEjecución · juicio: puntuación · evidencia de QAAntiengaño · corrección de la puntuaciónsrc/validator
Ante judge.score, el reducer lo pasa a la comprobación antiengaño junto con el resultado de la QA, el proveedor del Builder y el plan y la evidencia de investigación.
Antiengaño · corrección de la puntuaciónsrc/validatorDatos: veredicto corregidoEnrutamiento del veredictosrc/reducer
Un PASS sin una ejecución exitosa pasa a FAIL, y la puntuación relacionada con la ejecución se corrige con la QA determinista. Las demás reglas son correcciones condicionales, no una prueba general de veracidad.
Enrutamiento del veredictosrc/reducerDatos: terminadoTerminado · PASS o motivo de paradasession done
PASS termina la sesión como done. Las paradas por presupuesto o por circuito también terminan como done pero conservan su motivo de parada, así que done no siempre es PASS.

Fallo e intervención humana

PARTIAL va a una persona, Critical a rediseño, Important o Minor a reparación, y las paradas por presupuesto o circuito dejan un motivo de parada.

Antiengaño · corrección de la puntuaciónsrc/validatorDatos: veredicto corregidoEnrutamiento del veredictosrc/reducer
Un PASS sin una ejecución exitosa pasa a FAIL, y la puntuación relacionada con la ejecución se corrige con la QA determinista. Las demás reglas son correcciones condicionales, no una prueba general de veracidad.
Enrutamiento del veredictosrc/reducerEjecución · juicio: revisión de PARTIALIdea de juego · intervención
PARTIAL espera a que una persona lo revise.
Enrutamiento del veredictosrc/reducerEjecución · juicio: rediseño · reparaciónsrc/dispatcher/live.ts
Entre FAIL y REJECT, Critical vuelve al Planner para rediseño e Important o Minor al Builder como comentarios de corrección, todo ejecutado como efectos del dispatcher.
Enrutamiento del veredictosrc/reducerDatos: terminadoTerminado · PASS o motivo de paradasession done
PASS termina la sesión como done. Las paradas por presupuesto o por circuito también terminan como done pero conservan su motivo de parada, así que done no siempre es PASS.
Idea de juego · intervenciónEjecución · juicio: idea · intervenciónEscribir comandos en el inboxpackages/studio
Una idea de juego en una línea y la intervención en lenguaje natural se introducen en Studio, que escribe comandos en el inbox. Studio nunca edita la transcripción directamente.

Reproducción y observación

Reconstruir el estado a partir de la transcripción no ejecuta ningún efecto, y Studio lee el mismo registro para mostrarlo.

transcript.jsonl · append-onlysrc/transcriptDatos: nuevos eventos · reproducciónBucle de eventos · reproducción · tailsrc/loop/coordinator.ts
El writer valida el esquema, asigna un ULID y una marca de tiempo, y anexa. En la reproducción, los eventos pasados solo pasan por el reducer; sus efectos no se vuelven a ejecutar.
Bucle de eventos · reproducción · tailsrc/loop/coordinator.tsEjecución · juicio: reducir en ordenEstado → siguientes efectossrc/reducer
Los eventos en vivo pasan uno a uno de una cola al reducer, lo que mantiene el orden de los efectos de cada evento; el dispatch en sí se ejecuta de forma asíncrona.
transcript.jsonl · append-onlysrc/transcriptObservación · informe: lectura · SSEVista de eventos · artefactospackages/studio
Studio lee la transcripción y los artefactos y muestra el avance, las métricas y los artefactos mediante SSE. No es telemetría enviada a un servicio remoto.

Todas las conexiones con el mismo grosor. Elija un flujo para resaltar solo su recorrido, con pasos numerados.

Continua · dirección de entradas, resultados y registros
Discontinua · ejecución, juicio, solicitud
Puntos largos · observación e informe, aparte del juicio
Línea negra gruesa · el flujo seleccionado; los números dan el orden
Recuadro · frontera de código o de estado, con su nombre en la cabecera
Chip interior · componente de esa frontera
Recuadro punteado · fuera de esa frontera
Contorno naranja · donde decide un modelo

Bucle de eventos · reducer · dispatcher
Registros · configuración · artefactos
Comprobaciones deterministas · corrección
Studio · actores

Trazado a partir de las rutas de código del commit público f5e17c0. Los actores son roles de ejecución, distintos de los agentes de programación usados para construir este repositorio.

Fuente del estado: La transcripción es la fuente del estado y el reducer es una función pura. Solo el dispatcher produce efectos secundarios (ejecutar actores, la QA, escribir archivos), así que la reproducción reconstruye el estado sin efectos.
Qué cubre la reproducción: La reproducción da el mismo estado; no hace deterministas las generaciones del LLM ni el comportamiento del navegador y de la red.
Qué cubre un veredicto: La QA de ejecución solo revisa las comprobaciones configuradas, y la puntuación del Verifier es un canal de evidencia más. Ninguno mide todo el comportamiento del juego, la diversión ni la satisfacción de los usuarios.

CRUMB vocabulary

De la idea al juego

Frontera de confianza de la verificación

Fallo e intervención humana

Reproducción y observación