¿Qué hace clone-design?
Clona primero un sitio web, luego remézclalo en una landing page específica del proyecto o destílalo en DESIGN.md.
Postura predeterminada: preserva el diseño renderizado del sitio fuente sin desviación creativa hasta que se haya verificado el clon 1:1. Solo después puedes reemplazar el texto, las imágenes y el contenido específico de la marca para el proyecto actual.
Cuándo Usarlo
Usa esta habilidad cuando el usuario solicite:
- clonar un sitio web o landing page desde una URL
- replicar una landing page 1:1 antes de adaptarla
- convertir la landing page de otro sitio web en una landing page para el proyecto local actual
- reemplazar el texto del sitio web clonado con texto de la carpeta del proyecto actual
- reemplazar las imágenes del clon con activos rasterizados generados y relevantes para el proyecto
- convertir un sitio web en
DESIGN.md - extraer el sistema de diseño de un sitio
- analizar el lenguaje visual de una página
- analizar una interfaz de usuario de producto o espacio de trabajo con sesión iniciada
- sintetizar guías de diseño a partir de múltiples páginas o estados
- transformar un clon de UI en una guía de diseño reutilizable
- convertir una URL en vivo directamente en un paquete de diseño
Elige el Modo
Modo A: Remezcla de Landing Page
Úsalo cuando el usuario quiera clonar otra landing page y adaptarla al proyecto actual.
Pipeline:
URL -> clon 1:1 -> página local verificada -> mapa de texto del proyecto -> activos imagegen -> landing page final
Lee y sigue:
Modo B: Extracción del Sistema de Diseño
Úsalo cuando el usuario quiera DESIGN.md, análisis de lenguaje visual o guías de diseño.
Pipeline:
URL o clone.html -> captura(s) -> design-md/<slug>/
Lee y sigue:
- references/ui_clone_workflow.md
- references/multi_page_session_workflow.md cuando el inicio de sesión, múltiples páginas o múltiples estados sean importantes
Reglas de Captura de Fuente
Si el usuario proporciona una URL:
- no le pidas que instale o ejecute
frontend-ui-clonepor separado - crea primero una instantánea HTML autocontenida
- reutiliza el mismo flujo de clonación y escalera de fidelidad que
frontend-ui-clone - guarda el material fuente en
captures/<slug>/ - incluye
clone.htmlpara cada página o estado capturado - añade capturas de pantalla y un volcado de tokens cuando sea útil
- verifica el clon en un navegador antes de remezclar o destilar
Si el usuario proporciona un archivo .html local:
- úsalo directamente
- acepta un archivo, varios archivos o un directorio de captura que contenga varios archivos
clone.html
Evita remezclar o escribir DESIGN.md desde una obtención HTTP sin formato cuando el sitio dependa de renderizado del lado del cliente.
Rutas Predeterminadas
Si el usuario no especifica rutas:
Archivos de captura:
- carpeta de captura de una sola página:
captures/<slug>/ - carpeta de captura de varias páginas:
captures/<slug>/<page-slug>/ - archivos por página:
clone.html,homepage.png,live.json - manifiesto de captura opcional a nivel de sitio:
captures/<slug>/capture-plan.json
Salida de remezcla de landing:
- carpeta de salida:
landing-pages/<slug>/ - página final:
index.html - clon fuente verificado:
source-clone.html - inventario extraído:
content-inventory.json - activos generados:
assets/generated/ - archivos de planificación y QA:
copy-map.jsonimage-plan.jsonqa/original-desktop.pngqa/clone-desktop.pngqa/final-desktop.png- capturas de pantalla móvil opcionales
Salida de extracción de diseño:
- carpeta de salida:
design-md/<slug>/ - archivos de salida:
DESIGN.mdREADME.mdpreview.htmlpreview-dark.html
- archivo de evidencia opcional:
evidence.json
Estándar de Clon 1:1
Cuando la entrada sea una URL:
- prefiere las herramientas integradas de navegador/Playwright cuando estén disponibles
- usa la misma ventana gráfica predeterminada y estrategia de desplazamiento que
frontend-ui-clone - preserva el DOM renderizado, CSS, fuentes y URLs de activos resueltas
- preserva la estructura DOM original, nombres de clase, orden de secciones, espaciado, radios, sombras, tipografía, degradados y comportamiento responsivo
- no rediseñes, simplifiques, cambies la marca ni reestructures el diseño antes de que exista el clon verificado
- si la página necesita autenticación, deja que el usuario complete el inicio de sesión en el navegador y mantén vivo el mismo contexto del navegador
- después del inicio de sesión, captura cada página o estado de UI solicitado por separado en la misma sesión
- si la primera captura tiene un héroe en blanco o un problema de superposición evidente, aplica la misma mentalidad de escalada que
frontend-ui-clone:- Nivel 1: clon DOM + CSS
- Nivel 1a: clon híbrido con correcciones dirigidas
- Nivel 1b: horneado de estilo dirigido
- haz QA de captura de pantalla de escritorio aproximadamente a
1440 x 900 - haz QA de captura de pantalla móvil aproximadamente a
390pxde ancho cuando la página sea responsiva - corrige las discrepancias visibles antes de continuar
No rastrees automáticamente una aplicación autenticada completa a menos que el usuario lo solicite claramente. Prefiere un conjunto seleccionado de páginas o estados clave.
Reglas de Remezcla
Al adaptar una landing page clonada al proyecto actual:
- Inspecciona la carpeta del proyecto actual para obtener contexto del producto antes de escribir texto. Prefiere
README,PRODUCT.md,package.json, landing pages existentes, documentación, cadenas fuente, capturas de pantalla y activos de marca. - Ejecuta
scripts/extract_landing_inventory.pyen el clon verificado para sembrar la planificación de texto e imágenes. - Construye un mapa de texto a partir del texto visible original hasta el texto de reemplazo. Preserva la misma jerarquía de contenido y longitud de texto aproximada para que el diseño permanezca intacto.
- Reemplaza nombres de marca, titulares, subtítulos, CTA, etiquetas de funciones, testimonios, texto de preguntas frecuentes y texto de pie de página con lenguaje relevante para el proyecto.
- Mantén el diseño fuente, la sincronización de animaciones, el orden de las secciones y la estructura de los componentes a menos que el usuario solicite explícitamente cambios estructurales.
- Inventaria imágenes rasterizadas, medios de héroe, miniaturas, avatares, maquetas de productos y fotos decorativas.
- Usa el skill
imagegenpara reemplazos rasterizados relevantes para el proyecto cuando las imágenes fuente no deban permanecer. Guarda los activos generados enlanding-pages/<slug>/assets/generated/y actualiza las referencias HTML/CSS. - Prefiere preservar las dimensiones originales de la imagen, las relaciones de aspecto, el comportamiento de recorte, el object-fit, el radio de borde y el peso visual.
- No reemplaces íconos SVG simples, marcas vectoriales, degradados CSS o decoraciones geométricas con mapas de bits generados a menos que el usuario lo solicite.
- Elimina o reemplaza logotipos, nombres, capturas de pantalla y marcas comerciales de terceros a menos que el usuario quiera explícitamente que se conserven para un clon de referencia privado.
- Verifica la página adaptada final en el navegador después del reemplazo de texto e imágenes. Corrige desbordamiento de texto, imágenes rotas, ajuste móvil y cambios de diseño.
Generación de DESIGN.md
Para el modo de extracción de diseño, usa el script incluido:
python3 scripts/generate_design_md.py "$CLONE_HTML" \
--name "$SITE_NAME" \
--url "$SITE_URL" \
--out-dir "design-md/$SLUG" \
--json-out "design-md/$SLUG/evidence.json"
Para múltiples páginas capturadas:
python3 scripts/generate_design_md.py \
"captures/$SLUG/home/clone.html" \
"captures/$SLUG/workspace/clone.html" \
"captures/$SLUG/settings-modal-open/clone.html" \
--name "$SITE_NAME" \
--url "$SITE_URL" \
--out-dir "design-md/$SLUG" \
--json-out "design-md/$SLUG/evidence.json"
O escanea una raíz de captura directamente:
python3 scripts/generate_design_md.py \
--capture-dir "captures/$SLUG" \
--name "$SITE_NAME" \
--url "$SITE_URL" \
--out-dir "design-md/$SLUG" \
--json-out "design-md/$SLUG/evidence.json"
Omite las banderas opcionales cuando no tengas esos valores.
Después de la generación:
- lee el
DESIGN.mdproducido - ajusta la redacción vaga
- mantén las afirmaciones fundamentadas en la fuente
- marca las declaraciones inciertas como inferidas
Nunca inventes:
- colores no presentes en el clon
- familias de fuentes no observadas en CSS
- puntos de interrupción que no fueron extraídos
- interacciones que requieran estado de ejecución que no capturaste
- afirmaciones de cobertura para páginas o flujos que no incluiste realmente en la sesión
Secciones requeridas de DESIGN.md:
- Tema Visual y Atmósfera
- Paleta de Colores y Roles
- Reglas Tipográficas
- Estilos de Componentes
- Principios de Diseño
- Profundidad y Elevación
- Qué Hacer y Qué No Hacer
- Comportamiento Responsivo
- Guía de Prompt para Agente
Respuesta Final
Para el modo de remezcla de landing, informa:
- URL fuente
- carpeta de captura y ruta del clon verificado
- carpeta de la landing page final y
index.html - qué archivos del proyecto informaron el texto de reemplazo
- cuántos reemplazos de texto se realizaron
- cuántas imágenes generadas se crearon y dónde se guardaron
- verificación de navegador de escritorio/móvil realizada
- cualquier limitación, como interacciones no capturadas o activos que no pudieron reemplazarse limpiamente
Para el modo de extracción de diseño, informa:
- dónde se guardó la carpeta de captura, si clonaste desde una URL en vivo
- si contiene un
clone.htmlo varias carpetas de página con su propioclone.html, y opcionalmentehomepage.png/live.json - dónde se guardó la carpeta de salida
- si contiene
DESIGN.md,README.md,preview.htmlypreview-dark.html - dónde se guardó
evidence.json, si se generó - si el resultado provino de una fuente de clon fuerte o de un recurso alternativo más débil
- cuántas páginas o estados se incluyeron en la síntesis final
- cualquier limitación notable