// MBA · IA · FullStack · +10 años
Lo que me hubiese gustado que me dijeran antes.
Sobre mí
Hola, soy Fran — desarrollador full-stack en Nieve Consulting. En mi tiempo libre construí Cliencer, un SaaS completo desde cero, solo. Estos artículos son las lecciones de ingeniería que fui sacando en el camino.
Trabajás en un codebase grande y Claude Code no para de perder contexto. Cómo colocar documentación en cada nivel de directorio le da al agente exactamente lo que necesita — nada más.
Patrones prácticos para desarrollo asistido por IA: cómo estructuro flujos de trabajo con agentes para entregar código de producción, no solo prototipos.
Cada función pública tiene JSDoc. Cada decisión tiene una razón. Ejemplos reales de un SaaS en producción sobre cómo el código autodocumentado elimina el conocimiento tribal.
Código agrupado por el problema que resuelve, no por su rol técnico. Ejemplos reales de arquitectura basada en features en producción.
Reutilizar código suena eficiente, pero crea conexiones invisibles. Prefiero piezas independientes que puedan evolucionar por separado -- aunque se parezcan al principio.
Organizar el código alrededor de dominios de negocio -- no de capas técnicas -- permite que cada área evolucione de forma independiente, reduciendo riesgo y acelerando la entrega.
Si una solución es difícil de explicar, probablemente está mal. Ejemplos concretos de elegir simplicidad en un codebase real con Node.js y Next.js.
Cómo aplicar responsabilidad única en middleware, controladores y lógica de dominio convierte un codebase SaaS en algo más rápido de depurar, más seguro de modificar y más fácil de aprender.