Valladolid · desde 2018 pablotheblink.com · Modo Blink
PBPabloTheBlink
Portada Librerías Proyectos Devetty Blog
Pablo Martínez↗
Menú
Portada Librerías Proyectos Devetty Blog
pablotheblink.com · Modo Blink
Cambiar a Pablo Martínez↗
← Volver al blog
Diseño 2026-11-22 6 min

Diseñar con agentes: por qué un agente ciego solo cambia colores

Sin ojos, un modelo de lenguaje solo añade padding y recolorea CSS. Así montamos un bucle visual con capturas reales y prototipado antes de tocar el código.

Si le pides a un modelo de lenguaje en una terminal que rediseñe una interfaz para hacerla «más limpia y moderna», el resultado suele ser el mismo: cambia el gris #333333 por azul pizarra, añade rounded-2xl a todas las esquinas, mete un gradiente violeta en el fondo y asegura que ha mejorado la experiencia de usuario.

Al abrir la página en un navegador real, la realidad te golpea de frente: los botones se solapan con la cabecera fija, los titulares en pantallas pequeñas rompen palabras provocando scroll horizontal y las tarjetas forman una masa ilegible.

El problema no es que el modelo sea torpe. El problema es que es ciego. Un modelo de lenguaje procesa cadenas de texto y tokens CSS; no tiene una retina para interpretar pesos visuales, jerarquías de lectura o la distancia física entre el pulgar del usuario y el botón principal de una pantalla móvil.

Para que un agente diseñe algo útil no basta con darle una hoja de estilos. Hay que darle ojos, límites geométricos estrictos y un entorno donde prototipar antes de tocar código de producción.

El bucle visual obligatorio: capturas en móvil y escritorio

El mayor salto de calidad en nuestro sistema de diseño ocurrió el día que prohibimos a los agentes dar por cerrado un cambio visual sin presentar pruebas gráficas.

En nuestro flujo, cada propuesta visual pasa por un script de automatización con Chromium headless (webshots.py) que genera capturas de pantalla en dos anchos de referencia obligatorios:

  • Escritorio a 1440 px: para comprobar la composición general, los márgenes laterales, las rejillas de columnas y el aire entre secciones.
  • Móvil a 390 px: el ancho estándar de referencia para dispositivos móviles, donde vive la inmensa mayoría del tráfico de búsqueda.
# Generar capturas de escritorio y móvil para validar la propuesta
webshots --sites personal --pages home,post

Al principio cometimos el error de utilizar capturas de página completa (fullshot). Parecía una idea cómoda para revisarlo todo de un vistazo, pero pronto descubrimos una trampa técnica: al estirar el viewport vertical hasta el final del documento para capturarlo todo en un único PNG de diez mil píxeles de alto, el motor de renderizado deforma cualquier propiedad CSS que utilice unidades relativas a la ventana (vh o dvh). Los bloques principales se volvían gigantescos y los efectos de desplazamiento quedaban completamente falseados.

Tuvimos que cambiar a capturas del viewport real: pantallas sucesivas a tamaño natural que reproducen exactamente lo que ve una persona real mientras se desplaza con el dedo o el ratón.

El bucle de trabajo del agente pasó a ser visual: modifica los tokens de diseño, lanza la captura, inspecciona la imagen resultante, corrige los desajustes espaciales y vuelve a capturar antes de dar por buena la tarea.

Diagrama del bucle visual de diseño: modificación de tokens, captura en viewport real, inspección visual y corrección iterativa El bucle visual obligatorio: el agente no da por cerrado un cambio hasta contrastar la captura real en móvil (390 px) y escritorio (1440 px).

Una gramática por tipo de producto, no una plantilla universal

Otro error frecuente al diseñar con agentes es buscar un «estilo corporativo» único que sirva para todo. En nuestro catálogo conviven productos con naturalezas completamente dispares:

  1. Webs de datos y expedientes: son páginas documentales donde la gente entra a consultar un dato específico (un precio, una fecha límite, un número de expediente). Aquí el diseño debe comportarse como un boletín oficial bien editado: tablas densas, tipografía monoespaciada para cifras y fechas, filetes finos de un píxel que separan filas como en un libro mayor de contabilidad y el dato principal visible en la primera pantalla del móvil, siempre antes de cualquier anuncio o elemento decorativo.
  2. Herramientas interactivas y calculadoras: requieren controles táctiles grandes, botones con radio suave, paneles agrupados y un contraste contundente en la tarjeta de resultados para que el cálculo se sienta como un objeto físico que responde al instante.
  3. Webs personales y portfolios: piden un lenguaje editorial más cercano al cartel, con titulares rotundos de escala display, espacio negativo generoso y fotografía cuidada.

Al codificar estas diferencias en guías de estilo independientes para cada categoría, el agente deja de improvisar. Cuando trabaja sobre un catálogo de datos sabe que no puede usar tarjetas flotantes con sombras difusas; cuando trabaja en una herramienta sabe que los controles numéricos necesitan botones táctiles de al menos 44 píxeles de altura.

Diseñar antes de programar: el caso de esta web personal

El impulso natural de cualquier programador cuando quiere cambiar una interfaz es abrir las plantillas de Blade o los componentes de Vue y empezar a retocar clases de Tailwind sobre la marcha. Con agentes, ese camino es una receta garantizada para el desastre: acabas con ramas sucias, lógica de presentación mezclada con datos y componentes rotos en producción.

