¿Qué hace omd:landing — Landing abrumador de una página?
Una sola página que, con el scroll, se acumula y abruma al visitante. No se trata de colocar una cuadrícula de tarjetas, sino de que un concepto visual único nazca en el héroe, varíe en cada sección con una composición diferente y se cierre en el CTA. La base de marca se obtiene del proyecto DESIGN.md, las observaciones de composición del Códex Landing Craft (reglas ID LC-n), y la autoridad sobre el comportamiento del producto y las decisiones locales se lee del brief.
Ubicación del códex — repositorio: docs/design-excellence/landing-craft-codex.md · instalación: node_modules/oh-my-design-cli/docs/design-excellence/landing-craft-codex.md
(Si no existe ninguno, usa node -p "require('path').dirname(require.resolve('oh-my-design-cli/package.json'))" para encontrar la raíz del paquete y lee docs/design-excellence/ debajo de ella).
Si no se ha leído ninguno de los dos, no se empieza.
Entrada
- Texto completo de
DESIGN.md(si es Core v2, los anclajes de los §Scope·Foundations·Components·Content·Motion; si es legacy, todas las secciones). Solo se usan los tokens que están aquí — no inventes nada. Lo pendiente en.omd/preferences.mdsobrescribe a DESIGN.md. - Brief de al menos una línea: lo que el visitante debe sentir + la acción que debe realizar. Si no hay, se pide con una tanda de preguntas (máximo 5).
En modo desatendido (
unattended), toma la primera opción de cada pregunta y lo anota comoautoSelectedentrace.md. - Códex
landing-craft-codex.md— lee la tabla de reglas tal cual y, para esta ejecución, elige los IDs de regla que aplicar y anótalos en el storyboard.
Directorio de ejecución (se crea primero)
SLUG=$(printf '%s' "<brand-or-brief>" | tr '[:upper:] ' '[:lower:]-' | tr -cd 'a-z0-9-' | cut -c1-40)
RUN=.omd/runs/landing-$SLUG-$(date +%Y%m%d-%H%M)
mkdir -p "$RUN/assets" && printf '%s\n' "<brief original>"> "$RUN/task.md"
<run> = $RUN anterior. La salida se escribe únicamente dentro de este directorio (convención similar a omd-harness, y se añade una línea a .omd/runs/INDEX.md).
Salida (solo dentro del directorio de ejecución)
<run>/
concept.md Salida del director de arte: una frase de concepto, ambiente, uso de paleta, dirección de activos, lista de prohibiciones
storyboard.md Tabla de secciones: orden·propósito·altura de viewport·composición (LC-n)·plan de activos (prompts)·dirección de scroll·esqueleto de copy
assets/ Imágenes generadas (canal omd:media) + SVG inline original
render.html Archivo único (0 peticiones externas), responsivo 1440·390, revelados con IntersectionObserver, pinned ≤1, reduced-motion
system.md Descripción del sistema de diseño de esta página (incluyendo rutas de citas de tokens)
loop-trace.json Defectos por iteración de autoevaluación (render-integrity·landing-integrity·designer-review), autoSelected
trace.md Prompts de imagen originales, canal, costo, sha256, reintentos
Procedimiento
1. Concepto (agente omd-art-director)
De los hechos de marca de DESIGN.md (§1 narrativa·§Principles·§Voice) y del brief, extrae una frase de concepto.
El concepto no es una lista de adjetivos, sino "lo que la página muestra" (ej.: "Se ve un corte transversal de la tubería por donde fluye el pago").
El director de arte escribe en concept.md el concepto, el ambiente, la dirección de los activos y lo prohibido (antipatrones del códex + "reflejos de diseño generado" tipo Vercel).
Antes de construir, coloca en el mismo archivo una tabla de alcance de aplicación:
Decisión | Tipo de fundamento (hecho de marca/decisión de proyecto autorizada/observación del códex) | Origen·superficie objetivo | Aplicación aquí/razón de no resolver | Método de verificación.
Las observaciones planas de un control público son evidencia de ese control, no fundamento para prohibir todos los objetos 3D e iluminación del landing.
No eleves una dirección de escena local a hecho corporativo, ni crees tokens no confirmados. Si el origen y el objetivo son diferentes, déjalo como motivo de revisión.
Si hay activos ya incluidos en el prompt de invocación, descríbelos con palabras y pásalos (sujeto·composición·color dominante·ubicación del espacio vacío; el tamaño en píxeles con sips -g pixelWidth -g pixelHeight).
El director de arte no abre archivos de imagen con Read — hay casos documentados (dogfooding 2026-09-02) de que la sesión se cuelga tras el tool_result de imágenes grandes.
2. Storyboard
Entre 6 y 8 secciones. Cada sección debe incluir: (a) una frase de propósito, (b) altura de viewport (citando la regla de ritmo de sección del códex),
(c) patrón de composición — nombre del patrón de la tabla del códex y LC-n (bleed / inset / stacked / split / pinned-reveal …),
(d) plan de activos — tipo (foto/render/ilustración/UI abstracta)·estado/significado del producto que ilumina·proporción·posición·objetivo de ocupación del sujeto en pantalla·prompt de generación original (fija los hex de la paleta de marca en el prompt), (e) dirección de scroll (método de revelado, duración·easing con tokens de Motion de DESIGN.md), (f) esqueleto de copy.
Determina un punto de abrumamiento: la sección donde la página alcanza su clímax y la sección de espacio en blanco justo antes.
Presupuesto de densidad (escríbelo con números — solo con descripciones se obtiene una página vacía)
El número y la proporción por sí solos no demuestran una escena significativa. Conserva las cifras siguientes, pero planifica qué estado/significado del producto revela cada activo y el área de ocupación del sujeto real (no del contenedor), y verifícalo en el render. Quedan prohibidos: SVG repetitivos para llenar conteo, recortes/ampliaciones del mismo papel en blanco, imágenes satelitales sin significado.
Límite con
omd-restraint(Dial de densidad LC-59). El suelo inferior se aplica en su totalidad cuando el dial ≥ 6 (landing de showcase). Si el dial ≤ 5 (páginas de producto/catálogo/documentación), ganan los límites superiores deomd-restraint(piezas de primera pantalla ≤ 5, tamaño de fuente ≤ 4, CTA ≤ 2 …). En cualquier caso, se mantienen R1 (un foco)·R2 (piezas de primera pantalla)·R10 (un hecho solo una vez).
- Cantidad total de medios ≥ vh de la página × 1.0. Si la página tiene 12vh, debe haber 12 o más medios. Cuenta imágenes·videos·SVG inline significativos (no cuentes iconos individuales — solo los de ≥24px y que no sean decorativos, sino contenido).
- Medios en el pliegue (primera pantalla) ≥ 3. En la medición del códex, el pliegue de affinity tiene 8.
- Si usas scroll horizontal (LC-15), los elementos deben ser ≥ 8. Un scroll horizontal de 3-4 elementos no es una válvula de densidad, es una línea vacía.
- Activos con movimiento ≥ 1. Si
omd:setupha reservado un canal de video, usaimage_to_videopara convertir un activo de sección en un bucle de 6 segundos. Conprefers-reduced-motion, sustitúyelo por una imagen fija del mismo fotograma (autoplay·muted·loop·playsinline). Si no hay canal, anótalo entrace.md— no lo omitas en silencio. - Objetivo de tinta por sección ≥ 26% (límite inferior de la banda medida del códex 26–54%). Si no se alcanza, ajusta padding·tamaño de sujeto·expresión de estado necesaria.
- No unifiques el padding vertical con un mismo vh fijo. En la primera salida, todas las secciones tenían
18vh/24vhigual, sin ritmo (mediana = máximo = 378px). Reduce el padding en las secciones de baja densidad y da un margen grande solo antes y después del punto de abrumamiento.
3. Activos
Ejecuta los prompts del storyboard a través del canal detectado por omd:media (sin canal → deja el pack de prompts y la cola manual en
assets/QUEUE.md, y coloca placeholders SVG abstractos de la paleta de marca en su lugar — prohibido stock·emojis).
Prohibida la generación de fotos de rostros, prohibida la generación de logotipos (marcas de texto). Anota en trace.md el prompt·canal·costo de cada imagen.
Las generaciones fallidas se corrigen según la causa; los límites de canal y los placeholders se anotan en trace.md con el número real.
Si una sola escena original cumple el propósito, no añadas duplicados; renderiza la versión de revisión con esa composición. El incumplimiento del presupuesto de densidad y el FAIL del checker en bruto se dejan tal cual para su revisión en el límite de aplicación. La generación de la versión de revisión no es finalización, waiver ni PASS.
La proporción de la imagen se obtiene de la relación de aspecto real medida del slot donde irá (prohibidos valores por defecto — omd:media §1).
4. Construcción
render.html independiente. Las variables CSS usan los nombres de token de DESIGN.md tal cual (--color-…, --space-…).
Restablece los estilos por defecto del agente de usuario (márgenes de figure/blockquote — #78).
Las imágenes usan rutas relativas a assets/ o data URI.
El movimiento solo con transform·opacity, duración en 3 niveles como máximo, y con @media (prefers-reduced-motion: reduce) se detiene todo.
El ancho máximo del texto·la escala tipográfica·la altura de la sección deben estar dentro de los rangos numéricos del códex.
El texto sobre fotografías debe llevar una pantalla (scrim) (LC-36 "Lo abrumador debe ser legible"): héroe·etapas fijas (pinned)·secciones de inversión·nav·wordmark·
lead·CTA·anillos de foco deben superar WCAG 4.5:1 (normal)·3:1 (texto grande·UI) de contraste con los píxeles del fondo, y el medio es una pantalla alfa de color token (::before) y un halo de anillo de foco — el primer intento sin pantalla obtuvo BLOCK 6 con nav 1.05:1·wordmark 1.07:1.
Los tokens de la serie muted no se usan en ningún texto de cuerpo, incluyendo cejas y avisos legales (3.0:1).
Los revelados por scroll (opacity:0) deben ser visibles sin <noscript> y con @media (scripting: none) — una página vacía sin JS es un defecto.
Los requisitos de contraste·teclado y el objetivo de operabilidad táctil de esta skill no son geometría de marca observada. Si no se cumplen con las combinaciones de tokens existentes,
se propone la decisión local necesaria en la tabla de alcance de aplicación y se siguen los límites de autoridad. No se exime de un fallo de accesibilidad por "coherencia de marca".
5. Bucle de autoevaluación (máximo 3 veces — solo después de completar todas las comprobaciones de aplicación)
Si el repositorio tiene test-v2/tools/, usa la ruta de la izquierda; si no (paquete instalado), usa el comando omd entre paréntesis — son la misma herramienta.
① node test-v2/tools/render-integrity.mjs <run>/render.html (instalado: omd check render <run>/render.html) # determinista
② node test-v2/tools/landing-integrity.mjs <run>/render.html (instalado: omd check landing <run>/render.html) # reglas mecánicas del códex
②′ node test-v2/tools/text-contrast.mjs <run>/render.html (instalado: omd check contrast <run>/render.html) # texto sobre foto·gradiente·anillo de foco·no-JS (bloqueos de las dos primeras iteraciones)
③ Capturas de pantalla reales en ruta 1440·390: contrasta los límites de cada sección y los estados hero·peak·acción·resultado con el storyboard
③-b Anota el veredicto en bruto del suelo de densidad LI-24~26 (tinta de pantalla 12%·medios en pliegue 3·medios 1/vh) junto con la revisión del límite de aplicación
④ Spawn del subagente `omd-designer-review` (Agente, entrada: ruta absoluta de `<run>/render.html` + ruta de DESIGN.md del proyecto + límite de 20 llamadas a herramientas·15 min·esqueleto de review.md primero — solo cuenta los BLOCK)
③ no termina solo con la captura. El implementador mira la imagen directamente y verifica que el título·sujeto·control correspondiente·resultado estén dentro del fotograma.
No confundas el recorte central de scrollIntoView de una sección grande con el inicio de la sección. Agrupa viewport·posición de scroll·estado·hash de salida, y vuelve a tomar los fotogramas recortados.
El recorrido de scroll/cámara también se verifica con entrada real; no se afirma continuidad solo con seek de QA.
Deja el método de medición y el valor medido del área del sujeto por activo para contrastarlo con el objetivo de ocupación. Si es una estimación, márcalo como tal.
En las páginas con acciones, ejecuta realmente los elementos aplicables: vacío → error inline de entrada incorrecta → corrección → guardar → recargar, entrada/ejecución/retorno con teclado, objetivos táctiles renderizados ≥44×44 CSS px (objetivo de operabilidad de esta skill, excluyendo enlaces inline del cuerpo), alternativas no-JS·reduced-motion. Los errores se verifican por conexión de campo·focus·aria-invalid; los resultados de guardado se verifican por el contenido correspondiente y su persistencia. Los elementos no aplicables (como páginas sin función de guardado) se anotan con el fundamento de la tarea; no se sustituye la acción con un conmutador de estado de desarrollador.
Solo se corrigen los elementos con FAIL. En loop-trace.json se registran los defectos por herramienta·evidencia de comportamiento·confirmación de fotograma·④BLOCK·elementos no ejecutados.
Incluso si solo ①② pasan, no se omiten el contraste·comportamiento·pantalla real·revisión independiente. La verificación está completa solo cuando todas las comprobaciones de aplicación están hechas y no hay FAIL/BLOCK sin resolver.
Si el número de defectos no disminuye o el mismo ID de regla falla dos veces consecutivas, se detiene el bucle de corrección y se reporta como omd:issue.
Detenerse no es un éxito; se dejan las comprobaciones no ejecutadas. La revisión de conflicto de fuentes y el veredicto del checker en bruto se conservan por separado; no se crean waivers arbitrarios.
6. Demostración
Con omd:showcase <run>/render.html se crea un video de scroll (mp4/gif) (si no existe, test-v2/content-runs/build-scroll-compare.mjs captura fotogramas → ffmpeg).
En la parte inferior se debe ver un aviso no oficial. Distingue entre el video de entrada real y un montaje de fotogramas fijos.
El resultado de la verificación y la adopción visual por parte del usuario se reportan por separado; no se afirma aprobación estética ni finalización de adopción antes de que el usuario adopte el resultado.
Resumen de aplicación del códex (el texto completo está en el códex; aquí se indica en qué etapa se miran qué reglas)
| Etapa | Reglas | Valores clave (medidos, 5 sitios) |
|---|---|---|
| Concepto·pliegue | LC-1 | Los activos de primera pantalla cubren 89 |
| Ritmo | LC-8~12, LC-14 | Página de 10 |
| Composición·margen | LC-4~7 | 46 |
| Activos | LC-17~20, §6 tabla | 29 |
| Tipografía | LC-21~25 | display:body 3.0 |
| Color·inversión | LC-26~28 | Mantener un solo fondo (252 o 12); inversión solo en una sección (dispositivo de énfasis); tinte alrededor de 240,240,252 |
| Movimiento | LC-13, LC-29~32 | Una duración dominante (100/300/320/400ms, 33 |
| Autoevaluación | LI-1~23 · #86 | landing-integrity.mjs para veredicto mecánico (vh de página·proporción de secciones·cobertura de pliegue·proporción tipográfica·gutter·duración·easing·snap·atributos de video·hosts de stock·cuadrícula uniforme de tarjetas·h1) · text-contrast.mjs para contraste de texto sobre foto·anillo de foco·no-JS |
Reglas estrictas
- Prohibido inventar tokens·hechos de marca que no estén en DESIGN.md. Prohibido inventar reglas de "gusto" que no estén en el códex — las decisiones sin fundamento se marcan como "suposición" en
concept.md. - Si los valores del códex y los tokens de DESIGN.md entran en conflicto, DESIGN.md prevalece (ej.: códex LC-21 display:body 3.0×↑ vs Toss h1 36/body 14 = 2.57×). Primero verifica si el objetivo de aplicación es el mismo; si no se alcanza el rango, déjalo en la tabla de alcance de aplicación con el fundamento. Esto no es un PASS automático. Cuando un DESIGN.md no tiene tokens de Motion (que son mayoría), se usan los valores del códex LC-29/30 (300/400ms, etc.) marcándolos como "extensión local".
- Prohibido usar copias·capturas·logotipos originales de sitios reales. Prohibido inventar cifras estadísticas.
- Solo se crea una página. Las solicitudes de varias páginas se redirigen a
omd:autopilot(multipáginas). - Esta skill es un generador. El veredicto lo emiten las herramientas y
omd-designer-review— no escribas que "está bien" por ti mismo.