Moki

---

Español

Qué es

Moki Studio es un estudio de videojuegos donde casi todo el trabajo lo hacen agentes de IA. Hay una sola persona al mando, Jorge Suárez, que lleva más de 20 años en la industria de los videojuegos pero no programa.

El estudio está haciendo Un salto más, un juego de saltos para el navegador protagonizado por Moki, un astronauta de tela y papel. Cada día el juego cambia, y ese mismo día cualquiera lo puede jugar.

Este repositorio es el código real del estudio: el juego, las reglas que siguen los agentes, sus decisiones, su bitácora y las herramientas que se inventaron en el camino.

Por qué existe

Es una apuesta en voz alta:

¿Una persona que no sabe nada de lo técnico puede dirigir a un equipo de IA y sacar un juego que la gente quiera jugar?

Jorge pone la dirección, el gusto y el dinero. Discute con el director del estudio, que es un agente. Los agentes diseñan, programan, prueban, escriben y publican.

Lo hacemos en público porque así se aprende más rápido y porque documentar también es crear. Se ve lo que sale bien y también en lo que la regamos.

Qué queremos aprender

1. Si la IA ya puede hacer un juego divertido, no solo uno que funcione.
2. Cómo se organiza un equipo de agentes para que trabaje como un estudio de verdad: roles, turnos, revisiones y bitácora.
3. Cómo se mide la diversión con números del juego y no con opiniones.
4. Cuánto cuesta y cuánto se tarda, con cifras reales.
5. Qué partes todavía necesitan a un humano.

Cómo funciona (versión sin tecnicismos)

Imagina un estudio chico que nunca duerme.

• El director decide qué pieza del juego sigue y por qué, y lo deja escrito.
• El líder reparte el trabajo y lleva la bitácora.
• El constructor hace la pieza en su propia copia del juego, sin tocar lo que ya funciona.
• El probador la juega con bots y con un jugador simulado, mide y dice si pasa o no.
• El cronista cuenta lo que pasó: bitácora, novedades, GDD y el wiki del método.
• Invitados entran y salen cuando hace falta: arte, audio, niveles, game feel.

Un cambio solo entra al juego si gana una comparación a ciegas contra la versión anterior. Si no gana, se queda fuera y también se cuenta.

El día de Moki Studio

Hora (CDMX)	Qué pasa
Todo el día	Un latido revisa el estudio cada 15 minutos sin gastar IA. Si hay trabajo y nadie se mueve, despierta al director.
Cada 4 horas	Tiene que haber algo visible nuevo. Si no lo hay, se pide la pieza visible más chica.
12:58 y 15:58	Avances: lo que entró en el día sale publicado sin esperar la noche.
18:00	Corte: el juego se congela para publicar.
19:00	Versión del día, entrada de bitácora y video en redes.
Sábado	Kaizen: se revisa la semana y se mejora el propio sistema.

Reglas que lo sostienen:

• Hecho es mejor que perfecto. Nada espera a Jorge: cada pregunta trae una recomendación y una hora límite; a los 30 minutos sin respuesta, se avanza.
• Lo nuevo se juega. Un avance que no se puede jugar no es avance.
• Prioridades: primero cómo se siente jugar, luego cómo se ve, luego la tecnología.
• Sale sí o sí. Si un revisor encuentra un defecto menor, la publicación sale y se corrige en la siguiente. Solo frenan las reglas duras: privacidad, otras empresas, enlaces rotos.
• Barato: primero scripts y horarios, después IA.

El hardware y las herramientas

Pieza	Qué hace
Laptop Linux (Omarchy, basada en Arch)	Prendida todo el día con la tapa cerrada. Ahí viven los agentes, cada uno en su terminal. No puede publicar nada: tiene prohibido hacer push o desplegar.
MacBook	Revisa y publica. Jala los cambios, pasa la revisión automática y despliega el sitio. También actualiza este espejo público.
Claude Code	El motor de los agentes. El director y el constructor corren en Claude Opus; el resto, en Claude Sonnet.
OpenRig	Organiza a los agentes como un equipo con asientos y mensajes entre ellos.
Phaser 3 + Vite	El motor del juego y la herramienta que lo empaqueta para el navegador.
Cloudflare Workers	Sitio, juego y contador anónimo de partidas: sin IP, sin cookies, sin identificadores.
Un cerebro compartido de notas	Memoria del estudio: decisiones, canon y lo aprendido.

Mapa del repositorio (repo)

Carpeta o archivo	Qué hay
src/	El código del juego.
assets/	Moki, capas de fondo y elementos visuales. Todo hecho para este proyecto.
CLAUDE.md	Las reglas que leen todos los agentes al empezar.
.claude/agents/	Los especialistas invitados.
.claude/skills/	Habilidades propias del estudio: game feel (cómo se siente jugar), comparación a ciegas, revisión de calidad antes de integrar y más.
GDD.md	El documento de diseño del juego.
COLA.md	Lo que sigue, en orden.
DECISIONES.md, decisiones/	Cada decisión con su porqué.
BITACORA.md, bitacora/	El diario del estudio, hora por hora.
metodo/	El Moki Method: cómo decidimos, cómo medimos y qué aprendimos.
herramientas/, scripts/	Bots de prueba, medición, latido y publicación.
rig.yaml	La definición del equipo de agentes (el "rig").

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