Método · Cómo construyo
Diseño el sistema. Después dirijo a la IA para construirlo.
El código no se improvisa. Primero defino los contratos —visión, dominio, arquitectura, reglas— y solo entonces construyo, orquestando IA bajo reglas estrictas. La arquitectura es la prioridad absoluta; el código es una consecuencia.
"Ninguna línea de código se escribe hasta que el contrato esté completo."Regla #1 · Master Contract
El proceso // 01
Del concepto al producto, en fases.
Cada fase termina antes de que empiece la siguiente. El contenido nunca se produce antes que los sistemas capaces de sostenerlo.
-
FASE 0
Visión y contrato
Documento qué se construye y por qué. El contrato de mayor nivel. Cero código.
-
FASE 1
Dominio y arquitectura
Entidades, invariantes, módulos y contratos. La estructura antes que el comportamiento.
-
FASE 2
Reglas y contratos de datos
Qué es dato y qué es código. Esquemas versionados y validación que falla rápido.
-
FASE 3
Vertical slice
El recorte mínimo que prueba que la arquitectura funciona, de punta a punta.
-
FASE 4
Construcción
La IA implementa contra los contratos. Yo reviso arquitectura, trade-offs y decisiones.
-
FASE 5
Validación y producción
Build, tests, validadores y post-work. Solo entonces, a producción.
Los contratos // 02
Trece documentos antes de la primera línea.
Cada proyecto arranca con una jerarquía de documentos vivos: cuando dos decisiones chocan, gana el documento de mayor nivel. Esta es la de BabelDestiny, mi motor de juego en desarrollo.
Visión
Qué se construye y por qué. El contrato de mayor nivel.
Modelo de dominio
Entidades, relaciones, estados e invariantes.
Diseño
Loop principal, mecánicas y progresión.
Arquitectura técnica
Stack, módulos, loaders y contratos.
Reglas data-driven
Dato vs. código, esquemas y validación.
Vertical slice
Alcance y criterios de aceptación del primer corte.
Reglas de IA
Cómo debe trabajar la IA en el proyecto.
Estructura de carpetas
Qué vive —y qué no— en cada carpeta.
Estándares de código
Convenciones del lenguaje.
Pipeline de contenido
Cómo se crea y valida cada pieza de contenido.
Roadmap
Fases 0→6 y criterios de avance.
Decisiones
Registro de decisiones de arquitectura, con su razón.
Orquestar IA // 03
La IA construye. Yo decido.
Trato a la IA como un ejecutor de altísimo nivel, no como un oráculo. Cada comportamiento debe ser explicable; ninguna decisión es mágica.
Yo + modelos de razonamiento
- Visión, dominio y arquitectura
- Trade-offs y decisiones (registradas como ADR)
- Qué es dato y qué es código
- Alcance y criterios de aceptación
La IA, bajo reglas
- Construye contra los contratos existentes
- Tier 1 fluye; Tier 2 (arquitectura, esquemas) se detiene y pregunta
- Post-work obligatorio: build, validación, tests
- Los documentos «requiere aprobación» no se tocan solos
Principios // 04
Las reglas que no se negocian.
- Datos sobre código. Todo lo que pueda ser dato, no es código.
- Explícito sobre implícito. Cero estado oculto.
- Composición sobre herencia. Módulos pequeños, responsabilidad única.
- Ejecución determinista. Mismos datos, mismo resultado.
- Fail fast. El dato inválido falla de inmediato; nada de fallos silenciosos.
- Versiona cada contrato. Los esquemas evolucionan sin romper.
- Reusar antes que duplicar. Una sola fuente de verdad.
- Simplicidad sobre artificio. Mantenible durante años.
BabelDestiny
Un motor data-driven para un Action Roguelite isométrico. Antes de escribir una línea de código dejé documentada toda la arquitectura: la jerarquía completa de contratos y las reglas para que la IA construyera sin desviarse. El objetivo no es un juego: es un motor que crece añadiendo datos, nunca tocando el código.
Construyamos sistemas que perduran.
Para productos que necesitan arquitectura real, no prototipos desechables.