Communitygithub.com

wuongg/wait_skills

Contrato de traspaso entre `landing-page-composition-architect` (planificador) y `cinematic-landing-page` (constructor). Define el esquema JSON del Blueprint, el mapeo familia-de-diseño → arquetipo-visual, las invariantes que el constructor debe preservar y los modos de fallo que ambas partes deben rechazar. Léelo siempre que se esté transfiriendo un Blueprint de Composición, o siempre que el constructor esté a punto de codificar una página sin un blueprint bloqueado.

¿Qué es wait_skills?

Este skill establece un contrato de integración formal entre dos habilidades de IA en un pipeline de construcción de landing pages. El planificador (`landing-page-composition-architect`) es responsable de la estructura y el orden de las secciones, emitiendo un Blueprint de Composición en JSON. El contrato define rigurosamente qué puede y qué no puede decidir el constructor: puede elegir arquetipos cinematográficos, animaciones, colores y tecnología, pero no puede reordenar, añadir o eliminar secciones. Incluye una tabla de mapeo completa de familias de diseño a arquetipos visuales, reglas de traducción (como peso visual → presupuesto de movimiento o emoción → estado de ánimo), una puerta de validación previa a la codificación y un protocolo de revisión estructurado. Está diseñado para plataformas como Claude Code, Cursor o Codex que ejecutan pipelines multi-skill, garantizando que ambas habilidades cooperen sin pisar sus límites.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wuongg/wait_skills/tree/HEAD/.cursor/skills/landing-page-skills-integration

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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: true es 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)AlternativaNotas
hero full-bleedA (Hero de viewport fijo)BVariante de lienzo enmarcado si el estado de ánimo = premium
hero divididoA (patrón: dividido)DCopia izquierda / medios derecha
declaración centradaSección D O A (centrada)—Bajo movimiento, alta legibilidad
carril de beneficiosFila de tarjetas D—3–4 elementos, sin tarjetas más pesadas que icono+título+línea
cuadrícula de tarjetasCuadrícula D—Máx. 6 mosaicos; desactivar movimiento hover en I3
pila escalonadaSección asimétrica DBFilas alternas de imagen/texto
bloque editorialEditorial DF (si es tipo de display)Formato largo; evitar UI de tarjetas
galería de ambienteB (scroll fijo) o E (cambiador)—Elegir por ritmo: lento-quemado→B, equilibrado→E
tira de logotiposFila tranquila D—Sin movimiento más allá de marquesina si se solicita
banda de métricasFila de números grandes D—Animación de conteo solo si el ritmo ≠ lento-quemado
panel de citasD o A escena única—Una cita destacada > carrusel
lista de acordeónAcordeón D—Prohibido para I3 (ver kill list)
banda CTACTA centrada DALa CTA primaria vive aquí
CTA sticky de piePie sticky D—Solo si ritmo = rápido
pie suavePie 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_note del planificador solicite explícitamente tratamiento cinematográfico para ellas.

Valores por defecto de arquetipo por intención (cuando el planificador no sugirió):

IntenciónArquetipo dominanteSegundo arquetipo (opcional)
I1 LanzamientoAE
I2 ConversiónA (dividido)— (mantener discreto)
I3 Editorial de MarcaF o BE
I4 PortafolioF o CB
I5 Historia de ProductoA + B (historia con scroll)—
I6 Campaña / TeaserA 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 visualPresupuesto de movimiento
muy altohasta 2 interacciones distintivas
alto1 interacción distintiva
mediosolo micro-interacciones (hover, pequeños fundidos)
bajosolo fundidos
muy bajoestático

T4. Rol CTA → tratamiento superficial.

Rol CTATratamiento
primarybotón completo + formulario/ancla, alto contraste
hardbotón, alto contraste, sin formulario
softenlace de texto con flecha
nonesin elemento CTA renderizado

T5. Emoción → mapeo de estado de ánimo (informativo).

primary_emotion (planificador)Estado de ánimo sugerido (constructor)
reverencia, calma, lujoCinematográfico Oscuro / Vidrio Suave
claridad, confianza, precisiónMínimo Claro / Neo-Tech
calidez, humano, historiaEditorial Cálido / Editorial Claro
energía, urgencia, hypeNeo-Tech / Cinematográfico Oscuro

T6. Ritmo → longitud de scroll.

RitmoScroll total (escritorio)
rápido≤ 2.5 viewports
equilibrado3–5 viewports
lento-quemado5–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 index son consecutivos, comenzando en 1.
  • No se añadió, eliminó, reordenó ni fusionó ninguna sección.
  • layout_family por 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_list está 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_required que 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 primary a soft.

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: true en 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados