Crear un juego de UNO humano contra IA con el Four-Pack de SwarmForge de Uncle Bob
One agent. Four disciplined handoffs. One complete UNO game.
Specification, implementation, validation, and architecture closure become a sequential CTRL NODE graph.
El SwarmForge de Uncle Bob organiza el trabajo asistido por IA mediante traspasos disciplinados entre roles especializados. Su flujo four-pack crea un ciclo compacto: specifier → coder → refactorer → architect → specifier. Este experimento traslada esa disciplina a un grafo de CTRL NODE: un único agente de ejecución y cuatro tareas secuenciales con límites, entregables y contexto persistente. Consulta el README de SwarmForge para conocer el flujo original.
El producto es un juego de UNO para navegador con dos jugadores: una persona y un oponente controlado por máquina. La persona puede elegir cartas, robar, seleccionar color tras un comodín y declarar UNO; la IA debe tomar decisiones estratégicas, no escoger una carta legal al azar.
Paso 1 — Describir el flujo Four-Pack
Abre Graphs & Workflows → New, selecciona Create With AI y deja Agent Mode en Single Agent. El grafo usa el mismo agente de ejecución, pero separa especificación, implementación, validación y cierre en cuatro tareas consecutivas.
Create a complete browser-based UNO game using Uncle Bob's SwarmForge four-pack methodology. Use four sequential stages: design, build, AI validation, and final corrections. The human must choose cards and declare UNO; the machine opponent must play strategically.
El prompt solicita: diseñar arquitectura, reglas completas, estrategia de IA, sistema visual y HANDOFF.md; construir el juego HTML/CSS/JavaScript; validar por lectura del código cuando no hay herramientas sh/go; y corregir los hallazgos para producir HANDOFF-COMPLETE.md.
La clave es la cadena de handoffs. Cada tarea asume una frontera de calidad y deja contexto escrito para la siguiente. El orden es intencional: Build depende de Design, Validate depende de Build y Finalize depende del informe de validación.
Paso 2 — Revisar la propuesta de IA
Al elegir Generate Graph, CTRL NODE propone cuatro tareas antes de crear o ejecutar nada:
- Diseño de arquitectura y reglas.
- Implementación del juego desde
HANDOFF.md. - Validación IA de reglas y jugabilidad por lectura y razonamiento del código.
- Correcciones finales y cierre de handoff.
No es una copia literal de SwarmForge. Conserva su disciplina útil —roles explícitos, trabajo acotado, handoffs duraderos y una fase final de calidad— expresada como un flujo de CTRL NODE.
Paso 3 — Inspeccionar el grafo en Designer
Tras revisar la propuesta, Create Graph crea un grafo lineal editable: DESIGN → BUILD → VALIDATE → FINALIZE.
Instrucciones generadas para las tareas
1. Diseño. Define estructura de archivos, mazo de 108 cartas, máquina de estados, jugadas legales, robo, victoria y penalización por no declarar UNO. En una partida de dos jugadores, Reverse funciona como Skip. Especifica la estrategia de IA, una interfaz responsive sin assets externos y un HANDOFF.md controlado por IA.
2. Build. Lee HANDOFF.md como contrato obligatorio e implementa el juego completo: mazo, reparto, cartas especiales, selector de color, robo, declaración UNO, victoria, IA no trivial y animaciones CSS/SVG. El resultado debe abrirse directamente desde index.html.
3. Validate. Recorre el código fuente contra HANDOFF.md, RULES.md y AI_STRATEGY.md; registra cada criterio como PASS/FAIL en validation-report.md y entrega correcciones concretas a Finalize.
4. Finalize. Corrige los hallazgos, revisa cada ajuste contra su criterio y escribe HANDOFF-COMPLETE.md con la cadena completa design → build → validate → finalize.
Paso 4 — Ejecutar diseño y reglas
El primer nodo no escribe aplicación: crea la especificación que seguirán los demás. Produce cinco documentos alineados: ARCHITECTURE.md, RULES.md, AI_STRATEGY.md, VISUAL_SPEC.md y HANDOFF.md.
Las reglas fijan decisiones que de otro modo serían ambiguas: Reverse equivale a Skip; no se acumulan +2/+4; solo se roba si no hay jugada válida; el descarte se recicla conservando su carta superior; la IA empieza y la carta inicial siempre es numérica. La IA declara UNO automáticamente; la persona tiene cinco segundos y recibe dos cartas de penalización si no lo hace. Los desafíos de Wild Draw Four quedan fuera del MVP de forma deliberada y documentada.
La auditoría del nodo confirmó que los cinco documentos eran consistentes y completos. Build recibió una especificación ejecutable, no un prompt impreciso.
Paso 5 — Construir el juego
Build convirtió ese handoff en un juego modular: un index.html, seis archivos CSS y diez módulos JavaScript para cartas, mazo, jugadores, reglas, estado de juego, IA, control de UNO, animaciones, interfaz y arranque.
La revisión independiente comprobó estructura, sintaxis de los diez módulos, ausencia de CDNs, imágenes remotas o bundlers, y que las animaciones de reparto, robo y juego están conectadas realmente a la interfaz. El juego cubre el mazo de 108 cartas, todas las cartas especiales, selector de color, declaración UNO, victoria y una IA que reduce su mano, conserva comodines, selecciona su color dominante y bloquea al rival cuando conviene.
Paso 6 — Validar reglas y jugabilidad
El nodo Validate usó los documentos de diseño y HANDOFF.md como fuente de verdad. Los 12 criterios de aceptación pasaron: orden de turnos, Reverse-as-Skip, Skip, Draw Two, Wild, Wild Draw Four, robo y reciclado, victoria, UNO, interacción humana protegida, IA estratégica y presentación responsive con animaciones conectadas.
validation-report.md también señaló tres mejoras no bloqueantes: retirar foco de teclado de elementos inertes, evitar que el descarte se actualice antes de que aterrice un comodín animado y añadir una época de partida para invalidar temporizadores de una partida anterior.
Paso 7 — Finalizar y mejorar el código generado
Aunque Validation no encontró fallos bloqueantes, Finalize aplicó las tres mejoras. Las cartas no jugables ya no entran en el orden de tabulación, el descarte espera la animación del comodín y gameEpoch invalida temporizadores de IA y UNO tras reiniciar. También añade avisos visuales para Skip, Reverse, +2, +4, UNO y penalizaciones.
Los diez módulos volvieron a pasar comprobación de sintaxis. Un arnés temporal simuló 300 partidas completas IA contra IA sin excepciones, bucles infinitos ni ganadores inválidos. HANDOFF-COMPLETE.md cierra la cadena y deja una sola recomendación complementaria: una partida manual en navegador cuando esté disponible.
Qué cambia el Four-Pack en la intervención humana
El valor de este patrón no es eliminar a las personas, sino acotar y hacer intencional su intervención. La persona define el objetivo y puede revisar la propuesta o el producto final; no tiene que repetir reglas ni coordinar manualmente cada corrección interna.
Design convierte la intención en criterios; Build implementa y documenta; Validate contrasta el código contra el contrato; Finalize consume el informe, mejora el resultado y cierra el handoff. El contexto viaja por documentos y no por memoria informal de una conversación.
El código inicial tampoco se acepta como perfecto. El bucle práctico es: generar → inspeccionar → informar → mejorar → verificar. Cada mejora final se puede rastrear a un hallazgo, un cambio de código y evidencia de verificación. Es menos micromanagement humano, no menos disciplina de ingeniería.
El juego de UNO terminado ejecutándose directamente desde index.html. Los handoffs Four-Pack convierten una primera implementación generada por IA en un juego validado, pulido y autocontenido.