Para el rediseño de mi propia web personal (la misma en la que estás leyendo este post) decidimos aplicar una separación radical: diseñar primero en un entorno de datos y trasladar el código solo cuando la composición estuviera completamente aprobada.

La web maneja una identidad compartida pero con dos entradas distintas que reflejan dos facetas de mi trabajo: por un lado, mi perfil sobrio y profesional como desarrollador full stack en Valladolid; por otro, mi faceta más experimental e independiente como creador de productos y proyectos de software. Ambas comparten estructura, artículos del blog y proyectos, pero varían en tipografía de titulares (Space Grotesk frente a Anton), paleta de color y tono del mensaje.

En lugar de programar esto a pelo en el motor web, utilizamos Atomix, una herramienta propia de diseño donde los componentes y las pantallas se definen como datos estructurados y se manipulan mediante una interfaz de línea de comandos.

En Atomix pudimos definir las pantallas como combinaciones de bloques declarativos, probar el contraste de los tokens de color sobre fondos oscuros (asegurando ratios superiores a 14:1 para no destrozar la legibilidad) y generar las capturas de contraste de cada pantalla antes de picar una sola línea en el repositorio principal. Una vez que la composición visual en escritorio y móvil estuvo validada, trasladar esa estructura al motor definitivo con sus colecciones de datos y sus animaciones nativas de scroll fue un trámite mecánico de apenas unas horas.

Cuando el fallo no es del agente, sino del encargo

Trabajar con agentes en diseño enseña una lección de humildad: el noventa por ciento de los disparates visuales que produce un modelo son culpa directa de la ambigüedad de quien redacta el encargo.

Durante las primeras pruebas del rediseño de la portada personal viví dos ejemplos claros:

1. El mosaico de fotos no solicitado

En uno de los primeros prompts escribí una frase descuidada: «añade una sección para mostrar fotos y proyectos recientes».

El agente hizo lo que cualquier modelo probabilístico hace ante una instrucción difusa: buscó el patrón más común en su entrenamiento para «fotos y proyectos». El resultado fue una cuadrícula apretada de imágenes cuadradas que parecía el perfil de una tienda de ropa en Instagram en 2015. Desentonaba por completo con el tono sobrio de la web y convertía la portada en un escaparate ruidoso.

Primer prototipo de portada generado por el agente con una cuadrícula genérica El primer prototipo generado por el agente tras una orden ambigua: un mosaico apretado y genérico que chocaba con la estética del sitio.

El fallo fue mío por pedir «mostrar fotos» en lugar de especificar: «una lista ordenada de creaciones con número de índice, tipografía mono, etiqueta de autoría y enlace textual sin miniaturas decorativas».

2. La foto carné pegada con celo

Para la imagen principal del hero, el encargo pedía «una fotografía de Pablo trabajando en un espacio de trabajo».

El agente generó la maquetación colocando un contenedor rectangular rígido con una foto encajada en formato 4:3, con bordes duros y esquinas rectas. En lugar de un cartel visual donde la figura humana respirara e interactuara con el titular grande a la izquierda, aquello parecía una fotografía de carné de identidad pegada con celo sobre el fondo oscuro.

En cuanto corregí el encargo con restricciones tangibles («figura con silueta recortada que rompa sutilmente el marco, luz natural tardía, titular display en el lado izquierdo y espacio negativo limpio para evitar colisiones en pantallas de 390 px»), la siguiente iteración clavó la composición a la primera.

Portada final de pablomsj.com diseñada con Atomix con tipografía display y contraste limpio La portada final de pablomsj.com tras acotar el encargo: composición editorial sobria, proporciones respiradas y jerarquía visual validada en Atomix.

Un agente de IA no tiene intuición artística ni sabe qué significa que una página tenga «personalidad». Si quieres diseñar con agentes, tu trabajo no es esperar que tengan buen gusto: es proporcionarles ojos mediante capturas reales, un marco de restricciones técnicas que no puedan saltarse y la disciplina de prototipar antes de tocar una sola línea de código.

Escrito por Pablo Martínez
← Todas las notas Ir a la portada ↗

Seguir leyendo

Más notas del cuaderno.

Ver todo el blog ↗
IA 2026-11-22

Cómo montamos nuestro sistema de agentes de IA (y qué falló)

Tres agentes especializados, un orquestador que vigila cada línea de código y modelos elegidos al céntimo. Así automatizamos tareas sin romper producción.

Leer nota ↗
Código 2026-11-22

Test-first cuando el código lo escribe un agente de IA

15 tests unitarios en verde no garantizan nada si la suite completa destapa una regresión antes de llegar a producción. Así aplicamos TDD estricto con agentes de código.

Leer nota ↗
Diseño 2026-11-22

Diseñar con agentes: por qué un agente ciego solo cambia colores

Sin ojos, un modelo de lenguaje solo añade padding y recolorea CSS. Así montamos un bucle visual con capturas reales y prototipado antes de tocar el código.

Leer nota ↗

Seguimos hablando

¿Tienes algo entre manos?

Escríbeme a pabloextreme27@gmail.com ↗
GitHub ↗ LinkedIn ↗
Pablo Martínez San José · Valladolid La otra entrada: Pablo Martínez ↗