Génesis de Portafolio
Generador de portafolios con un solo prompt. Produce sitios completos y desplegables con animaciones GSAP profesionales, diseño responsivo y estéticas distintivas que parecen hechas a mano — no generadas por IA. El usuario abre index.html en el navegador y ve un portafolio de calidad profesional.
Filosofía
- Cada portafolio cuenta una historia. El diseño ES el primer proyecto del portafolio.
- Anti-plantilla: no hay dos sitios generados que se vean iguales. El tema se basa en el campo, la personalidad y el tono del usuario.
- "Abre index.html y di GUAU" — cero npm, cero pasos de compilación, gratificación instantánea.
- Restricción = libertad: HTML/CSS/JS vanilla + GSAP fuerza un CSS creativo que se siente hecho a mano.
- Un portafolio con 3 proyectos bien presentados supera a 20 tarjetas genéricas. Calidad sobre cantidad.
- La experiencia de desplazamiento ES el portafolio. Cada píxel desplazado debe sentirse intencional.
Proceso
Paso 1: Recopilación
Extraer del prompt del usuario:
- Identidad: nombre, usuario/alias, rol/título
- Biografía: 1-3 oraciones (sintetizar del contexto si no se proporciona)
- Proyectos: título, descripción, etiquetas, enlaces, montos de acuerdos, rol
- Redes sociales: X, Discord, Telegram, GitHub, LinkedIn, email, YouTube (solo incluir las proporcionadas)
- Avatar: ruta de archivo o generar círculo CSS degradado con iniciales
- Estadísticas: años de experiencia, cantidad de proyectos, alcance comunitario, herramientas exploradas
- Tono: profesional | hacker | creativo | elegante | juguetón | minimalista | cibernético
Si el usuario proporciona información mínima, generar con datos contextualmente relevantes de marcador de posición y marcar puntos de inyección: <!-- CUSTOMIZE: Reemplaza con tu usuario de Twitter -->. Omitir botones sociales por completo si no se proporciona ninguna URL — nunca renderizar href="#".
Paso 2: Selección de Tema
Usar el árbol de decisiones a continuación para seleccionar entre 5 temas. Luego leer el archivo del tema desde references/themes/{nombre-del-tema}.md.
¿El usuario está en crypto/web3/blockchain?
SÍ → ¿"limpio"/"minimalista" mencionado? → mono-minimal
De lo contrario → midnight-glass (por defecto) o neon-cyberpunk (si "neón"/"cibernético" mencionado)
¿El usuario es diseñador/artista/creativo?
SÍ → ¿Prefiere oscuro? → midnight-glass
De lo contrario → warm-organic (por defecto) o paper-brutalist (si "editorial"/"impreso")
¿El usuario es desarrollador/ingeniero?
SÍ → midnight-glass (por defecto) o mono-minimal (si "limpio"/"minimalista")
¿El usuario es estudiante/principiante?
SÍ → warm-organic (amigable) o neon-cyberpunk (si joven/energético)
¿El usuario es empresario/profesional?
SÍ → mono-minimal (por defecto) o warm-organic (si "accesible")
Anulaciones explícitas (máxima prioridad):
"oscuro" / "cristal" → midnight-glass
"claro" / "limpio" / "papel" → paper-brutalist
"neón" / "cibernético" / "futurista" → neon-cyberpunk
"cálido" / "terroso" / "orgánico" → warm-organic
"minimalista" / "mono" / "tipografía" → mono-minimal
Paso 3: Generar Archivos
Leer los archivos de referencia en este orden:
references/themes/{tema-seleccionado}.md— colores, fuentes, estilo de tarjetareferences/animations/gsap-patterns.md— recetas de animaciónreferences/sections/hero-variants.md— elegir diseño de héroereferences/typography/font-pairings.md— confirmar elección de fuente
Generar exactamente 3 archivos: index.html, css/style.css, js/main.jsre
Decisión de Diseño de Héroe
¿Imagen de avatar proporcionada?
SÍ → Avatar centrado (por defecto)
Excepción: diseñador con muestra de proyecto sólida → Héroe dividido
NO → ¿Título/eslogan fuerte? → Tipografía de pantalla completa
De lo contrario → Minimalista (nombre + rol + indicador de desplazamiento)
Cantidad de descriptores de rol:
1 → Subtítulo grande único
2-3 → Línea de subtítulo separada por puntos
4+ → Rotación de roles animada mediante intercambio de texto GSAP
Decisión de Sección de Proyectos
Cantidad de proyectos:
0 → Omitir proyectos. Agregar sección de nube de etiquetas de Habilidades/Tecnología
1-2 → Tarjetas destacadas grandes (ancho completo o 2 columnas con relleno extra)
3-4 → Cuadrícula de 2 columnas con tamaño igual
5-8 → Cuadrícula Bento (1 grande + tarjetas más pequeñas)
9+ → Mostrar los 6 principales con enlace "Ver todo", o desplazamiento horizontal
Paso 4: Control de Calidad
Ejecutar la lista de verificación previa a la entrega antes de generar los archivos.
Estructura de Salida
index.html
HTML5 semántico completo. Enlaces CDN para Google Fonts y GSAP 3.12.5. Todo el contenido en línea. Secciones: navegación, héroe, acerca, proyectos (si aplica), marquesina/habilidades opcional, contacto, pie de página. Incluye:
<!DOCTYPE html>,<html lang="en">, charset, viewport<title>con nombre de usuario + rol<meta name="description">con biografía- Etiquetas OG:
og:title,og:description,og:type(website) - Google Fonts
<link rel="preconnect">+ hoja de estilo - GSAP + ScrollTrigger CDN con
defer <link rel="stylesheet" href="css/style.css"><script src="js/main.js" defer>al final del body
css/style.css
Todos los estilos. Propiedades personalizadas CSS en :root (mínimo 20 variables que cubren colores, fuentes, espaciado, radio, easing). Totalmente responsivo (768px + 480px breakpoints). Debe incluir:
- Reinicio:
*, *::before, *::after { margin:0; padding:0; box-sizing:border-box } html { scroll-behavior: smooth }+ barra de desplazamiento personalizadabody { overflow-x: hidden; -webkit-font-smoothing: antialiased }::selectioncon acento del tema- Superposición de ruido (feTurbulence SVG en línea, opacidad 0.02-0.04)
.reveal-up { opacity: 0; transform: translateY(30px) }estado inicial@media (prefers-reduced-motion: reduce)— deshabilitar todas las animaciones, ocultar brillo del cursor- Cada elemento decorativo fijo/absoluto:
pointer-events: none
js/main.js
Animaciones GSAP envueltas en DOMContentLoaded. Comienza con verificación de disponibilidad de GSAP:
if (typeof gsap === 'undefined') {
document.querySelectorAll('.reveal-up').forEach(el => {
el.style.opacity = '1';
el.style.transform = 'none';
});
return;
}
Registra ScrollTrigger. Contiene: línea de tiempo de entrada al héroe, revelaciones al desplazarse, contadores de estadísticas, inclinación de tarjetas, brillo del cursor, botones magnéticos, paralaje, reducción de navegación. Leer references/animations/gsap-patterns.md para implementaciones exactas.
Puntos de Personalización
| Ubicación | Fuente de Datos | Alternativa |
|---|---|---|
<title> | Nombre + rol | "Portafolio" |
<meta description> | Rol + habilidades | Generado a partir del rol |
| Etiquetas OG | Igual que título/desc | Igual |
| Logo de navegación | Usuario entre corchetes [MX] | Iniciales |
| H1 de héroe | Rol o declaración de identidad | Campo + "Constructor" |
| Subtítulo de héroe | Roles separados por · | 3 áreas de habilidad |
| Insignia de héroe | @usuario | "@username" |
Avatar src + alt | Ruta del usuario | Círculo CSS degradado con iniciales |
| Botones sociales | Solo URLs reales | Omitir botón si no hay URL |
| Encabezado de Acerca | Declaración personal | "Construyendo en la intersección de X, Y & Z" |
| Biografía de Acerca | Proporcionado por usuario o sintetizado | Biografía de 3 oraciones |
| Etiquetas | Áreas de habilidad | Del rol/proyectos |
| Tarjetas de estadísticas | Números reales + etiquetas | Estimaciones del contexto |
| Tarjetas de proyecto | Título, desc, etiquetas, enlaces | De información del proyecto |
| Tarjetas de contacto | Plataforma, usuario, URL | Solo plataformas proporcionadas |
| Pie de página | Nombre + new Date().getFullYear() | Año dinámico mediante JS |
Anti-patrones
| # | Anti-patrón | Por qué Falla | Hacer en su Lugar |
|---|---|---|---|
| 1 | Inter/Roboto como fuente de encabezado | Señala instantáneamente "generado por IA". Son fuentes de cuerpo, no fuentes de exhibición. | Usar fuentes de exhibición distintivas: Syne, Outfit, Instrument Serif, Bricolage Grotesque, Unbounded |
| 2 | Degradado púrpura sobre blanco | El cliché visual #1 de "basura de IA" desde 2023. Todos lo reconocen. | Fondos oscuros con acentos vívidos, o paletas cálidas. |
| 3 | Space Grotesk como predeterminado | Era distintivo en 2023, ahora la fuente más sobreutilizada en sitios generados por IA. | Rotar entre 12 combinaciones seleccionadas. Usar solo si el usuario lo marca explícitamente. |
| 4 | opacity:0 sin alternativa de GSAP | Si el CDN de GSAP falla, todo el sitio es invisible. Página en blanco. | Primera línea de JS: verificar typeof gsap, si no está definido poner todos los .reveal-up visibles. |
| 5 | Gran héroe, genérico abajo del pliegue | El "guau" muere al desplazarse. Tarjetas de molde debajo de un héroe cinematográfico. | Cada sección recibe igual atención de diseño. El viaje de desplazamiento ES el portafolio. |
| 6 | href="#" en enlaces sociales | Hace que el sitio sea obviamente falso. Mata la credibilidad. | Usar URLs reales. Si no se proporciona ninguna, omitir el botón por completo. |
| 7 | Misma temporización de animación en todas partes | Todo a la misma velocidad y con el mismo easing se siente robótico. | Variar duraciones (0.4s-1.2s). Diferentes easings por elemento. Escalonar con desplazamientos negativos. |
| 8 | Elementos decorativos sin pointer-events: none | Orbes, ruido, brillo del cursor bloquean los clics del mouse en el contenido debajo. | Cada elemento decorativo fijo/absoluto recibe pointer-events: none. |
| 9 | Texto degradado sobre fondo degradado | Ilegible. Dos degradados en competencia se cancelan mutuamente. | Texto degradado solo en fondos oscuros sólidos/casi sólidos. Un degradado por área visual. |
| 10 | Falta cursor: pointer en tarjetas | La tarjeta parece interactiva pero el cursor permanece predeterminado. Usuario confundido. | cursor: pointer en cada elemento con estado hover o controlador de clic. |
| 11 | Iconos emoji en la interfaz de usuario | Señal universal de "hecho por IA". Sin esfuerzo de diseño. | SVG en línea desde assets/social-icons.svg. Sin emoji en navegación, botones, encabezados. |
| 12 | width: 100vw | En Windows con barra de desplazamiento, incluye el ancho de la barra → desbordamiento horizontal. | Usar width: 100% o overflow-x: hidden en el body. |
| 13 | Cargar biblioteca de iconos para 5 iconos | Solicitud HTTP adicional, FOUC, dependencia de CDN para ~2KB de rutas SVG. | SVG en línea directamente en HTML. 5-8 iconos sociales = ~2KB en línea. |
| 14 | Texto de CTA genérico | "Conectémonos" / "Ponte en Contacto" — todos los portafolios de IA usan estos. | Coincidir con la personalidad: "Construyamos Algo" (constructor), "Di gm" (crypto), "Deja una Línea" (informal). |
| 15 | Falta alt en avatar | Falla accesibilidad. Los lectores de pantalla no anuncian nada. | alt="[Nombre del usuario]" — simple, descriptivo. |
| 16 | Texto degradado arcoíris de 4+ colores | Parece un juguete. Los degradados multicolores rara vez funcionan. | Máximo 2-3 colores de la misma familia (rosa → púrpura, no rosa → verde → azul). |
Animaciones Requeridas
Leer references/animations/gsap-patterns.md para implementaciones. Cada sitio debe incluir:
- Línea de tiempo de entrada al héroe —
.from()escalonados: avatar (back.out), insignia, líneas de título, subtítulo, redes sociales (back.out escalonado), indicador de desplazamiento. Superpuestos con desplazamientos negativos. - Revelaciones al desplazarse — elementos
.reveal-upaniman desde{y:30, opacity:0}enstart: "top 85%". Escalonar dentro de grupos del viewport. - Contadores de estadísticas — animar de 0 a objetivo mediante
onUpdate. Activados al desplazarse. - Inclinación de tarjetas — mousemove →
rotateX/rotateYdesde el desplazamiento del cursor.transformPerspective: 1000. Reiniciar al salir del mouse. - Brillo del cursor — degradado radial de 600px sigue al mouse con
requestAnimationFrame+ 0.08 lerp. - Botones magnéticos — los botones sociales se mueven hacia el cursor (factor 0.3x), regresan con
elastic.out(1, 0.5). - Fondo de paralaje — elementos decorativos se mueven al desplazarse con
scrub: 1. - Reducción de navegación — alternar clase
.scrolleda 80px de profundidad de desplazamiento.
Opcional (agregar según tema/contenido):
- Marquee con aumento de velocidad de desplazamiento
- Revelación de texto letra por letra (ciberpunk/dramático)
- Desplazamiento horizontal para 5+ proyectos
- Brillo de texto degradado al hover
- Deslizamiento de etiqueta de sección desde la izquierda
Lista de Verificación de Calidad
Estructural:
- Los 3 archivos generados (index.html, css/style.css, js/main.js)
- DOCTYPE, charset, viewport, atributo lang presentes
- Metaetiquetas OG con información real del usuario
- Todas las propiedades personalizadas CSS en
:root - Enlaces CDN de GSAP con
defer - JS vinculado al final del body con
defer
Contenido:
- Todos los datos del usuario inyectados (nombre, enlaces, proyectos, biografía)
- Sin marcadores de posición genéricos ("Lorem ipsum", "Tu Nombre Aquí")
- Los enlaces sociales usan URLs reales, sin
href="#"para enlaces proporcionados - Pie de página tiene nombre correcto y año dinámico
Visual:
- La combinación de fuentes NO es Inter, Roboto, Arial o Space Grotesk (a menos que el usuario lo especifique)
- Sin esquema de color púrpura sobre blanco
- Sin iconos emoji en la interfaz de usuario
- Contraste de color cumple WCAG AA (4.5:1 para texto del cuerpo)
- Responsivo en 375px, 768px, 1440px — sin desplazamiento horizontal
-
prefers-reduced-motiondeshabilita animaciones y oculta el brillo del cursor
Técnico:
- Alternativa de GSAP presente (verificación typeof + reinicio de opacidad)
- Todos los elementos decorativos tienen
pointer-events: none - Sin
width: 100vwen CSS - Todos los elementos interactivos tienen
cursor: pointer - Las imágenes tienen atributos
alt - Los enlaces externos tienen
target="_blank" rel="noopener"