Página de aterrizaje
Este es el punto de entrada para el trabajo en una página de aterrizaje. Define el brief en landing/brief.md, luego ejecuta las seis habilidades de este plugin en un orden fijo, de modo que la página nunca se maqueta antes de tener el texto ni se codifica antes de tener la dirección.
Empieza así. Si landing/brief.md existe, léelo y pregunta solo por lo que le falta. De lo contrario, pregunta primero (ver "Cuando falta información"), luego escríbelo. Lee también el proyecto (README, package.json, un sitio existente) y no preguntes por lo que ya responde. Nada de texto, diseño ni código antes de que el brief esté escrito.
El brief
Una línea por campo, en las palabras del usuario:
- Tipo: SaaS, producto, servicio o estudio, lista de espera, evento, o una combinación.
- Idioma: el idioma con su variante regional o de país (
es-CL,en-GB). Para español, también la forma de tratamiento (tú, usted, vos), porque el vocabulario, el formato de números y la moneda cambian según el país. - Producto: qué hace, con todos los datos que el usuario proporcione: características, números, lugares, fechas.
- Audiencia: para quién es, y qué usan o hacen hoy.
- Acción de conversión: la única acción, y qué hace el clic. O envía un formulario (qué campos, y el endpoint si existe, o
ninguno aún), o abre una página externa (checkout, reserva, tienda de aplicaciones) en una URL determinada. - Precios: los precios en la estructura que ofrece el negocio.
- Pruebas disponibles: testimonios, métricas, nombres de clientes, logotipos, prensa, exactamente como se proporcionan.
- Activos disponibles: fotos, capturas de pantalla, logotipo, video, modelos 3D, con las rutas.
- Restricciones de marca: colores, tipografías, reglas del logotipo, material de voz, y cualquier cosa requerida o descartada.
- Stack: el stack que nombró el usuario. Si no nombró ninguno, escribe
detectar;landing-skills:landing-buildlo detecta a partir de los archivos del proyecto, es dueño de esa tabla, y escribe el stack resuelto de vuelta en este campo. - Dominio: el dominio de producción.
landing-skills:landing-buildescribe la URL canónica,og:url,og:imagey el mapa del sitio solo cuando se conoce. - Rutas de contacto: correo electrónico, teléfono, dirección, canal de mensajería, horario, según se indique. Van en el pie de página y en la página de error del formulario.
- Efectos deseados: movimiento, 3D o efectos de desplazamiento que el usuario pidió, en sus palabras. No son afirmaciones para el texto: la dirección decide su función y
landing-skills:landing-motionlos construye.
Escribe ninguno cuando el usuario dijo que no hay, y desconocido cuando nadie respondió. Un ejemplo inventado:
# Brief: Afinación Keyline
Tipo: servicio
Idioma: en-GB
Producto: afinación de pianos en casa del cliente en el Gran Mánchester; una afinación toma unos 90 minutos
Audiencia: personas con un piano vertical en casa que no lo han afinado en años
Acción de conversión: reservar una visita mediante un formulario (nombre, código postal, teléfono, semana preferida); endpoint: ninguno aún
Precios: desconocido
Pruebas disponibles: ninguna
Activos disponibles: ninguna
Restricciones de marca: desconocido
Stack: detectar
Dominio: desconocido
Rutas de contacto: teléfono, número desconocido
Efectos deseados: ninguno
Orden de trabajo
- Contenido,
landing-skills:landing-copy. El texto decide las secciones, su orden y su extensión; un diseño dibujado primero es una plantilla a la que el texto debe adaptarse. Pide al usuario que apruebelanding/copy.mdo que responda sus preguntas abiertas. Sin supervisión, continúa e indica que el texto no está aprobado. - Diseño,
landing-skills:landing-art-direction. La dirección decide los tokens; el código escrito antes de ellos codifica colores y fuentes predeterminados. - Código,
landing-skills:landing-build. La página estática debe funcionar con JavaScript desactivado antes de agregar movimiento, porque es la alternativa cuando un script falla, WebGL no está disponible o el visitante solicita movimiento reducido. - Movimiento,
landing-skills:landing-motion. Siempre pásalo por él. Bajo una intención de movimientoningunoes una breve verificación de los estados de retroalimentación. - Revisión,
landing-skills:landing-review, antes de dar el trabajo por terminado. Una página que parece terminada aún puede descartar cada cliente potencial o contener una afirmación que nadie hizo. Terminado significa quelanding/review.mdcomienza conVeredicto: aprobado. - Lanzamiento,
landing-skills:landing-launch. Prepara y prueba el lanzamiento localmente; los despliegues, DNS y cambios de cuenta se ejecutan solo con la aprobación explícita del usuario, una regla que esta habilidad posee. Sin supervisión, sin nadie a quien preguntar, detente después de preparar e informa qué está listo para ejecutar.
Después de un fallo, envía cada hallazgo a la habilidad nombrada por su Área (copy, art-direction, build, motion o launch: landing-skills:landing- más el Área), luego revisa de nuevo. Una corrección pasa por los pasos posteriores: una sección agregada al texto necesita una fila de diseño y marcado. Después de incompleto, sirve la página y revisa de nuevo. Después de dos rondas fallidas, detente e informa los hallazgos abiertos al usuario en lugar de repetir.
Transferencias
| Paso | Habilidad | Lee | Escribe |
|---|---|---|---|
| Brief | landing-skills:landing-page | la conversación, el proyecto | landing/brief.md |
| Contenido | landing-skills:landing-copy | landing/brief.md | landing/copy.md: un H2 por sección en orden de página, último H2 Marcadores de posición |
| Diseño | landing-skills:landing-art-direction | landing/brief.md, landing/copy.md | landing/direction.md, último H2 Intención de movimiento y 3D; landing/tokens.css |
| Código | landing-skills:landing-build | landing/brief.md, landing/copy.md, landing/direction.md, landing/tokens.css | la página estática; para un formulario, form.js, /thanks/ y /form-error/; el HTML plano va en public/ con una copia de tokens.css |
| Movimiento | landing-skills:landing-motion | Intención de movimiento y 3D en landing/direction.md, la página estática, landing/tokens.css | movimiento en la página, en sus propios archivos; tokens.css sin cambios |
| Revisión | landing-skills:landing-review | la página, landing/brief.md, landing/copy.md, landing/direction.md, landing/tokens.css | landing/review.md, landing/review-checklist.md, capturas de pantalla en landing/shots/ |
| Lanzamiento | landing-skills:landing-launch | la página construida y los nombres de sus campos de formulario; acción de conversión, dominio y rutas de contacto en landing/brief.md; mensajes del formulario en landing/copy.md | configuración de alojamiento; cuando el formulario no tiene endpoint, el Worker del formulario y el widget Turnstile agregados al formulario de la build; analíticas y el evento de conversión; landing/launch.md con la lista de verificación |
Cada habilidad también funciona sola, para que el usuario pueda empezar desde la mitad. Ejecuta la habilidad que solicite la petición. Necesita estos archivos, y cuando falta uno, maneja el vacío por sí misma (pregunta, o trabaja provisionalmente y lo indica), así que no escribas un archivo faltante solo para desbloquearla:
- Contenido:
landing/brief.md. - Dirección de arte:
landing/brief.mdylanding/copy.md. - Construcción:
landing/copy.md,landing/direction.md,landing/tokens.css, ylanding/brief.mdsi existe. - Movimiento: la página estática,
landing/direction.md,landing/tokens.csssi está presente. - Revisión: solo la página. Revisar un sitio existente usa solo
landing-skills:landing-review. - Lanzamiento: la página construida.
Cuando falta información
Compara la solicitud con los campos y pregunta por cada uno faltante en un solo mensaje numerado, en dos grupos:
- Sin lo que nada puede empezar: los datos del producto, la audiencia, la acción de conversión y qué hace el clic, el idioma y el país.
- Lo que tiene un valor predeterminado seguro, indicado en la pregunta para que el usuario pueda aceptarlo: el stack (detectado del proyecto, o HTML plano), efectos deseados (
ninguno), el dominio (se omite de la página hasta que se conozca), y el resto.
Nunca llenes un vacío con una audiencia, precio, testimonio, métrica, nombre de cliente o fecha inventados. Una suposición plausible termina siendo una afirmación en la página, y un visitante que detecta una duda de todas las demás líneas.
Cuando el usuario no puede responder, o no se puede preguntar a nadie:
- Un hecho sobre el negocio (precio, pruebas, audiencia, qué hace el clic, rutas de contacto) se escribe
desconocido.landing-skills:landing-copylo convierte en un[MARCADOR DE POSICIÓN: lo que se necesita]visible y lo lista. - Una elección funcional que la página no afirma puede escribirse como
asumido: <valor> (razón): el tipo de página y el idioma del mensaje del propio usuario. Registra una variante regional solo cuando sea segura; para español, el país y la forma de tratamiento permanecendesconocidoshasta que se pregunten, porque el texto depende de ellos.
Luego continúa, e informa al usuario qué campos son desconocidos o asumidos.