Construyendo una Plataforma SaaS de Producción de +20K Líneas con Claude Code: Lecciones de Ingeniería Agéntica a Escala

Descripción General del Proyecto

LastSaaS es un boilerplate SaaS de producción con cada línea escrita a través de conversación con Claude Code. No es una demo o juguete—alimenta una plataforma en vivo llamada Flipbook. La pila tecnológica incluye Go 1.25, React 19, TypeScript, MongoDB y Tailwind, publicado bajo licencia MIT.

Qué Incluye el Proyecto

• Base completa de SaaS con autenticación multi-tenant (OAuth, MFA, enlaces mágicos, rotación de JWT)
• Facturación con Stripe (suscripciones, por usuario, créditos)
• Capacidades de white-labeling
• 19 tipos de eventos de webhook
• Panel de administración y monitoreo de salud
• Servidor MCP integrado con 26 herramientas de solo lectura que permiten a asistentes de IA consultar paneles, usuarios, facturación y datos de salud

Lo que Funcionó

La explicitación de Go es una ventaja para agentes: Sin magia de frameworks significa que Claude Code no tiene que adivinar lo que el middleware está haciendo detrás de escena. Manejo explícito de errores, enrutamiento claro y patrones predecibles ayudan al agente a mantenerse en curso.

Los patrones consistentes se acumulan: Establecer patrones tempranos sobre cómo se estructuran los manejadores, servicios y acceso a datos permitió a Claude replicarlos en docenas de endpoints con alta consistencia, reduciendo dramáticamente la carga de cada nueva característica.

El servidor MCP fue construido por Claude para Claude: Las 26 herramientas de solo lectura crean una interfaz meta donde la IA construyó su propia forma de consultar el sistema.

El modelo de documentos de MongoDB simplificó la multi-tenencia: Claude no tuvo problemas manteniendo el aislamiento de inquilinos porque el modelo de datos hace explícitos los límites, evitando confusión con tablas de unión y abstracciones con fugas.

Lo que Requirió Disciplina

Aún necesitas visión arquitectónica: Claude Code es un ejecutor brillante pero no diseña sistemas. El humano debe proporcionar la arquitectura—saber cómo debe verse el RBAC multi-tenant, cómo deben funcionar los reintentos de entrega de webhooks y cómo debe ser el flujo de integración con Stripe.

Revisa todo: Especialmente código sensible a seguridad como rotación de JWT, firma HMAC, limitación de tasa y protección contra inyección. Claude lo hace bien la mayoría del tiempo, pero "la mayoría del tiempo" no es suficiente para flujos de autenticación—cada línea relacionada con seguridad necesita revisión humana.

Combate la deriva de patrones: En sesiones largas, Claude puede desviarse sutilmente de patrones establecidos. Re-anclar periódicamente la conversación ayuda: "Mira cómo implementamos el manejador de usuarios. Sigue el mismo patrón para webhooks."

El Concepto "Construido para Agentes"

La base de código está intencionalmente estructurada para que cuando alguien la bifurque y apunte su propio agente de IA hacia ella, el agente pueda extenderla fluidamente. Esto incluye estructura de archivos predecible, nomenclatura consistente y patrones explícitos—una base diseñada para ser extendida a través de conversación.

El repositorio está disponible en https://github.com/jonradoff/lastsaas.