TheMattBerman/landing-page-factory

Orchestrateur Landing Page Factory

Ceci est la couche de contrôle.

Utilisez cette compétence lorsque la demande concerne :

• la construction d'un pipeline complet de page d'atterrissage
• la création d'une ou plusieurs variantes de page
• la réexécution d'étapes sélectionnées après des modifications
• la détermination du bon ordre des opérations
• des tâches d'administration autour du nommage des packages de pages, des vérifications d'artefacts, du nettoyage ou de la journalisation mémoire

Ne remplacez pas les compétences d'étape. Cette compétence les achemine et les supervise.

Ce que cette compétence possède

• classification des requêtes
• ordonnancement des étapes
• vérifications préalables des artefacts
• application des arrêts obligatoires et des déclassements
• nommage des pages et des variantes
• décision des étapes à réexécuter après un changement
• journalisation mémoire dans memory/YYYY-MM-DD.md

Ce que cette compétence ne possède pas

• la logique d'extraction
• la logique de stratégie
• la logique de copywriting
• la logique de génération d'images
• la logique de construction HTML
• la notation QA elle-même

Celles-ci appartiennent à :

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

Classification des requêtes

Acheminez chaque requête dans l'un de ces modes en premier.

1. Pipeline complet

Exemples :

• « Construis-moi une page d'atterrissage pour https://example.com »
• « Exécute l'ensemble pour cette marque »

Exécuter dans l'ordre :

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

2. Pipeline de variantes

Exemples :

• « Crée une version pour les acheteurs enterprise »
• « Construis trois variantes d'angle »

Utilisez les artefacts de marque existants si disponibles. Créez un nouveau package de page par variante et réexécutez :

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

Réexécutez site-extract ou brand-profile uniquement si les faits source ont changé ou si les artefacts de marque actuels sont manquants ou faibles.

3. Réexécution d'étape

Exemples :

• « Reconstruis les visuels seulement »
• « Exécute QA à nouveau »
• « Mets à jour le copy après les changements de stratégie »

Réexécutez uniquement les étapes aval strictement nécessaires.

Règles de dépendance :

• changement de stratégie → réexécuter copy, visuels, build, qa
• changement de profil de marque → réexécuter copy, visuels, build, qa
• changement de copy → réexécuter build, qa
• changement de visuels → réexécuter build, qa
• changement de build → réexécuter qa

4. Administration / inspection

Exemples :

• « Quels artefacts manquent ? »
• « Dans quel ordre devrions-nous exécuter cela ? »
• « Crée un nouveau package de page »

Inspectez, rapportez et préparez. Ne fabriquez pas d'artefacts manquants.

Vérifications préalables

Avant d'invoquer un travail aval, vérifiez les artefacts requis.

Niveau marque :

• workspace/brand/extract.md
• workspace/brand/extract.json
• workspace/brand/profile.md lorsque copy, visuels ou build en ont besoin
• workspace/brand/palette.json lorsque visuels ou build en ont besoin

Niveau page :

• 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 un artefact requis pour l'étape demandée est manquant, arrêtez-vous et acheminez vers l'étape manquante la plus précoce.

Arrêts obligatoires

Ne continuez jamais au-delà de ces conditions :

• absence de strategy.json pour copy, visuels ou build
• absence de mécanisme unique identifié
• absence de destination CTA pour les pages lead-gen ou orientées action
• preuve trop faible pour le niveau de certitude proposé
• Firecrawl attendu pour l'extraction mais non configuré ou bloqué au moment de l'exécution
• Bloom attendu pour les visuels mais non configuré ou bloqué au moment de l'exécution, sauf si l'utilisateur approuve explicitement Nano Banana ou des actifs manuels

Lorsque bloqué, indiquez :

1. ce qui manque
2. quelle étape doit s'exécuter ensuite
3. ce qui peut être déclassé par rapport à ce qui ne peut pas l'être

Déclassements

Continuez avec un déclassement uniquement lorsque la compétence d'étape le permet.

Déclassements typiques :

• preuve faible → affirmations plus douces, objectif QA en mode brouillon uniquement
• visuels partiels → mise en page neutre de support
• échec d'image produit exacte → environnement de marque ou actif opérateur
• absence de marque Bloom → intégration pour contexte fournisseur, mais conserver les artefacts de marque du dépôt comme source de vérité

Règles de nommage

Utilisez des noms de packages de pages descriptifs sous workspace/pages/.

Modèle :

• exécution de base : [marque]-[angle-core]
• exécution de variante : [marque]-[audience]-[angle]

Bons exemples :

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

Évitez :

• test-page
• v2
• new-one

Flux de travail des variantes

Lors de la construction de plusieurs variantes :

1. conservez une source de vérité de marque partagée dans workspace/brand/
2. créez un package de page distinct par variante
3. modifiez délibérément l'audience, l'angle, le cadrage de l'offre, l'accent sur la preuve ou le traitement visuel
4. exécutez les étapes aval complètes au niveau de la page pour chaque variante
5. comparez les verdicts QA et les indicateurs de révision entre les variantes

Ne laissez pas les variantes se remplacer silencieusement.

Règles d'ordonnancement des étapes

