Blog
Lo que me hubiese gustado que me dijeran antes.
Sobre mí
Soy Fran. Quince años construyendo software y emprendiendo, ahora con IA en cada etapa. Estos artículos son las lecciones de ingeniería que voy sacando en el camino.
Cómo convertí cada regla de un scope del código en un test que un evaluador de IA corre sobre cada archivo, en cada commit, push y corrida de CI, en menos de 500 ms. El patrón, cómo funciona y lo que ahorra en tiempo, tokens y rondas de revisión.
leer
Una regla de marca dice que la cara del dueño no aparece en público. Entonces la marca necesitaba otra cara. Noventa y dos imágenes, siete tandas, las tres primeras descartadas enteras — y el proceso sin limpiar.
leer
Me bajé la documentación de un proveedor SaaS, se la di a agentes AI en paralelo, y en horas tenía un backend funcionando. Tu código ya no es tu ventaja competitiva.
leer
Construí un agente experto en Claude Code entrenado con un repo comunitario de 20k estrellas en vez de documentación oficial. Encontró 25 problemas en mi setup de producción, incluyendo secretos expuestos.
leer
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.
leer
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.
leer
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.
leer
Código agrupado por el problema que resuelve, no por su rol técnico. Ejemplos reales de arquitectura basada en features en producción.
leer
Reutilizar código suena eficiente, pero crea conexiones invisibles. Prefiero piezas independientes que puedan evolucionar por separado -- aunque se parezcan al principio.
leer
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.
leer
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.
leer
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.
leer