Portfolio Personal

Lo estás viendo. Este sitio se construyó en 12 horas, desde el primer commit hasta producción. No un prototipo de hackathon. No una landing page. Un portfolio bilingüe completo con SSR, contenido MDX y puntuaciones Lighthouse superiores a 95. Lo construí a principios de 2025 como experimento: ¿qué pasa cuando combinas una visión clara con ejecución acelerada por IA? En ese momento, este flujo de trabajo era nuevo. Ahora es como construyo todo.

Por qué 12 horas

Establecí la restricción deliberadamente. Los portfolios son trampas de procrastinación. He visto ingenieros pasar meses ajustando el suyo en lugar de hacer el trabajo que intentan mostrar. Quería demostrarme algo: con el flujo de trabajo correcto, entregar rápido no significa entregar descuidado.

La restricción forzó decisiones difíciles. Sin animaciones personalizadas. Sin interacciones elaboradas. Solo tipografía limpia, tiempos de carga rápidos y contenido que dice lo que realmente hago. Resulta que eso es suficiente.

Cómo encaja la IA

Usé Claude para aproximadamente el 80% de la generación de código. Pero esto es lo que eso realmente significa: tomé cada decisión arquitectónica. Elegí la estructura de componentes. Diseñé el enrutamiento. Decidí qué contenido va dónde y cómo se lee. La IA escribió el boilerplate que implementa mis decisiones.

El flujo de trabajo tiene límites claros. No le pido a la IA que tome decisiones de producto. No entrego código que no entiendo. Cuando Claude genera algo, lo leo, pienso si lo escribiría de la misma manera, y a menudo reescribo partes. La velocidad viene de eliminar la escritura, no el pensamiento.

Esto importa porque la narrativa de la programación con IA a menudo está equivocada en ambas direcciones. Los escépticos piensan que es inútil. Los entusiastas piensan que reemplaza a los desarrolladores. La realidad: es un multiplicador de la habilidad existente. Si sabes qué construir, la IA te ayuda a construirlo más rápido. Si no lo sabes, la IA te ayuda a construir lo incorrecto más rápido.

El stack

Next.js con App Router. TypeScript en modo estricto. Tailwind CSS. next-intl para i18n. MDX para contenido. Vercel para despliegue. Nada experimental, nada rebuscado. Herramientas probadas que conozco lo suficientemente bien para moverme rápido.

La configuración bilingüe fue más trabajo de lo esperado. No la traducción en sí, sino el enrutamiento, los metadatos, el cambio de contenido. next-intl maneja la mayor parte, pero siempre hay edge cases. Inglés como predeterminado sin prefijo, español con /es, componentes compartidos que necesitan funcionar en ambos contextos.

MDX vale el tiempo invertido en configurarlo. Escribir contenido en Markdown se siente natural. Incrustar componentes React cuando los necesito mantiene las cosas flexibles. Las páginas de proyectos que estás leyendo son archivos MDX con metadatos exportados. Fácil de escribir, fácil de mantener.

Rendimiento

Lighthouse 95+ en todas las categorías. First Contentful Paint bajo 200ms en p99. Cero bugs post-lanzamiento.

Esto no fue accidental. Next.js te lleva la mayor parte del camino con SSR y optimización automática de imágenes. El modo estricto de TypeScript detecta bugs antes de que se desplieguen. Vercel maneja la caché. El trabajo restante fue simplemente no arruinarlo: sin JavaScript innecesario, sin cambios de layout.

Lo que aprendí

Las restricciones son herramientas, no limitaciones. El deadline de 12 horas eliminó mi tendencia a invertir demasiado tiempo en pequeños detalles. No podía pasar dos días eligiendo fuentes. No podía reconstruir la biblioteca de componentes tres veces. Tenía que tomar decisiones y seguir adelante.

La colaboración con IA requiere criterio. La parte difícil no es conseguir que la IA genere código. Es saber qué pedir y saber cuándo el resultado es suficientemente bueno. Eso requiere haber construido cosas de la manera lenta primero. Necesitas un modelo mental de cómo se ve lo correcto.

Entregar supera a perfeccionar. Este sitio no es perfecto. Hay cosas que cambiaría. Pero existe, funciona, y puedo iterar. La alternativa era otro mes de planificación sin una sola línea de código en producción.

El flujo de trabajo es repetible. He usado este mismo enfoque en prototipos desde entonces. Pensamiento de producto claro, ejecución acelerada por IA, restricciones ajustadas. Cambia lo que una persona puede entregar en un fin de semana.