El desarrollo web moderno está pasando de escribir código de forma manual a un rol más arquitectónico, donde los desarrolladores usan agentes de IA para que se encarguen de los detalles de implementación de pipelines complejos. Esta guía detalla un flujo de trabajo completo para crear un sitio web de portafolio 3D que incluye visores interactivos de personajes, assets optimizados y una estética inspirada en videojuegos.
Al utilizar flujos de trabajo basados en agentes, puedes pasar de un proyecto en blanco a un sitio interactivo listo para producción en una fracción del tiempo que requerirían los métodos tradicionales.
1. Configuración del entorno y las herramientas
Para empezar, debes configurar un entorno de desarrollo centrado en un agente de programación con IA capaz de planificar a alto nivel y ejecutar tareas en paralelo.
Selección de la plataforma de agentes
Para este pipeline, se utiliza la plataforma basada en agentes Verdent. Aunque está disponible para VS Code y JetBrains, se recomienda la aplicación de escritorio por su interfaz simplificada, lo que la hace accesible para quienes se enfocan en la arquitectura general en lugar de la sintaxis de bajo nivel.
Probar VerdentSelección e integración del modelo
El motor principal de este flujo de trabajo es Claude 4.5 Opus. Este modelo es especialmente eficaz para aplicaciones web 3D debido a su alta capacidad de razonamiento y su eficiencia al generar estructuras de código complejas.
- Conexión con GitHub: vincula tu cuenta de GitHub a Verdent para permitir que el agente gestione el control de versiones y la creación de ramas automáticamente.
- Gestión de espacios de trabajo: una de las funciones más potentes de esta configuración es la capacidad de ejecutar múltiples espacios de trabajo en paralelo. Esto te permite desarrollar herramientas auxiliares (como optimizadores de assets) en una rama mientras creas el portafolio principal en otra, evitando los conflictos de código habituales en los editores de código con IA convencionales.

2. Desarrollo de un optimizador personalizado de assets 3D
Un portafolio 3D de alta calidad depende del rendimiento. Los modelos 3D (archivos GLB) suelen ser pesados y a veces superan los 50MB, lo que puede provocar tiempos de carga inaceptables en la web. Antes de crear el sitio, deberías crear una herramienta específica de optimización.
Estructurar el prompt para la arquitectura de la herramienta
Abre un nuevo espacio de trabajo y pídele al agente mediante un prompt que cree una aplicación web local en Next.js que utilice la biblioteca glTF-transform. El objetivo es una interfaz sencilla de «arrastrar y soltar» que automatice lo siguiente:
- Conversión de texturas al formato WebP.
- Optimización de la malla para reducir la cantidad de vértices.
- Redimensionamiento de texturas a una resolución máxima de 1k o 2k.
Ejecución y pruebas
Ejecuta el agente y deja que construya la estructura de archivos. Una vez que termine, puedes iniciar el servidor local y soltar un modelo GLB pesado en la interfaz.
Por qué es importante esto
Una optimización eficaz puede reducir el tamaño de un modelo de 49MB a aproximadamente 500KB sin una degradación visual significativa.
Práctica recomendada: usa texturas de 2k o 4k cuando necesites alta fidelidad, pero asegúrate de que el optimizador las comprima para la versión web final, de modo que el sitio siga funcionando con fluidez en celulares.

3. Diseño de la arquitectura del portafolio
Con la herramienta de optimización lista, pasa a un nuevo espacio de trabajo para comenzar el proyecto principal del portafolio.
Uso del modo de planificación del agente
En lugar de lanzarte directo al código, cambia el agente a Plan Mode. Esto obliga al agente a analizar los requisitos, verificar su propia lógica y presentar una hoja de ruta.
- Revisión del diagrama: el agente generará un diagrama técnico de la arquitectura del sitio.
- Reducción de la complejidad: los agentes de IA suelen sugerir diseños de varias páginas por defecto. Para mantener una sensación moderna de «estilo videojuego», indícale al agente que consolide la experiencia en una sola pantalla de entrada de alto impacto y un visor principal.
Definición de las restricciones de UI y UX
Comunica tu visión utilizando una combinación de texto e imágenes de referencia. Una estructura de prompt muy efectiva para este portafolio incluye:
- Pantalla de entrada: una página de inicio con una miniatura y un botón «Enter Portfolio».
- Diseño del visor de personajes: una estructura de pantalla dividida donde el personaje 3D ocupa el 60% del lado izquierdo y una tarjeta de información ocupa el lado derecho.
- Navegación: botones para alternar entre personajes (Left/Right) y un sistema que ajusta automáticamente el personaje a la altura de la pantalla.
- Estilo visual: un fondo negro puro, un suelo de cuadrícula infinita que se desvanece en la distancia y partículas flotantes tipo «sparkle» o «star dot» para dar profundidad.

