Landing Page Factory Orchestrator

Orquestador de Landing Page Factory

Esta es la capa de control.

Usa esta habilidad cuando la solicitud trate sobre:

• la construcción de un pipeline completo de página de aterrizaje
• la creación de una o más variantes de página
• la reejecución de etapas seleccionadas después de ediciones
• la determinación del orden correcto de operaciones
• tareas de administración sobre el nombre del paquete de página, verificación de artefactos, limpieza o registro en memoria

No reemplaces las habilidades de etapa. Esta habilidad las enruta y supervisa.

Lo que posee esta habilidad

• clasificación de solicitudes
• ordenamiento de etapas
• verificaciones previas de artefactos
• aplicación de paradas forzosas y degradaciones
• nombrado de páginas y variantes
• decisión sobre qué etapas deben reejecutarse tras un cambio
• registro en memoria en memory/YYYY-MM-DD.md

Lo que no posee esta habilidad

• lógica de extracción
• lógica de estrategia
• lógica de redacción
• lógica de generación de imágenes
• lógica de construcción HTML
• puntuación de QA

Esas pertenecen a:

• site-extract
• page-strategy
• brand-profile
• page-copy
• page-visuals
• page-build
• page-qa

Clasificación de solicitudes

Enruta cada solicitud a uno de estos modos primero.

1. Pipeline completo

Ejemplos:

• "Créame una página de aterrizaje para https://example.com"
• "Ejecute todo para esta marca"

Ejecutar en orden:

1. site-extract
2. page-strategy
3. brand-profile
4. page-copy
5. page-visuals
6. page-build
7. page-qa

2. Pipeline de variante

Ejemplos:

• "Haz una versión para compradores empresariales"
• "Construye tres variantes de enfoque"

Usa los artefactos de marca existentes si están disponibles. Crea un nuevo paquete de página por variante y reejecuta:

1. page-strategy
2. page-copy
3. page-visuals
4. page-build
5. page-qa

Reejecuta site-extract o brand-profile solo si los hechos de origen cambiaron o si los artefactos de marca actuales faltan o son débiles.

3. Reejecución de etapa

Ejemplos:

• "Reconstruir solo los visuales"
• "Ejecutar QA otra vez"
• "Actualizar el copy tras cambios en la estrategia"

Solo reejecuta las etapas posteriores mínimas necesarias.

Reglas de dependencia:

• estrategia cambiada → reejecutar copy, visuales, build, qa
• perfil de marca cambiado → reejecutar copy, visuales, build, qa
• copy cambiado → reejecutar build, qa
• visuales cambiados → reejecutar build, qa
• build cambiado → reejecutar qa

4. Administración / inspección

Ejemplos:

• "¿Qué artefactos faltan?"
• "¿En qué orden deberíamos ejecutar esto?"
• "Crear un nuevo paquete de página"

Inspecciona, informa y prepara. No fabriques artefactos faltantes.

Verificaciones previas

Antes de invocar trabajo en etapas posteriores, verifica los artefactos requeridos.

A nivel de marca:

• workspace/brand/extract.md
• workspace/brand/extract.json
• workspace/brand/profile.md cuando copy, visuales o build lo necesiten
• workspace/brand/palette.json cuando visuales o build lo necesiten

A nivel de página:

• workspace/pages/[page-name]/strategy.json
• workspace/pages/[page-name]/copy.md
• workspace/pages/[page-name]/visuals/
• workspace/pages/[page-name]/index.html
• workspace/pages/[page-name]/meta.json
• workspace/pages/[page-name]/qa.md

Si falta un artefacto requerido para la etapa solicitada, detente y enruta a la primera etapa faltante.

Paradas forzosas

Nunca continúes más allá de estas:

• no hay strategy.json para copy, visuales o build
• no hay un mecanismo único identificado
• no hay destino de CTA para páginas de generación de leads o impulsadas por acción
• prueba demasiado débil para el nivel de certeza propuesto
• se espera Firecrawl para extracción pero no está configurado o está bloqueado en tiempo de ejecución
• se espera Bloom para visuales pero no está configurado o está bloqueado en tiempo de ejecución, a menos que el usuario apruebe explícitamente Nano Banana o activos manuales

Cuando esté bloqueado, indica:

1. qué falta
2. qué etapa debe ejecutarse a continuación
3. qué se puede degradar y qué no

Degradaciones

Continúa con degradación solo cuando la habilidad de la etapa lo permita.

Degradaciones típicas:

• prueba débil → afirmaciones más suaves, objetivo de QA solo borrador
• visuales parciales → diseño de soporte neutral
• fallo de imagen de producto exacta → activo de marca de entorno u operador
• falta la marca Bloom → incorporar para contexto del proveedor, pero mantener los artefactos de marca del repositorio como fuente de verdad

Reglas de nombrado

Usa nombres descriptivos para los paquetes de página bajo workspace/pages/.

Patrón:

• ejecución base: [marca]-[enfoque-principal]
• ejecución variante: [marca]-[audiencia]-[enfoque]

Buenos ejemplos:

• ridge-wallet-proof
• stealads-enterprise-time
• notion-agency-velocity

Evita:

• test-page
• v2
• new-one

Flujo de trabajo de variantes

Al construir múltiples variantes:

1. mantén una única fuente de verdad de marca compartida en workspace/brand/
2. crea un paquete de página separado por variante
3. cambia audiencia, enfoque, encuadre de oferta, énfasis en prueba o tratamiento visual de manera deliberada
4. ejecuta todas las etapas posteriores a nivel de página para cada variante
5. compara veredictos de QA y banderas de revisión entre variantes

