Estamos construyendo una plataforma de póker y la IA acaba de intentar desplegar nuestra infraestructura

Construir una plataforma de póker desde cero significa llevar muchos sombreros a la vez. En un día cualquiera pienso en la lógica del juego, los requisitos de cumplimiento, la experiencia de jugador, los flujos de transacciones financieras y otras cien cosas que no tienen nada que ver entre sí. La IA ha sido un verdadero salvavidas para mantenerlo todo bajo control.

También acaba de intentar desplegar nuestra infraestructura cuando le pedí que escribiera un párrafo.

El contexto

La plataforma de póker corre sobre una especificación técnica detallada — un documento vivo que cubre todo: cómo funciona el motor de cartas, cómo el ledger rastrea los fondos de los jugadores, cómo el geofencing asegura el juego solo en Texas, cómo cada venue recibe su experiencia de marca blanca. Es la base desde la que se construye todo.

Cuando llegó el momento de formalizar nuestro enfoque de Terraform como infrastructure-as-code, quería documentar la estrategia en la spec. Qué patrones usaríamos, cómo estructuraríamos nuestros despliegues en Azure, la filosofía general. Una sección. Un par de párrafos.

Le pedí a la IA que lo añadiera.

La IA añadió, en su lugar, una implementación completa y ejecutable de Terraform.

Código chulo, entregable equivocado

Módulos. Archivos de variables. Definiciones de recursos. Un proyecto IaC totalmente armado — incrustado dentro de un documento de especificación en markdown.

¿Lo mejor? El código era realmente bueno. Estructura de módulos sólida, organización limpia de recursos, nombres de variables sensatos. Si le hubiera pedido que construyera el setup de Terraform, habría sido un buen punto de partida.

Pero le pedí que describiera la estrategia, no que la ejecutara. Hay una diferencia significativa entre "documenta cómo pensamos usar Terraform" y "aquí tienes Terraform". Un humano lo habría pillado. La IA, con toda su confianza, no lo pilló.

Por qué esto importa específicamente para una plataforma de póker

Una plataforma de póker tiene muchas piezas móviles que tienen que estar bien — no aproximadamente bien, ni direccionalmente bien, sino exactamente bien. El estado del juego, las entradas del ledger, las reglas de cumplimiento, la lógica del geofence. La spec es el contrato entre el diseño y la implementación. Cuando se le añade algo, tiene que ser intencional.

Una IA que genera código solícitamente y lo suelta dentro del documento de spec sin que se lo pidan no solo está haciendo trabajo extra — potencialmente está corrompiendo la fuente de verdad de la que todo lo de abajo depende. En una codebase tan sensible, el radio de explosión de una instrucción mal entendida importa.

Este incidente en particular fue de bajo riesgo y fácil de arreglar. Pero es una buena ilustración de algo que conviene tener presente mientras construimos: la IA ejecuta con confianza y pregunta poco. El humano en el loop existe para cubrir el hueco entre lo que se dijo y lo que se quiso decir.

El arreglo y la lección

Treinta segundos para borrar el código generado. Treinta más para reescribir el prompt con restricciones explícitas: "solo prosa, sin bloques de código, describe la estrategia." A la segunda, obtuve exactamente lo que quería.

La lección práctica: cuando le pides a la IA trabajo de documentación o de spec, trátalo como si estuvieras escribiendo instrucciones para alguien que va a hacer exactamente lo que le digas y va a interpretar generosamente cualquier ambigüedad como permiso para hacer más. Porque es exactamente eso lo que hace.

Sé explícito sobre el formato. "Añade una sección sobre X" es ambiguo. "Añade una sección en prosa, sin código, que describa nuestro enfoque para X" no lo es.

Espera que sobreentregue en la dirección equivocada. La IA se inclina a hacer más, no menos. Cuando la tarea es aditiva (como actualizar una spec), ese instinto necesita barandillas.

Lee antes de hacer commit. Esto es obvio y, de algún modo, sigue siendo el paso que más se salta.

Estamos construyendo esta plataforma en público — los aciertos, los desvíos raros, y los momentos en los que las herramientas hacen algo inesperadamente divertido. Este fue uno de esos momentos.

La IA es extraordinaria para un proyecto como este. Y también, de vez en cuando, un poco demasiado ansiosa por ayudar.

Profundizo sobre agentic AI, spec-driven development, y lo que es realmente usar IA para construir sistemas en producción en The Salty Korean — la metodología detrás del póker, sin el póker.

La plataforma sigue avanzando. Más pronto.

Stay salty.