Habilidades de Landing Page — Contrato de Integración v1
Dos habilidades, un pipeline:
Brief del usuario
│
▼
[ landing-page-composition-architect ] ← decide QUÉ y ORDEN
│ emite: Blueprint de Composición (bloqueado)
▼
[ INTEGRATION.md ← este archivo ] ← traduce blueprint → especificación de build
│ emite: Especificación de Build (arquetipo + movimiento + stack)
▼
[ cinematic-landing-page ] ← decide CÓMO SE VE Y SE MUEVE, escribe código
│
▼
Página publicada
Regla de oro. El planificador posee la estructura. El constructor posee la superficie. Ninguno puede cruzar la línea. Este archivo es cómo se mantienen honestos.
1. EL ARTEFACTO DE TRASPASO — Blueprint de Composición (JSON)
El artefacto final del planificador DEBE ser renderizable como este JSON, incluso si fue presentado al usuario como una tabla. El constructor lee este JSON literalmente.
{
"blueprint_version": "1.0",
"page": {
"intent": "I1 | I2 | I3 | I4 | I5 | I6",
"intent_name": "Lanzamiento | Conversión | Marca | Portafolio | Historia de Producto | Campaña",
"awareness": "frío | cálido | caliente",
"traffic": "anuncios | orgánico | social | referencia | directo",
"narrative_spine": "Enganche -> Valor -> Prueba -> CTA",
"pace": "rápido | equilibrado | lento-quemado",
"density": "mínimo | equilibrado | rico",
"primary_emotion": "cadena (una palabra)",
"total_sections": 5
},
"sections": [
{
"index": 1,
"slot": "S1",
"name": "Hero",
"jtbd": "captar atención + establecer tono",
"why_here": "primera impresión",
"layout_family": "hero full-bleed",
"content_required": ["titular", "subtítulo", "hero_media"],
"visual_weight": "muy alto",
"cta_role": "suave"
}
],
"rhythm_rules": [
"No pueden estar adyacentes dos secciones con peso 'muy alto'.",
"Después de cualquier hero full-bleed o galería de ambiente, la siguiente debe ser una declaración centrada o un bloque editorial.",
"La CTA primaria aparece exactamente una vez."
],
"kill_list": [
"No FAQ",
"No cuadrícula de 6 tarjetas",
"No banda de métricas"
],
"handoff_note": "Un párrafo: emoción a preservar, qué slots quieren tratamiento cinematográfico, cuáles se mantienen discretos.",
"locked": true
}
Invariantes.
sections.length∈ [4, 9]; 5–8 para intenciones estándar.- Cada
slot∈{S1..S16}, único por página. layout_family∈ lista cerrada (ver §3).locked: truees una promesa: el constructor NO DEBE reordenar, añadir, eliminar o renombrar secciones.
2. QUÉ PUEDE DECIDIR EL CONSTRUCTOR (y qué NO)
El constructor PUEDE decidir
- Arquetipo cinematográfico (A/B/C/D/E/F de
cinematic-landing-page). - Firmas de movimiento, curvas de easing, comportamiento de scroll.
- Estado de ánimo de color, tipografía, escala de espaciado.
- Tratamiento de medios (grano, desenfoque, encuadre, recortes).
- Stack tecnológico (V1 vanilla vs V2 React+Vite+Tailwind).
- Pulido de microcopia (siempre que preserve la intención).
El constructor NO PUEDE decidir
- Número de secciones.
- Orden de las secciones.
- Qué slot se asigna a qué posición.
- Si una sección existe o no.
- Renombrar el propósito de un slot (el nombre visible puede cambiar; la JTBD no).
- Añadir secciones que no estén en el blueprint (sin banner CTA sorpresa, sin bloque de boletín sorpresa).
- Eliminar la CTA primaria o duplicarla.
Si el constructor cree que el blueprint está mal, debe detenerse y solicitar un replan, no mutar en silencio.
3. MAPEO FAMILIA DE DISEÑO → ARQUETIPO VISUAL
El planificador habla en familias de diseño. El constructor habla en arquetipos cinematográficos (A–F). Esta es la tabla de traducción.
| Familia de diseño (planificador) | Arquetipo principal (constructor) | Alternativa | Notas |
|---|---|---|---|
hero full-bleed | A (Hero de viewport fijo) | B | Variante de lienzo enmarcado si el estado de ánimo = premium |
hero dividido | A (patrón: dividido) | D | Copia izquierda / medios derecha |
declaración centrada | Sección D O A (centrada) | — | Bajo movimiento, alta legibilidad |
carril de beneficios | Fila de tarjetas D | — | 3–4 elementos, sin tarjetas más pesadas que icono+título+línea |
cuadrícula de tarjetas | Cuadrícula D | — | Máx. 6 mosaicos; desactivar movimiento hover en I3 |
pila escalonada | Sección asimétrica D | B | Filas alternas de imagen/texto |
bloque editorial | Editorial D | F (si es tipo de display) | Formato largo; evitar UI de tarjetas |
galería de ambiente | B (scroll fijo) o E (cambiador) | — | Elegir por ritmo: lento-quemado→B, equilibrado→E |
tira de logotipos | Fila tranquila D | — | Sin movimiento más allá de marquesina si se solicita |
banda de métricas | Fila de números grandes D | — | Animación de conteo solo si el ritmo ≠ lento-quemado |
panel de citas | D o A escena única | — | Una cita destacada > carrusel |
lista de acordeón | Acordeón D | — | Prohibido para I3 (ver kill list) |
banda CTA | CTA centrada D | A | La CTA primaria vive aquí |
CTA sticky de pie | Pie sticky D | — | Solo si ritmo = rápido |
pie suave | Pie mínimo D | — | Salida tranquila al final de la página |
Límite de arquetipos por página.
- Máx. 2 arquetipos distintivos por página (heredado de la regla de
cinematic-landing-page). - La sección hero elige el arquetipo dominante. Otras secciones usan por defecto la ejecución estilo D a menos que el
handoff_notedel planificador solicite explícitamente tratamiento cinematográfico para ellas.
Valores por defecto de arquetipo por intención (cuando el planificador no sugirió):
| Intención | Arquetipo dominante | Segundo arquetipo (opcional) |
|---|---|---|
| I1 Lanzamiento | A | E |
| I2 Conversión | A (dividido) | — (mantener discreto) |
| I3 Editorial de Marca | F o B | E |
| I4 Portafolio | F o C | B |
| I5 Historia de Producto | A + B (historia con scroll) | — |
| I6 Campaña / Teaser | A o F | — |
4. ESPECIFICACIÓN DE BUILD — el artefacto que el constructor emite antes de codificar
Antes de escribir una sola línea de código, el constructor DEBE producir una Especificación de Build derivada del Blueprint. Este es el segundo contrato en el pipeline.
{
"build_spec_version": "1.0",
"blueprint_ref": "locked",
"stack": "V1 vanilla | V2 react-vite-tailwind",
"dominant_archetype": "A | B | C | D | E | F",
"second_archetype": "A | B | C | D | E | F | null",
"mood": "Cinematográfico Oscuro | Editorial Cálido | Neo-Tech | Mínimo Claro | Editorial Claro | Vidrio Suave",
"sections": [
{
"index": 1,
"slot": "S1",
"layout_family": "hero full-bleed",
"archetype": "A",
"pattern": "lienzo-enmarcado",
"motion": ["hero_fade_in_800ms", "subcopy_delay_200ms"],
"media": {"type": "imagen | video | ninguno", "asset_ref": "…"},
"notes": "por qué se eligió este arquetipo para este slot"
}
],
"acceptance_criteria": [
"El primer viewport = solo composición S1.",
"CTA primaria en S15 exactamente una vez.",
"No hay secciones adyacentes con peso 'muy alto'.",
"Cantidad de movimientos en página <= 2 distintivos."
]
}
El constructor valida la Especificación de Build contra el Blueprint (ver §6) ANTES de codificar. Fallo cerrado.
5. REGLAS DE TRADUCCIÓN (planificador → constructor)
Aplicadas en orden.
T1. El orden de las secciones es ley. sections[i].index en el blueprint = posición en la
página. El constructor nunca reordena.
T2. Slot → elegibilidad de arquetipo. Usar la tabla §3. Si una familia de diseño aparece cuyo arquetipo principal entra en conflicto con el arquetipo dominante ya elegido para el hero, usar la alternativa.
T3. Peso → presupuesto de movimiento.
| Peso visual | Presupuesto de movimiento |
|---|---|
| muy alto | hasta 2 interacciones distintivas |
| alto | 1 interacción distintiva |
| medio | solo micro-interacciones (hover, pequeños fundidos) |
| bajo | solo fundidos |
| muy bajo | estático |
T4. Rol CTA → tratamiento superficial.
| Rol CTA | Tratamiento |
|---|---|
| primary | botón completo + formulario/ancla, alto contraste |
| hard | botón, alto contraste, sin formulario |
| soft | enlace de texto con flecha |
| none | sin elemento CTA renderizado |
T5. Emoción → mapeo de estado de ánimo (informativo).
| primary_emotion (planificador) | Estado de ánimo sugerido (constructor) |
|---|---|
| reverencia, calma, lujo | Cinematográfico Oscuro / Vidrio Suave |
| claridad, confianza, precisión | Mínimo Claro / Neo-Tech |
| calidez, humano, historia | Editorial Cálido / Editorial Claro |
| energía, urgencia, hype | Neo-Tech / Cinematográfico Oscuro |
T6. Ritmo → longitud de scroll.
| Ritmo | Scroll total (escritorio) |
|---|---|
| rápido | ≤ 2.5 viewports |
| equilibrado | 3–5 viewports |
| lento-quemado | 5–8 viewports |
T7. Densidad → elección de componentes.
- mínimo → preferir secciones solo de texto, amplio espacio en blanco.
- equilibrado → mezcla de texto + medios.
- rico → bloque editorial pesado; seguir respetando la kill list.
T8. La kill list es absoluta. Cualquier elemento en kill_list está prohibido en la
Especificación de Build y en el código, incluso si "se vería genial".
6. PUERTA DE VALIDACIÓN (ejecutar antes de escribir cualquier código)
El constructor ejecuta esta lista de verificación contra la Especificación de Build. Todas deben pasar.
- Cada sección del blueprint tiene exactamente una fila en
build_spec.sections. - Los valores de
indexson consecutivos, comenzando en 1. - No se añadió, eliminó, reordenó ni fusionó ninguna sección.
-
layout_familypor fila coincide con el blueprint. - El arquetipo dominante lo usa el hero (
index: 1). - El total de arquetipos distintivos en la página ≤ 2.
- La suma de "interacciones distintivas" entre las secciones ≤ 2.
- El número de CTA primarias = 1 (o 0 si la intención = I3 con cierre de pie suave).
- Ningún elemento de
kill_listestá presente en el spec. - Se respeta la puerta de conciencia: frío ⇒ S2 existe justo después de S1.
- No hay adyacencia prohibida (S6+S9, S11+S13, etc.).
Fallar → devolver al planificador con un revision_request (ver §7). NO codificar
en torno a una puerta fallida.
7. PROTOCOLO DE REVISIÓN
Si el constructor debe rechazar, emite una solicitud estructurada, no texto libre:
{
"revision_request": {
"reason": "conflicto_de_diseño | activo_faltante | presupuesto_de_movimiento_excedido | kill_list_imposible | violación_de_adyacencia",
"affected_sections": [3, 4],
"explanation": "un párrafo corto",
"suggested_fix": "intercambiar orden de S6 y S9 | eliminar S13 | degradar peso de S1 a alto"
}
}
El planificador responde con un nuevo blueprint bloqueado, no una nota de parche.
Los blueprints se reemiten completos, versionados mediante un aumento de blueprint_version.
8. MODOS DE FALLO QUE AMBAS PARTES DEBEN RECHAZAR
El planificador debe rechazar:
- Emitir un blueprint desbloqueado.
- Emitir menos de 4 o más de 9 secciones.
- Incluir un slot con
content_requiredque el usuario no pueda proporcionar. - Reutilizar un ID de slot.
- Omitir S1 o (normalmente) S15.
- Elegir una familia de diseño fuera de la lista cerrada en §3.
El constructor debe rechazar:
- Codificar sin un blueprint bloqueado.
- Codificar sin una Especificación de Build que haya pasado §6.
- Añadir una sección "porque la página parecía vacía".
- Eliminar una sección "porque parecía redundante".
- Usar más de 2 arquetipos distintivos.
- Ignorar la kill list.
- Degradar silenciosamente una CTA
primaryasoft.
Si un usuario solicita directamente una violación, responder una vez con la compensación,
luego solo cumplir si lo confirma explícitamente — y registrarlo en la Especificación
de Build como "user_override": true en la fila afectada.
9. EJEMPLO MÍNIMO DE EXTREMO A EXTREMO
Blueprint (salida del planificador, condensada)
- Intención: I2 Conversión, frío, anuncios, ritmo equilibrado, densidad equilibrada.
- Secciones:
S1 → S2 → S4 → S5 → S6 → S12 → S13 → S15 - Kill list: no S8, no S9, no S14, no S11.
- Emoción primaria: claridad.
Especificación de Build (salida del constructor, condensada)
- Stack: V2 (React + Vite + Tailwind + framer-motion).
- Arquetipo dominante: A (hero dividido). Segundo arquetipo: ninguno.
- Estado de ánimo: Mínimo Claro.
- Presupuesto de movimiento usado: 2 / 2 (revelación dividida del hero + conteo de métricas).
- S1 = A hero dividido. S2 = D declaración centrada. S4 = D bloque editorial. S5 = D pila escalonada. S6 = D cuadrícula de tarjetas (4 mosaicos). S12 = D banda de métricas. S13 = D panel de citas (cita única). S15 = D banda CTA con formulario.
- Aceptación: CTA primaria una vez (S15); sin adyacencia S6/S9; scroll total ≈ 4 viewports.
Validación
Todas las comprobaciones de §6 pasan. El constructor procede a codificar.
10. QUÉ DECIR AL USUARIO (fragmentos de guion)
Al realizar el traspaso desde el planificador:
"Blueprint locked. ¿Cambiar a skill de build (
cinematic-landing-page)? Ese skill elegirá el arquetipo visual + movimiento + código, sin cambiar el orden de las secciones."
Cuando el constructor rechaza un blueprint:
"Este blueprint tiene un conflicto en la sección {n} — {motivo}. Lo devolvemos al planificador para que emita una nueva versión, en lugar de modificarlo nosotros."
Cuando el usuario insiste en una anulación:
"Si insiste en hacerlo así, marcaré
user_override: trueen esa sección. La página aún se puede construir, pero la regla de ritmo se rompe — ¿confirma?"
Fin del contrato de integración.