Si construyes frontend con ayuda de editores de código con IA, explicar cambios de diseño rutinarios se convierte en un tormento. Arrancas el servidor local, ves un margen descuadrado en un botón y vas al chat del asistente. Y ahí empieza la rutina: hay que rastrear en DevTools la ruta exacta del archivo como src/components/Dashboard/MetricsCard.tsx, copiar las clases de Tailwind y redactar un prompt: «Encuentra el tercer botón azul de la segunda columna y aumenta el margen inferior».
El modelo mira el proyecto a través de la mirilla de archivos de texto. Al no ver el renderizado, confunde componentes, se mete a reescribir globals.css en lugar del bloque local o rompe la cuadrícula vecina. Redactar el prompt y revertir diffs erróneos consume muchísimo tiempo.
El equipo de Cursor ha decidido cerrar esa brecha. Una actualización del entorno trajo la herramienta Annotate, integrada en el modo de desarrollo visual Design Mode. Es un puente interactivo que conecta la ventana gráfica de vista previa directamente con el motor de contexto de Composer. Veamos cómo funciona esta mecánica bajo el capó, qué escenarios abre y dónde están los escollos.
Modo Design Mode: puente interactivo entre el navegador y Composer
La activación del modo se realiza con el atajo Cmd + Shift + D en macOS o Ctrl + Shift + D en Windows y Linux. La ventana de vista previa integrada se convierte en un lienzo interactivo: Cursor inyecta un overlay ligero que rastrea el cursor y las coordenadas de los elementos sin alterar la ejecución del JavaScript del cliente.
El desarrollador deja de ir y volver entre Chrome DevTools y el editor. Interactúas con la interfaz viva directamente dentro del IDE. Cada gesto visual se traduce no en coordenadas de píxeles, sino en metadatos estructurados.
Cuando haces clic en cualquier bloque de la página, el sistema empareja el nodo del árbol DOM con el árbol sintáctico del proyecto (AST). Al contexto del agente Composer se transfieren automáticamente:
- La ruta exacta al archivo del componente en disco;
- El rango de líneas en el código fuente donde está declarado el elemento JSX o HTML objetivo;
- Los estilos computados actuales (computed styles) y clases de bibliotecas de utilidades;
- Los parámetros geométricos del contenedor (bounding box);
- La pila de componentes padre hasta el layout raíz.
El agente recibe un anclaje espacial cristalino: ya no tiene que adivinar por texto a qué botón concreto te refieres.
Seis mecánicas de anotación: del clic a los cambios por lotes
La herramienta Annotate cubre todo el abanico de tareas cotidianas de maquetación mediante seis patrones básicos de interacción:
- Selección puntual (Point & Click). Haces clic en una tarjeta o botón y en el campo de entrada que aparece escribes: «Pon el mismo redondeado que en la tarjeta de perfil y añade sombra al pasar el cursor». El agente localiza al instante el componente y genera un parche preciso.
- Áreas rectangulares y marcado (Box & Draw Markup). Si el problema afecta a la composición de bloques, puedes rodear con un marco la zona de pantalla necesaria o dibujar una flecha: «Alinea estas tres columnas por la línea base y aumenta el espaciado a 24px».
- Edición directa de texto (In-Place Text Editing). La forma más rápida de corregir microtextos y titulares. Haces doble clic sobre el texto en la vista previa y reescribes la frase. El agente detecta por sí mismo si el texto está incrustado en JSX, extraído en una constante o vinculado a una clave i18n, y actualiza el archivo correcto.
- Inspector de estilos visuales (Style & CSS Inspector). Si no te apetece buscar palabras para un color o un radio, el inspector permite mover deslizadores de márgenes o elegir un color de la paleta. Los parámetros se compilan en el prompt como clases exactas o valores numéricos.
- Notas de voz (Voice Annotations). Puedes hacer clic en un elemento, mantener pulsado el micrófono y dictar tus indicaciones por voz. Un modelo de voz convierte el audio en texto y lo vincula con la instantánea del DOM.
- Envío por lotes (Batch Edits). El desarrollador puede colocar 5–10 anotaciones por toda la página y pulsar el botón de envío. Composer analiza todos los marcadores a la vez, traza un plan conjunto de refactorización y aplica un diff coherente en una sola pasada.
Anatomía arquitectónica: cómo se vinculan el DOM y el código fuente
La localización instantánea del código se apoya en una mecánica de ingeniería estricta. Para que un clic en el navegador se convierta en un número de línea en un archivo .tsx o .vue, intervienen tres niveles:
Primero, el sistema se apoya en los mapas de correspondencia de código: Source Maps. Los empaquetadores (Vite, Next.js / Turbopack) en modo dev generan mapas que enlazan el bundle con los fuentes. El overlay intercepta el clic y decodifica la ruta del archivo mediante sourcemaps.
Después entra la introspección de árboles de componentes. En React, el inspector lee los metadatos internos del árbol de fibras (React Fiber Nodes), extrayendo los nombres de los componentes de usuario y las propiedades de entrada (props). Esto evita el problema habitual de que el modelo intente estilizar una etiqueta interna de una biblioteca UI externa como Radix o Shadcn en lugar del componente envoltorio.
Por último, los datos se filtran: al contexto de Composer se envía un manifiesto JSON compacto con la jerarquía de etiquetas, clases, comentarios y recorte gráfico. Sobre lo importante que es aislar las herramientas agénticas del ruido informativo sobrante ya hablamos en el artículo sobre la arquitectura de plugins oficiales de Cursor. Annotate encarna esa misma filosofía: pasar al modelo solo el corte mínimo imprescindible de datos.
Velocidad de iteración y nuevos roles en el equipo
El ciclo «detecté un defecto — hice clic — el agente lo corrigió» se acorta de 3 a 5 veces, llevando unos 15 segundos en lugar de varios minutos de búsqueda manual. Pero lo más importante es que se difumina la frontera entre maquetación y diseño. Un diseñador o product manager puede abrir ahora la vista previa local, marcar observaciones directamente sobre los elementos vivos y aplicar los cambios. Escenarios así complementan a la perfección nuestra guía de Cursor para automatizar el desarrollo.
Escollos y límites de aplicabilidad
Pese a su comodidad, Annotate tiene limitaciones técnicas importantes:
- Dependencia de la compilación dev: en un bundle de producción minificado sin mapas sourcemaps, el inspector solo ve etiquetas compiladas con hashes aleatorios, privando al modelo del anclaje exacto.
- Consumo de tokens: el envío por lotes de 10–15 anotaciones con capturas de pantalla infla notablemente el prompt de entrada, por lo que resulta más eficiente agrupar tareas en tandas de 3–5 elementos.
- Estados dinámicos: los elementos activos solo al pasar el cursor (hover) o durante animaciones modales requieren fijar previamente el estado antes de hacer clic.
- Limitación al stack web: la herramienta está enfocada en estándares DOM/CSS y no soporta Canvas, WebGL ni frameworks gráficos nativos de bajo nivel.
Annotate confirma con claridad la tendencia general: el entorno de desarrollo se transforma en una interfaz espacial donde el modelo de lenguaje ve la aplicación con los mismos ojos que el humano.


