Orquestrador Landing Page Factory

O que Orquestrador Landing Page Factory faz?

Esta é a camada de controle.

Use esta habilidade quando a requisição for sobre:

• construir um pipeline completo de landing page
• criar uma ou mais variantes de página
• reexecutar estágios selecionados após edições
• descobrir a ordem correta das operações
• tarefas administrativas em torno de nomeação de pacotes de página, verificação de artefatos, limpeza ou registro de memória

Não substitua as habilidades de estágio. Esta habilidade as roteia e supervisiona.

O que esta habilidade possui

• classificação de requisições
• ordenação de estágios
• verificações de pré-voo de artefatos
• imposição de paradas bruscas e rebaixamentos
• nomeação de página e nomeação de variante
• decisão sobre quais estágios devem ser reexecutados após uma alteração
• registro de memória em memory/YYYY-MM-DD.md

O que esta habilidade não possui

• lógica de extração
• lógica de estratégia
• lógica de copywriting
• lógica de geração de imagens
• lógica de construção HTML
• pontuação de QA em si

Isso pertence a:

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

Classificação de requisições

Roteie cada requisição para um destes modos primeiro.

1. Pipeline completo

Exemplos:

• "Construa uma landing page para https://exemplo.com"
• "Execute tudo para esta marca"

Executar em ordem:

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

Exemplos:

• "Faça uma versão para compradores corporativos"
• "Construa três variantes de ângulo"

Use os artefatos de marca existentes, se disponíveis. Crie um novo pacote de página por variante e reexecute:

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

Reexecute site-extract ou brand-profile apenas se os fatos de origem mudaram ou se os artefatos de marca atuais estão ausentes ou fracos.

3. Reexecução de estágio

Exemplos:

• "Reconstrua apenas visuais"
• "Execute o QA novamente"
• "Atualize o copy após mudanças na estratégia"

Reexecute apenas os estágios downstream mínimos necessários.

Regras de dependência:

• estratégia mudou → reexecutar copy, visuais, build, qa
• perfil de marca mudou → reexecutar copy, visuais, build, qa
• copy mudou → reexecutar build, qa
• visuais mudaram → reexecutar build, qa
• build mudou → reexecutar qa

4. Administração/inspeção

Exemplos:

• "Quais artefatos estão faltando?"
• "Qual ordem devemos executar isso?"
• "Crie um novo pacote de página"

Inspecione, relate e prepare. Não fabrique artefatos ausentes.

Verificações de pré-voo

Antes de invocar trabalho downstream, verifique os artefatos necessários.

Nível de marca:

• workspace/brand/extract.md
• workspace/brand/extract.json
• workspace/brand/profile.md quando copy, visuais ou build precisarem dele
• workspace/brand/palette.json quando visuais ou build precisarem dele

Nível 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

Se um artefato necessário para o estágio solicitado estiver faltando, pare e roteie para o estágio ausente mais antigo.

Paradas bruscas

Nunca continue além destes:

• sem strategy.json para copy, visuais ou build
• nenhum mecanismo único identificado
• nenhum destino de CTA para páginas de geração de leads ou orientadas a ação
• prova muito fraca para o nível de certeza proposto
• Firecrawl esperado para extração, mas não configurado ou bloqueado em tempo de execução
• Bloom esperado para visuais, mas não configurado ou bloqueado em tempo de execução, a menos que o usuário aprove explicitamente Nano Banana ou ativos manuais

Quando bloqueado, declare:

1. o que está faltando
2. qual estágio deve ser executado a seguir
3. o que pode ser rebaixado versus o que não pode

Rebaixamentos

Continue com rebaixamento apenas quando a habilidade do estágio permitir.

Rebaixamentos típicos:

• prova fraca → alegações mais suaves, alvo de QA apenas como rascunho
• visuais parciais → layout de suporte neutro
• falha de imagem de produto exata → ambiente de marca ou ativo do operador
• marca Bloom ausente → onboard para contexto do provedor, mas mantenha artefatos de marca do repositório como fonte da verdade

Regras de nomeação

Use nomes descritivos de pacotes de página em workspace/pages/.

Padrão:

• execução base: [marca]-[ângulo-central]
• execução de variante: [marca]-[público]-[ângulo]

Bons exemplos:

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

Evite:

• test-page
• v2
• new-one

Fluxo de trabalho de variantes

Ao construir múltiplas variantes:

1. mantenha uma fonte da verdade de marca compartilhada em workspace/brand/
2. crie um pacote de página separado por variante
3. altere deliberadamente público, ângulo, enquadramento de oferta, ênfase de prova ou tratamento visual
4. execute estágios downstream completos no nível da página para cada variante
5. compare vereditos de QA e sinalizadores de revisão entre variantes

Não permita que variantes sobrescrevam umas às outras silenciosamente.