No permitas que las variantes se sobrescriban silenciosamente entre sí.

Reglas de ordenamiento de etapas

Usa esta lógica exacta:

• Si el usuario proporciona solo una URL: empezar en site-extract

• Si existen artefactos de marca pero no el paquete de página: empezar en page-strategy

• Si existe strategy.json y el usuario pide copy: ejecutar page-copy

• Si existen copy.md y artefactos de marca y el usuario pide visuales: ejecutar page-visuals

• Si existen estrategia, copy y visuales: ejecutar page-build

• Si existen artefactos de build: ejecutar page-qa

Puntos de entrada de scripts de build y visuales

Para Cowork y otros entornos de ejecución de carpetas de habilidades, prefiere los scripts locales de la habilidad:

• skills/landing-page-factory-orchestrator/scripts/page-admin.py
• skills/page-visuals/scripts/image-provider.sh
• skills/page-build/scripts/resolve-visual-assets.py
• skills/page-build/scripts/prepare-build-meta.py
• skills/page-build/scripts/select-build-images.py
• skills/page-build/scripts/html-image-context.py
• skills/page-build/scripts/build-page.py

Los puntos de entrada scripts/ en la raíz del repositorio son solo envoltorios locales.

Usa el ayudante de administración para soporte de orquestación:

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py status --page-name [page-name] Devuelve el estado actual de los artefactos y la primera etapa faltante.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py suggest-name --brand [brand] --audience [audience] --angle [angle] Devuelve un nombre de paquete de página limpio y sin colisiones.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --page-name [page-a] --page-name [page-b] Devuelve un resumen JSON lado a lado del estado de artefactos, puntuación de preparación, notas de preparación, titular, tipo de página, destino de CTA, número de imágenes, banderas de revisión y veredicto de QA cuando esté presente.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] --format markdown Devuelve una tabla de comparación en markdown legible para revisiones de Cowork, ordenada por preparación.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] --format markdown --output workspace/pages/[report-name].md Escribe el informe de comparación en disco.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] Compara todos los paquetes de página que coincidan con el prefijo.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py log-memory --title "[title]" --page-name [page-name] --stages "[stages]" --verdict "[verdict]" Agrega un breve registro de ejecución a memory/YYYY-MM-DD.md.

Usa el ejecutor cuando quieras que el orquestador ejecute realmente las partes con script del pipeline:

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --page-name example-proof --format markdown Ejecuta extracción si es necesario, luego se detiene en la siguiente etapa creada por la habilidad con instrucciones de entrega exactas.

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --page-name example-proof --format markdown Reanuda un paquete de página existente y continúa a través de la cadena de construcción cuando los artefactos requeridos ya existen.

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --brand Example --audience enterprise --angle time-saving --format markdown Crea un nombre de página variante sin colisiones y ejecuta hasta la siguiente etapa manual.

El ejecutor es intencionalmente híbrido:

• ejecuta directamente las etapas con script
• se detiene limpiamente en page-strategy, brand-profile, page-copy y la mayor parte del trabajo de page-visuals cuando aún faltan artefactos creados por la habilidad
• se reanuda automáticamente una vez que esos artefactos existen

Política de extracción:

• prefiere Firecrawl automáticamente cuando FIRECRAWL_API_KEY esté disponible
• si Firecrawl no está configurado, se permite la extracción básica pero debe tratarse como una degradación
• para ejecuciones de calidad de publicación pública, recomienda agregar Firecrawl en lugar de actuar silenciosamente como si la calidad de extracción fuera equivalente

Aplicación de proveedores:

• no permitas que site-extract se reduzca silenciosamente a WebFetch/raspado manual cuando Firecrawl es la ruta prevista
• no permitas que page-visuals se reduzca silenciosamente a la generación de imágenes incorporada por defecto cuando Bloom es la ruta prevista
• si el proveedor preferido está bloqueado, ausente o no configurado, pausa y pregunta al operador qué degradación es aceptable
• solo continúa con una degradación cuando el usuario la apruebe explícitamente

Comportamiento específico de Cowork:

• si Cowork bloquea api.firecrawl.dev, díselo directamente y recomienda permitir el dominio o ejecutar la verificación previa de extracción local
• si Cowork no puede alcanzar Bloom, díselo directamente y pregunta si desea configurar Bloom, usar Nano Banana o proceder con activos manuales
• no permitas que "funcionó más o menos con WebFetch/imágenes por defecto" cuente como una ejecución exitosa del proveedor

No reclames automatización completa para etapas que aún dependen del juicio de la habilidad.

Registro en memoria

Después de cualquier ejecución significativa, agrega una nota breve a memory/YYYY-MM-DD.md con:

• nombre de la marca o página
• etapas completadas
• veredicto de QA si está disponible
• bloqueos o degradaciones
• lecciones notables

Mantenlo conciso. Una sección corta por ejecución es suficiente.

Expectativas de salida

Al orquestar, siempre reporta:

• modo elegido: pipeline completo, variante, reejecución de etapa o administración
• nombre(s) del paquete de página
• etapas ejecutadas o próximas etapas requeridas
• bloqueos, degradaciones o banderas de revisión

Para ejecuciones de variantes, incluye una comparación plana:

• nombre de la variante
• audiencia / enfoque
• estado actual de artefactos
• veredicto de QA si está presente