Consistencia del código con IA:un patrón, 633 servicios

La consistencia del código con IA nace de construir un único patrón maestro y hacer que la IA lo copie, sin dejar que invente un enfoque nuevo dos veces. Una plataforma real lo demostró a escala: 633 servicios, cada uno una copia idéntica de una única base de 305 líneas, cada uno construido por IA. La repetición, no la novedad, es el superpoder.

Si no eres técnico, esta puede ser la lección más contraintuitiva de construir con ayuda de IA. Nos han enseñado a pensar que la creatividad es lo valioso. En software ocurre lo contrario: los códigos más valiosos son los más aburridos. Aquí tienes la historia, con los conceptos por encima del código.

El error que estuvo a punto de ocurrir

Enero de 2025. La base de datos de FIKR Space está diseñada: 964 tablas, multi-tenant desde el primer día. Ahora necesita servicios. Muchos servicios.

La IA construye el primero. Funciona. Genial. La IA construye el segundo, y usa un patrón diferente. Distinta gestión de errores, distinta forma de consultar la base de datos. ¿El tercer servicio? Otro patrón más.

Alto. Porque las matemáticas de esa trayectoria son brutales: si sigues así, al llegar a 100 servicios tienes 100 patrones distintos. Cada error se arregla de 100 maneras diferentes. Refactorizar se vuelve imposible. La consistencia se convierte en un sueño.

No es que la IA se porte mal. Pídele que construya algo desde cero y generará una solución perfectamente razonable, la media de internet, una solución razonable distinta cada vez. La IA es una improvisadora brillante, y la improvisación es justo lo que un código no puede sobrevivir. Sin control, así es como acabas cayendo en la trampa del vibe coding.

Qué es realmente un servicio (sin necesidad de código)

Una traducción rápida para lectores no técnicos. Un servicio es la capa entre tu base de datos y tus pantallas. Cuando un usuario hace clic en “guardar”, un servicio comprueba que tiene permiso, escribe los datos en el lugar correcto, registra quién lo hizo y responde: éxito o un error útil.

Si la base de datos es el cimiento de tu producto y las pantallas son su cara, los servicios son el sistema nervioso: todas las señales pasan por ellos. Cada funcionalidad de tu producto necesita uno, y así es como una plataforma seria acaba necesitando cientos. Y todo servicio debe responder las mismas cinco preguntas: ¿Tiene este usuario permiso para hacer esto? ¿De qué cliente son estos datos? ¿Qué pasa cuando algo falla? ¿Debe registrarse esta acción? ¿Es seguro el dato introducido?

Cinco preguntas, cientos de servicios. Esa repetición es tu mayor riesgo o tu mayor activo, según una sola decisión.

Consistencia del código con IA: la jugada del patrón maestro

La decisión: deja de construir servicios y construye primero el patrón. Una base (305 líneas de código) que responde las cinco preguntas una sola vez. Gestión de errores. Filtrado multi-tenant, para que cada cliente vea únicamente sus propios datos. Comprobación de permisos. Registro de auditoría. Saneamiento de entradas. Cada respuesta ganada con esfuerzo, codificada una única vez.

Después, una regla escrita en cada plano de funcionalidad que se le entrega a la IA: todo servicio extiende la base. Sin excepciones. (Esos planos son PRPs; la mecánica está en el método PRP.)

Desde ese momento, la IA dejó de improvisar y empezó a replicar. Le pides un servicio nuevo y copia el esqueleto probado, rellena los detalles y hereda gratis todas las propiedades de seguridad. El primer servicio llevó unas 2 horas: el tiempo de construir bien la base. Cada uno de los 632 siguientes llevó de 15 a 30 minutos. En toda la plataforma, eso son unas 800 horas ahorradas frente a construir cada uno desde cero.

El libroThe Solopreneur RevolutionLuis Gonçalves sobre cómo crear un negocio de solopreneur con IA sin dejar tu empleo.Consigue el libro →

Un cambio, 633 actualizaciones

La recompensa acumulada llega más tarde. Cuando se añadió el registro de auditoría a la base, los 633 servicios lo recibieron al instante. Cuando se saneó el texto de los mensajes de error por seguridad, los 633 servicios lo recibieron. Cuando mejoró la gestión de consultas, los 633 servicios lo recibieron. Un cambio, 633 actualizaciones, cero ediciones manuales.

Eso sugiere una prueba sencilla para saber si tu arquitectura funciona. Llámala la prueba de escala: si puedes añadir una capacidad a tu base y todos los servicios la heredan de inmediato, lo has logrado. Si tuvieras que actualizar 633 archivos a mano, has fracasado. La prueba funciona igual de bien con 6 servicios que con 633; la única diferencia es lo mucho que duele descubrir la respuesta tarde.

Por qué la repetición es el superpoder

Los números detrás del argumento de que lo aburrido es hermoso:

Mira esa fila del más pequeño y el más grande. El servicio más simple tiene 87 líneas; el más complejo gestiona todo un flujo de operaciones de inversión en 2.214 líneas. Trabajos radicalmente distintos, esqueleto idéntico. La complejidad varía; el patrón, nunca.

Este es el concepto que debes llevarte: la IA es una replicadora perfecta. Lo que le des como referencia, lo reproducirá fielmente e incansablemente, lo que significa que la palanca está por completo en qué haces digno de replicar. Acierta con un patrón, una vez, y la IA lo estampará cientos de veces sin fatiga, sin ego y sin atajos. Si no aciertas con nada primero, la IA replicará caos con la misma alegría. La misma lógica impulsa la anatomía del prompt de producción: apunta la IA a tu mejor trabajo existente y deja que lo copie.

La creatividad pertenece a tu producto, tu posicionamiento, tu oferta. Tu código debería ser lo menos creativo que tengas.

12 semanasTu carrera corporativa nunca fue el planSolicita plaza en el Solopreneur Accelerator.Solicitar ahora →

Preguntas frecuentes

¿Qué es una capa de servicios, en lenguaje llano?

Es la capa intermedia de tu producto: el código que se sitúa entre la base de datos (donde viven los datos) y la interfaz (lo que ven los usuarios). Toda acción significativa (guardar, obtener, borrar, comprobar permisos) pasa por un servicio. Por eso la consistencia ahí importa más que en cualquier otro sitio.

¿Necesito 633 servicios?

No: ese número refleja una plataforma grande con varios productos. Pero el principio aplica desde tu quinto servicio. La trampa de un patrón distinto cada vez empieza en el servicio dos, y el coste de arreglar la inconsistencia crece con cada servicio que añades. Construye la base antes de construir a la multitud.

¿Cómo hago que la IA siga mi patrón siempre?

Dos movimientos. Primero, crea la base como un archivo real en tu producto, no como una idea en tu cabeza. Segundo, haz referencia a ella explícitamente en cada plano de funcionalidad con una regla sin excepciones. La IA sigue los ejemplos mucho mejor que las descripciones; la mecánica de apuntar la IA a archivos de referencia está en la anatomía del prompt de producción.

¿Qué pasa si me salto el patrón maestro?

Con diez servicios, tendrás diez patrones distintos: diez estilos de gestión de errores, diez enfoques de seguridad, diez maneras de hablar con la base de datos. Cada arreglo hay que redescubrirlo por servicio, y una limpieza en condiciones acaba significando reescribir la mayor parte de tu producto. Es la versión estructural de la trampa del vibe coding: avance rápido ahora, pagado con intereses después.