Utilisez cette logique exacte :

• Si l'utilisateur fournit uniquement une URL : commencer par site-extract

• Si les artefacts de marque existent mais que le package de page n'existe pas : commencer par page-strategy

• Si strategy.json existe et que l'utilisateur demande du copy : exécuter page-copy

• Si copy.md et les artefacts de marque existent et que l'utilisateur demande des visuels : exécuter page-visuals

• Si la stratégie, le copy et les visuels existent : exécuter page-build

• Si les artefacts de build existent : exécuter page-qa

Points d'entrée des scripts de build et visuels

Pour Cowork et autres environnements d'exécution de dossiers de compétences, privilégiez les scripts locaux à la compétence :

• 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

Les points d'entrée scripts/ à la racine du dépôt ne sont que des wrappers locaux.

Utilisez l'outil d'administration pour le support d'orchestration :

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py status --page-name [page-name] Retourne l'état actuel des artefacts et l'étape manquante la plus précoce.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py suggest-name --brand [marque] --audience [audience] --angle [angle] Retourne un nom de package de page propre et sans collision.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --page-name [page-a] --page-name [page-b] Retourne un résumé JSON côte à côte de l'état des artefacts, du score de préparation, des notes de préparation, du titre, du type de page, de la destination CTA, du nombre d'images, des indicateurs de révision et du verdict QA lorsqu'il est présent.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [pref-marque] --format markdown Retourne un tableau de comparaison lisible en markdown pour les révisions Cowork, classé par préparation.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [pref-marque] --format markdown --output workspace/pages/[nom-rapport].md Écrit le rapport de comparaison sur disque.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [pref-marque] Compare tous les packages de pages qui correspondent au préfixe.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py log-memory --title "[titre]" --page-name [page-name] --stages "[étapes]" --verdict "[verdict]" Ajoute un court journal d'exécution à memory/YYYY-MM-DD.md.

Utilisez l'exécuteur lorsque vous souhaitez que l'orchestrateur exécute effectivement les parties scriptées du pipeline :

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --page-name example-proof --format markdown Exécute l'extraction si nécessaire, puis s'arrête à l'étape suivante nécessitant une compétence avec des instructions de passage exactes.

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --page-name example-proof --format markdown Reprend un package de page existant et continue à travers la chaîne de construction lorsque les artefacts requis existent déjà.

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --brand Example --audience enterprise --angle time-saving --format markdown Crée un nom de page de variante sans collision et exécute jusqu'à l'étape manuelle suivante.

L'exécuteur est intentionnellement hybride :

• il exécute directement les étapes scriptées
• il s'arrête proprement à page-strategy, brand-profile, page-copy et la plupart du travail de page-visuals lorsque des artefacts rédigés manquent encore
• il reprend automatiquement une fois que ces artefacts existent

Politique d'extraction :

• privilégier Firecrawl automatiquement lorsque FIRECRAWL_API_KEY est disponible
• si Firecrawl n'est pas configuré, une extraction basique est autorisée mais doit être traitée comme un déclassement
• pour les exécutions de qualité destinées à une publication publique, recommander l'ajout de Firecrawl plutôt que d'agir silencieusement comme si la qualité d'extraction était équivalente

Application des fournisseurs :

• ne pas permettre à site-extract de se réduire silencieusement à WebFetch/grattage manuel lorsque Firecrawl est le chemin prévu
• ne pas permettre à page-visuals de se réduire silencieusement à la génération d'images intégrée par défaut lorsque Bloom est le chemin prévu
• si le fournisseur préféré est bloqué, manquant ou non configuré, faites une pause et demandez à l'opérateur quel déclassement est acceptable
• ne continuez avec un déclassement que lorsque l'utilisateur l'approuve explicitement

Comportement spécifique à Cowork :

• si Cowork bloque api.firecrawl.dev, dites-le directement et recommandez soit d'ajouter le domaine à la liste blanche, soit d'exécuter la vérification préalable d'extraction locale
• si Cowork ne peut pas atteindre Bloom, dites-le directement et demandez s'il faut configurer Bloom, utiliser Nano Banana ou procéder avec des actifs manuels
• ne laissez pas « ça a plus ou moins fonctionné avec WebFetch/images par défaut » compter comme une exécution réussie du fournisseur

Ne revendiquez pas une automatisation complète pour les étapes qui dépendent encore du jugement de la compétence.

Journalisation mémoire

Après toute exécution significative, ajoutez une courte note à memory/YYYY-MM-DD.md avec :

• le nom de la marque ou de la page
• les étapes terminées
• le verdict QA s'il est disponible
• les blocages ou déclassements
• les leçons notables

Restez concis. Une courte section par exécution suffit.

Attentes en matière de sortie

Lors de l'orchestration, rapportez toujours :

• le mode choisi : pipeline complet, variante, réexécution d'étape ou administration
• le(s) nom(s) du/des package(s) de page
• les étapes exécutées ou les prochaines étapes requises
• les blocages, déclassements ou indicateurs de révision

Pour les exécutions de variantes, incluez une comparaison simple :

• nom de la variante
• audience / angle
• état actuel des artefacts
• verdict QA s'il est présent