Portfolio Maker: Habilidad de Diseño e Ingeniería Soberana
Soberana y Autónoma: Esta habilidad opera con total autonomía. No depende, delega ni requiere ninguna habilidad de diseño o animación externa de terceros. Toda la intuición estética, las matemáticas tipográficas, la armonía espacial, la dinámica de micro-interacciones, la eliminación de contenido genérico ('slop') y los componentes primitivos están integrados de forma nativa en esta habilidad.
🎯 Propósito y Misión Principal
Eliminar los portafolios genéricos y amateurs ('AI slop') y producir de forma autónoma portafolios de calidad profesional y listos para producción para cualquier profesional en 5 arquetipos principales:
- Ingenieros de Software y Arquitectos de Sistemas (Sistemas distribuidos, APIs de alto rendimiento, estilo 'bento' técnico y limpio)
- Editores de Video, Motion Graphics y Creadores (Reels virales, comparaciones antes/después de gradación de color, métricas de visualizaciones)
- Diseñadores de Producto y Líderes de UI/UX (Sistemas de diseño, casos de estudio, tipografía suiza de alto contraste, desglose de tokens)
- Investigadores de IA/ML e Ingenieros de Datos (Arquitecturas de modelos, publicaciones en arXiv, telemetría de benchmarks, insignias de pesos)
- Agencias, Consultores y Solopreneurs (Prueba social, reseñas de clientes, niveles de servicio, conversión de reservas sin fricción)
🚫 El Código de Honor Anti-'AI Slop' (APLICACIÓN ESTRICTA)
Cada portafolio generado DEBE pasar este riguroso filtro estético antes de generar el código:
1. Elementos Visuales Prohibidos:
- ❌ NUNCA uses el cliché del gradiente neón púrpura/violeta: No uses
from-purple-500 via-indigo-500 to-pink-500en titulares. No uses orbes de fondo borrosos de color púrpura (bg-purple-500/10 blur-3xl). - ❌ No uses cuadrículas grises planas y aburridas: Evita los bloques predeterminados de Tailwind
bg-gray-100/border-gray-300sin profundidad ni textura. - ❌ No uses bordes láser sobresaturados: Evita los trazos de neón synthwave de alta intensidad.
2. Paletas de Colores Aprobadas (Élite):
- Monocromo Titanio (Suizo Oscuro/Claro): Lienzo obsidiana profundo (
#09090b), capa de tarjeta elevada (#121215conbackdrop-blur-md), bordes finos (border-white/[0.08]), titulares blancos nítidos (#ffffff), texto atenuado zinc (#a1a1aa), focos sutiles de pizarra/blanco (rgba(255,255,255,0.06)). - Esmeralda y Pizarra de Precisión: Lienzo obsidiana (
#09090b), indicador de estado activo esmeralda (#10b981), tarjetas monocromáticas con sutiles acentos menta al pasar el ratón. - Cobalto Eléctrico Internacional: Lienzo carbón oscuro (
#0a0a0f), tipografía blanca nítida, botones y objetivos de interacción azul real eléctrico de alto contraste (#2563eb). - Arena Arquitectónica Cálida y Espresso: Lienzo crema cálido (
#fafaf9), titulares espresso intensos (#18181b), acentos sutiles de champán/ámbar (#d97706). - Rosa y Ámbar Cinematográficos: Lienzo obsidiana
#0b0c10, acentos de rosa de alto impacto (#e11d48) y ámbar cálido (#f59e0b) para creativos y reels de video.
3. Texto Relleno Prohibido ('Fluff'):
- ❌ Prohibido: "Desarrollador apasionado transformando ideas en soluciones digitales elegantes."
- ❌ Prohibido: "Innovando en la intersección del diseño, la tecnología y la empatía."
- ❌ Prohibido: "Profesional orientado a resultados con talento para la resolución de problemas."
- ✅ Requerido: Declaraciones concretas, basadas en métricas y centradas en el impacto:
- "Construí microservicios Go distribuidos que manejan 120k req/s con una latencia p99 de 14 ms."
- "Edité documentales virales de formato largo en YouTube que generaron más de 75 millones de visitas orgánicas."
- "Lideré el sistema de tokens de diseño de Figma para múltiples marcas, adoptado por 42 equipos de ingeniería."
🧠 El Motor Estético Nativo (Inteligencia de Diseño Integrada)
La IA debe aplicar estas leyes matemáticas de diseño a cada elemento:
1. Jerarquía Tipográfica y Ritmo Óptico
- Titulares de Pantalla (
text-4xlatext-6xl md:text-7xl) :- El interlineado debe ser ajustado (
leading-[1.08]aleading-[1.12]). Un interlineado suelto en fuentes grandes se ve amateur. - El espaciado entre letras debe ser comprimido (
tracking-tightotracking-tighter). - Pesos de fuente: Negrita o Extranegrita (
font-bold/font-extrabold) para técnico; Mediana o Seminegrita (font-medium/font-semibold) para serif editorial.
- El interlineado debe ser ajustado (
- Cuerpo de Texto (
text-baseatext-lg) :- El interlineado debe ser generoso (
leading-relaxedoleading-7) para garantizar la legibilidad. - Longitud de línea (Medida): Limita el ancho del cuerpo de texto usando
max-w-xlomax-w-2xl(45–75 caracteres por línea). Nunca permitas que los párrafos se extiendan a lo ancho de la pantalla. - Alineación del texto: Nunca centres más de 3 líneas consecutivas de texto del cuerpo. Alinea a la izquierda para una ergonomía de lectura humana.
- El interlineado debe ser generoso (
- Combinaciones de Fuentes Curadas:
- Tech Moderno:
InteroGeist Sans+JetBrains Monopara etiquetas y código. - Creativo de Alto Impacto:
Plus Jakarta SansoSyne+Inter. - Editorial y Lujo:
Cormorant Garamond(serif para display) +Inter(sans para cuerpo).
- Tech Moderno:
2. Ritmo Espacial y la Cuadrícula Matemática de 8pt
- Relleno de Secciones: Espacio de respiración vertical generoso (
py-20 md:py-28). Las secciones ajustadas asfixian el diseño. - Apilamiento de Diseño: El espaciado vertical entre secciones principales debe usar
space-y-24ospace-y-28. - Cuadrículas de Tarjetas: Estandariza con
gap-6ogap-8. - Contenedores de Ancho de Contenido:
- Editorial / Minimalista:
max-w-4xl mx-auto px-6 - Bento para Desarrolladores:
max-w-5xl mx-auto px-4 sm:px-6 - Reel Multimedia:
max-w-6xl mx-auto px-4 sm:px-6
- Editorial / Minimalista:
3. Elevación de Superficie y Ciencia de los Bordes Finos
- Capa 0 (Lienzo) :
#09090b(Oscuro) /#fafaf9o#ffffff(Claro). - Capa 1 (Base de Tarjeta) :
#121215/bg-white dark:bg-zinc-900/60conbackdrop-blur-md. - Capa 2 (Bordes Finos) :
border border-zinc-200/80 dark:border-zinc-800/80oborder border-white/[0.08]. Nunca uses sombras pesadas y embarradas. - Capa 3 (Micro-Hover) : Foco radial que sigue al cursor (
rgba(255,255,255,0.06)), o un sutil brillo de bordehover:border-zinc-400 dark:hover:border-zinc-700, más un sutil levantamientohover:-translate-y-0.5 transition-all duration-300.
4. Detalles Interactivos y Acabado
- Indicador de Estado en Vivo:
<div class="inline-flex items-center gap-2 px-3 py-1.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border border-emerald-500/20"> <span class="w-2 h-2 rounded-full bg-emerald-500 animate-pulse"></span> <span>Disponible para Oportunidades en Q1 2026</span> </div> - Píldora de Copia de Correo con un Solo Clic (con retroalimentación visual) : Proporciona copia instantánea al portapapeles con una transición de tooltip que confirma "¡Copiado!".
- Conmutador de Modo Dual (Tema) :
Incluye siempre un conmutador de tema funcional (Oscuro / Claro) con morfología de icono y persistencia en
localStorage.
📦 Arsenal de Componentes Verificados (Acceso Directo)
La habilidad incluye primitivas TSX listas para producción y catálogos completos verificados:
1. Héroes de Firma (components-library/heroes/):
ImageStreamHero.tsx: Carriles de transmisión con profundidad (creadores y editores de video).PerspectiveTunnelHero.tsx: Perspectiva espacial 3D en el eje Z con métricas en vivo (ingenieros y arquitectos).ProductRailGallery.tsx: Perchero interactivo con física de balanceo (e-commerce y moda).TiltedGridHero.tsx: Transmisión de imágenes 3D curvada hacia el espectador (diseñadores UI/UX y fotógrafos).PrismHero.tsx: Estética de refracción de cristal cromático (directores de arte y portafolios de lujo).TigerTearRevealHero.tsx: Efecto de revelación de desgarro interactivo (creativos de alto impacto).AgencyHero01.tsx: Héroe de agencia de alta confianza con avatares sociales e insignias de calificación (freelancers y agencias).ResponsiveHeroBanner.tsx: Banner cinematográfico con navegación glassmórfica (fundadores y líderes).CenteredImageFanHero.tsx: Titular destacado con collage de 3 imágenes en abanico (diseñadores de producto).
2. Primitivas Interactivas Independientes (components-library/):
- Fondos:
backgrounds/AuroraBackground.tsx(ondas sutiles de esmeralda/cian/pizarra, sin neón púrpura). - Tarjetas Interactivas:
cards/SpotlightCard.tsx(brillo que sigue al ratón),cards/Card3D.tsx(inclinación de perspectiva),cards/BorderBeam.tsx(haz de borde fino animado),cards/Meteors.tsx(partículas de estrellas fugaces). - Secciones y Diseños:
sections/BentoGrid.tsx(cuadrícula asimétrica responsiva),sections/InfiniteMarquee.tsx(teletipo continuo de tecnología/logos),sections/BeforeAfterSlider.tsx(comparación interactiva de imágenes/video),sections/VideoModal.tsx(ventana emergente de video cinematográfica),sections/TerminalWidget.tsx(CLI interactiva simulada). - Controles de UI:
ui/FloatingNav.tsx(barra de navegación flotante en píldora glassmórfica),ui/ShimmerButton.tsx(botón de acción con brillo),ui/TextGenerateEffect.tsx(revelación de palabras escalonada),ui/CopyEmailButton.tsx(píldora de copia con un clic),ui/ThemeToggle.tsx(conmutador de tema oscuro/claro).
3. Índice Maestro de Componentes:
- Accede al Catálogo Maestro de 21st.dev en
components-library/catalog/INDEX.mdque contiene más de 11,750 componentes categorizados en 22 categorías (Botones, Héroes, Galerías, Características, Precios, Pies de Página, FAQs, etc.).
4. Servidor MCP Oficial de shadcn (Sin Clave API):
- La IA utiliza el servidor shadcn MCP oficial (
npx shadcn@latest mcp) que es 100% gratuito, de código abierto y no requiere ninguna clave API. - Cualquier componente del catálogo se puede instalar mediante:
npx shadcn@latest add "https://21st.dev/r/<autor>/<nombre-del-componente>" - Nunca se requiere un MCP de 21st.dev de pago ni una clave API.
5. Inspiraciones de Plantillas Premium y Diseño de Movimiento:
La IA puede extraer activamente patrones arquitectónicos, movimiento cinético y diseños de alta conversión de los ecosistemas de diseño más premium del mundo:
- VibeUI (
vibeui.dev): Composiciones de componentes modernos, apilamientos de tarjetas táctiles, insignias interactivas, píldoras de control flotantes y primitivas de diseño estéticas. - Trical (
trical.so): Plantillas de portafolio ultralimpias y de alta conversión, tipografía de calidad de revista, líneas divisorias sutiles y estudios de caso de proyectos editoriales. - Motion Site (
motion.site.ai): Microanimaciones fluidas, revelaciones cinéticas de titulares, física de resorte y curvas de transición orgánicas. - 21st.dev y Aceternity UI: Catálogo maestro de más de 11,750 componentes compatibles con shadcn y primitivas de interacción espacial 3D.
⚡ Modos de Entrega Duales
La IA admite dos formatos de entrega flexibles según las necesidades del usuario:
Modo A: Código Base Completo React + Vite + Tailwind (TypeScript) (Predeterminado)
Genera una estructura de proyecto completa, modular y de nivel empresarial:
mi-portafolio/
├── package.json
├── vite.config.ts
├── tailwind.config.js
├── postcss.config.js
├── tsconfig.json
├── index.html
└── src/
├── main.tsx
├── App.tsx
├── index.css
├── components/
│ ├── ui/ (Spotlight, ThemeToggle, CopyEmailButton, FloatingNav)
│ └── sections/ (Hero, BentoGrid, Projects, Experience, Footer)
└── types/index.ts
Modo B: Archivo HTML/Tailwind/Lucide/JS Único e Instantáneo
Cuando el usuario quiere cero configuración, vista previa inmediata en el navegador local o alojamiento instantáneo (ej. GitHub Pages):
- Genera un único
index.htmlautónomo, bellamente formateado. - Incluye CDN de Tailwind CSS, Google Fonts, CDN de Lucide Icons y JavaScript vanilla para el conmutador de tema, retroalimentación de copia, ventanas emergentes modales e interacciones al pasar el ratón.
- Consulta las implementaciones de referencia en
templates/developer-bento/index.html,templates/creative-minimalist/index.htmlytemplates/video-editor-showreel/index.html.
🛠️ Flujo de Trabajo de Ejecución Paso a Paso
┌────────────────────────────────────────────────────────┐
│ PASO 1: RECEPCIÓN Y EXTRACCIÓN DEL CURRÍCULUM │
│ Extraer métricas, roles, proyectos, stack tecnológico │
│ (O ejecutar cuestionario de 3 lotes de respaldo) │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ PASO 2: ALINEACIÓN INTERACTIVA OBLIGATORIA │
│ Preguntar: Estética, Modo de Tema, Héroe y Componentes │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ PASO 3: SELECCIÓN DE COMPONENTES Y ARQUITECTURA │
│ Ensamblar primitivas de 21st.dev desde components-library/ │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ PASO 4: GENERACIÓN DE CÓDIGO DE PRODUCCIÓN │
│ Generar React + Vite (predeterminado) o HTML autónomo │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ PASO 5: AUDITORÍA E INSTRUCCIONES DE EJECUCIÓN │
│ Verificar reglas anti-slop, comprobar compilación, │
│ proporcionar comandos │
└────────────────────────────────────────────────────────┘
Paso 1: Protocolo de Recepción
- Si el usuario proporciona un currículum o resumen de LinkedIn: Analiza métricas reales, línea de tiempo profesional, los 3-4 proyectos principales y competencias técnicas.
- Si no se proporciona currículum: Nunca inventes credenciales. Ejecuta el cuestionario de 3 lotes desde references/questionnaire.md:
- Lote 1: Identidad y Rol Objetivo
- Lote 2: Los 2-3 Proyectos Principales y Números Concretos
- Lote 3: Enlaces Sociales y de Contacto
Paso 2: Alineación Interactiva Obligatoria (NO SALTAR)
A menos que el usuario haya especificado explícitamente su estilo visual y componentes de antemano, pausa y presenta la alineación interactiva:
"Antes de generar tu portafolio, personalicemos el diseño visual y los componentes interactivos:
- Estilo Visual / Estética:
- Tech Elegante / Bento Oscuro (Estilo Linear / 21st.dev — lienzo obsidiana, tarjetas con efecto spotlight al pasar el ratón, bordes finos).
- Minimalista Limpio / Moderno Suizo (Estilo Dieter Rams / Apple — espacios en blanco generosos, tipografía refinada, líneas sutiles).
- Editorial de Alto Contraste (Titulares serif, estética de estudio, estudios de caso tipo revista).
- Creador Cinematográfico / Movimiento (Lienzo oscuro profundo, inserciones de reels de video enriquecidos, insignias de número de visualizaciones).
- Neo-Brutalismo (...
[truncado para traducción - el documento continúa con el mismo patrón de localización para el resto del contenido]