Cómo estamos construyendo Salty Poker: spec-driven development

La mayoría de las plataformas de póker se construyen como se juega la mayoría de las manos de póker — rápido, a tacto, improvisando sobre la marcha. Nosotros no estamos haciendo eso.

Desde el día uno tomamos la decisión deliberada de construir esta plataforma usando spec-driven development. Es una metodología que está ganando tracción seria en los círculos de ingeniería asistida por IA, y es la base sobre la que se apoya todo lo que estamos construyendo.

Qué significa spec-driven development

Antes de escribir una sola línea de código de producción, se escribió primero la especificación. Más de 100 páginas. Veintitrés módulos que cubren cada dominio del sistema — infraestructura, esquema de base de datos, contratos de API, límites de servicio, controles de cumplimiento, pipelines de CI/CD, runbooks operativos.

La metodología se divide en tres niveles. Spec-first: se escribe una especificación exhaustiva antes que cualquier código, y luego se usa para guiar el desarrollo. Spec-anchored: la especificación se mantiene viva y evoluciona junto al código a medida que el proyecto madura. Spec-as-source: la especificación es lo único que toca el humano — el código se genera por completo a partir de ella.

Hay también un patrón de fallo que vale la pena nombrar: spec-once — donde una especificación arranca el proyecto y después se abandona silenciosamente a medida que el desarrollo avanza. El plano se convierte en una reliquia.

Estamos diseñados explícitamente contra eso. Nuestra especificación es un documento vivo. Se actualiza cuando se toman decisiones, cuando aparecen casos límite, cuando la arquitectura evoluciona. Cuando termina una sesión, la especificación refleja lo que se ha construido. Cuando empieza la siguiente, retoma exactamente donde se quedó la anterior.

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

Las plataformas de póker fallan de maneras predecibles — y casi todas se remontan a la misma causa raíz: atajos tomados pronto que se acumulan y derivan en problemas serios más tarde.

Un sistema de wallet construido sin un ledger de partida doble adecuado. Un motor de juego que no ha sido estresado para casos límite. Una capa de cumplimiento atornillada después en lugar de integrada desde el día uno. Una plataforma que funciona bien con 50 jugadores y se derrumba con 500.

Spec-driven development es la disciplina que previene eso. Cada frontera de servicio se define antes de construirla. Cada flujo de datos se documenta antes de implementarlo. Cada requisito de cumplimiento está en la especificación antes de que se ejecute una sola migración. No hay decisiones del tipo "eso lo resolveremos luego" — porque "luego" es cuando los jugadores están en las mesas.

Agentic AI como motor de ejecución

Estamos usando agentic AI para construir esta plataforma — y hay una distinción importante entre eso y las herramientas de IA con las que la mayoría está familiarizada.

La agentic AI no se limita a responder preguntas o autocompletar código. Ejecuta flujos de trabajo de varios pasos de forma autónoma dentro de límites definidos — escribe el código, corre los tests, detecta el fallo, lo arregla, hace commit — sin necesitar que un humano supervise cada acción. Trabaja en una tarea de principio a fin y devuelve el control cuando llega a una decisión reservada para un humano.

La especificación es lo que hace que eso sea seguro y predecible. El agente opera desde una especificación definida, revisada y versionada. Cada sesión carga un subconjunto enfocado de módulos — dos a cuatro a la vez — dándole al agente exactamente el contexto que necesita y nada más. Cada sesión tiene un alcance definido. Un checkpoint abre la puerta a la siguiente fase. Nada avanza hasta que la checklist esté limpia.

El agente no decide qué construir. La especificación decide. El agente ejecuta.

El resultado

Una plataforma construida con el rigor que se merece. Cada decisión arquitectónica documentada. Cada frontera de servicio intencional. Cada requisito de cumplimiento atendido antes de que se volviera un problema.

Eso es lo que estamos construyendo. Y notarás la diferencia cuando juegues en ella.

Escribo sobre spec-driven development como metodología — las decisiones, el tooling, la estructura de sesión y lo que significa más allá del póker — en The Salty Korean. Si te interesa el lado de ingeniería de todo esto, ahí es donde viven los análisis más profundos.

Para más sobre la metodología: Using Spec-Driven Development with Claude Code por Heeki Park.

Stay salty.