4. Perfeccionamiento del entorno 3D
Una vez que el agente comience a construir, se detendrá para hacer preguntas aclaratorias. Este ciclo interactivo es fundamental para lograr esa estética específica de «estilo videojuego».
Ajustes del entorno
Cuando el agente te lo pida, especifica las siguientes configuraciones:
- Estilo de cuadrícula: elige una cuadrícula infinita que se desvanezca hasta quedar negra. Para mantener la coherencia de marca, más adelante puedes pedir que se cambie el color de la cuadrícula (por ejemplo, a naranja).
- Estilo de partículas: selecciona «floating sparkles» para crear una sutil sensación de movimiento en el fondo.
- Interacción del usuario: desactiva la rotación automática. El personaje solo debe rotar según la interacción del usuario para brindar una sensación más táctil, como de «menú de juego».
Gestión de animaciones
Asegúrate de que los modelos de tus personajes (GLB) incluyan animaciones de correr o de reposo. Debes indicarle al agente que active estas animaciones automáticamente al cargarse el personaje.
5. Integración de assets y corrección automática de rutas
Una gran ventaja de este flujo de trabajo con agentes de IA es la capacidad del agente para escanear tus carpetas locales y ajustar el código en función de lo que encuentre.
Organización de archivos locales
Ve a la carpeta de tu proyecto en el explorador de archivos y coloca tus assets de la siguiente manera:
- Modelos: Coloca los archivos .glb optimizados en el directorio
public/models. - Imágenes de la UI: Coloca las miniaturas o fotos de perfil en la carpeta
public/images.
Inyección dinámica de datos
Proporciónale al agente una lista de datos de tus personajes que incluya nombres y descripciones, herramientas utilizadas para crearlos y enlaces a archivos fuente o contenido de video externo. El agente no solo completará las estructuras de datos, sino que también corregirá automáticamente las rutas de los archivos. Por ejemplo, si proporcionas un .jpg pero el código esperaba un .png, el agente detectará el archivo en tu carpeta y actualizará el código en consecuencia sin intervención manual.

6. Refinamiento iterativo y retroalimentación visual
La etapa final del pipeline implica un "ciclo de retroalimentación" en el que utilizas capturas de pantalla para "quejarte" con el agente sobre inconsistencias visuales.
Corrección de proporciones y layout
Carga el proyecto en tu navegador. Si el modelo 3D se ve demasiado pequeño o la tarjeta de información está desalineada, toma una captura de pantalla de la ventana del navegador.
El prompt de la captura de pantalla: Vuelve a subir la captura de pantalla al agente y dale críticas específicas. Por ejemplo: "La tarjeta de la derecha está actualmente sobre un fondo negro; muévela para que se superponga al 3D viewer. Además, haz que el modelo se ajuste a toda la altura de la pantalla y haz zoom de forma normal".
Estilo avanzado
Para alejarte de una apariencia genérica, aplica branding personalizado:
- Branding: Pídele un tema de "estilo naranja" que coincida con los colores específicos de la marca.
- Mejoras de componentes: En lugar de enlaces de texto simples para videos externos, pídele al agente que cree "tarjetas con miniaturas de YouTube" que ofrezcan una vista previa visual del contenido.

Resultado final
Al seguir este pipeline, pasas de ser un "programador" a un arquitecto. El resultado es un portafolio 3D interactivo y de alto rendimiento que incluye:
Optimizador 3D personalizado
Una herramienta dedicada a preparar assets listos para la web.
Carrusel interactivo de personajes
Transiciones suaves entre modelos 3D con animaciones activas.
UI estilo videojuego
Una interfaz elegante y oscura con partículas flotantes, cuadrículas infinitas y tarjetas interactivas con branding.
Gestión automatizada de datos
Un sistema que vincula automáticamente tus assets 3D con metadatos descriptivos y enlaces externos.
Todo este proceso, desde la creación de la herramienta hasta el refinamiento final, se puede completar en aproximadamente 20 minutos al gestionar eficazmente las fases de planificación y ejecución del agente de IA.
La demo descrita en esta guía está disponible en TOP 3D AI. Iníciala para ver el portafolio 3D estilo videojuego en acción.
Iniciar la demo del portafolio 3D