Regras de ordenação de estágios

Use esta lógica exata:

• Se o usuário fornecer apenas uma URL: comece em site-extract

• Se artefatos de marca existem, mas o pacote de página não: comece em page-strategy

• Se strategy.json existe e o usuário pede copy: execute page-copy

• Se copy.md e artefatos de marca existem e o usuário pede visuais: execute page-visuals

• Se estratégia, copy e visuais existem: execute page-build

• Se artefatos de build existem: execute page-qa

Pontos de entrada de scripts de build e visuais

Para Cowork e outros runtimes de pasta de habilidades, prefira os scripts locais da habilidade:

• 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

Os pontos de entrada scripts/ na raiz do repositório são apenas wrappers locais.

Use o auxiliar de administração para suporte de orquestração:

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py status --page-name [page-name] Retorna o status atual do artefato e o estágio ausente mais antigo.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py suggest-name --brand [brand] --audience [audience] --angle [angle] Retorna um nome de pacote de página limpo e sem colisões.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --page-name [page-a] --page-name [page-b] Retorna um resumo JSON lado a lado do status do artefato, pontuação de prontidão, notas de prontidão, título, tipo de página, destino do CTA, contagem de imagens, sinalizadores de revisão e veredito de QA quando presente.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] --format markdown Retorna uma tabela de comparação markdown legível por humanos para revisões Cowork, classificada por prontidão.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] --format markdown --output workspace/pages/[report-name].md Grava o relatório de comparação em disco.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] Compara todos os pacotes de página que correspondem ao prefixo.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py log-memory --title "[title]" --page-name [page-name] --stages "[stages]" --verdict "[verdict]" Adiciona um breve registro de execução a memory/YYYY-MM-DD.md.

Use o executor quando quiser que o orquestrador realmente execute as partes scriptadas do pipeline:

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://exemplo.com --page-name example-proof --format markdown Executa a extração se necessário, então para no próximo estágio criado pela habilidade com instruções exatas de handoff.

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --page-name example-proof --format markdown Retoma um pacote de página existente e continua na cadeia de build quando os artefatos necessários já existem.

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://exemplo.com --brand Exemplo --audience enterprise --angle time-saving --format markdown Cria um nome de página de variante sem colisões e executa até o próximo estágio manual.

O executor é intencionalmente híbrido:

• executa estágios scriptados diretamente
• para claramente em page-strategy, brand-profile, page-copy e a maior parte do trabalho de page-visuals quando artefatos criados ainda estão faltando
• retoma automaticamente assim que esses artefatos existem

Política de extração:

• prefira Firecrawl automaticamente quando FIRECRAWL_API_KEY estiver disponível
• se Firecrawl não estiver configurado, a extração básica é permitida, mas deve ser tratada como um rebaixamento
• para execuções de qualidade de lançamento público, recomende adicionar Firecrawl em vez de agir silenciosamente como se a qualidade da extração fosse equivalente

Imposição de provedor:

• não permita que site-extract colapse silenciosamente em WebFetch/raspagem manual quando Firecrawl for o caminho pretendido
• não permita que page-visuals colapse silenciosamente em geração de imagem padrão embutida quando Bloom for o caminho pretendido
• se o provedor preferencial estiver bloqueado, ausente ou não configurado, pause e pergunte ao operador qual rebaixamento é aceitável
• continue com um rebaixamento apenas quando o usuário aprovar explicitamente

Comportamento específico do Cowork:

• se Cowork bloquear api.firecrawl.dev, diga isso diretamente e recomende adicionar o domínio à lista de permissões ou executar o pré-voo de extração local
• se Cowork não conseguir alcançar Bloom, diga isso diretamente e pergunte se deve configurar Bloom, usar Nano Banana ou prosseguir com ativos manuais
• não deixe que "funcionou mais ou menos com WebFetch/imagens padrão" conte como uma execução de provedor bem-sucedida

Não reivindique automação completa para estágios que ainda dependem de julgamento criado pela habilidade.

Registro de memória

Após qualquer execução significativa, adicione uma breve nota a memory/YYYY-MM-DD.md com:

• nome da marca ou página
• estágios concluídos
• veredito de QA, se disponível
• bloqueadores ou rebaixamentos
• lições notáveis

Mantenha conciso. Uma seção curta por execução é suficiente.

Expectativas de saída

Ao orquestrar, sempre reporte:

• modo escolhido: pipeline completo, variante, reexecução de estágio ou administração
• nome(s) do(s) pacote(s) de página
• estágios executados ou próximos estágios necessários
• bloqueadores, rebaixamentos ou sinalizadores de revisão

Para execuções de variantes, inclua uma comparação simples:

• nome da variante
• público / ângulo
• status atual do artefato
• veredito de QA, se presente