TheMattBerman/landing-page-factory

Landing Page Factory Orchestrator

Dies ist die Steuerungsebene.

Verwenden Sie diesen Skill, wenn die Anfrage Folgendes betrifft:

• Aufbau einer vollständigen Landing-Page-Pipeline
• Erstellung einer oder mehrerer Seitenvarianten
• Erneutes Ausführen ausgewählter Phasen nach Bearbeitungen
• Ermittlung der richtigen Reihenfolge der Vorgänge
• Verwaltungsaufgaben bezüglich Seitenpaketbenennung, Artefaktprüfungen, Bereinigung oder Speicherprotokollierung

Ersetzen Sie nicht die Phasen-Skills. Dieser Skill leitet sie und überwacht sie.

Was dieser Skill besitzt

• Anfrageklassifizierung
• Phasenreihenfolge
• Vorabprüfung von Artefakten
• Durchsetzung von Haltestopps und Herabstufungen
• Seitenbenennung und Variantenbenennung
• Entscheidung, welche Phasen nach einer Änderung erneut ausgeführt werden müssen
• Speicherprotokollierung in memory/YYYY-MM-DD.md

Was dieser Skill nicht besitzt

• Extraktionslogik
• Strategielogik
• Textschreiberlogik
• Bildgenerierungslogik
• HTML-Build-Logik
• QA-Bewertung selbst

Diese gehören zu:

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

Anfrageklassifizierung

Leiten Sie jede Anfrage zuerst in einen dieser Modi.

1. Vollständige Pipeline

Beispiele:

• "Erstelle mir eine Landing Page für https://example.com"
• "Führe das Ganze für diese Marke aus"

Ausführung in der Reihenfolge:

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

2. Varianten-Pipeline

Beispiele:

• "Erstelle eine Version für Unternehmenskäufer"
• "Baue drei Winkelvarianten"

Verwenden Sie die vorhandenen Markenartefakte, falls verfügbar. Erstellen Sie ein neues Seitenpaket pro Variante und führen Sie erneut aus:

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

Führen Sie site-extract oder brand-profile nur erneut aus, wenn sich die Quellfakten geändert haben oder die aktuellen Markenartefakte fehlen oder schwach sind.

3. Phasen-Neustart

Beispiele:

• "Erstelle nur die Visuals neu"
• "Führe die QA erneut aus"
• "Aktualisiere den Text nach Strategieänderungen"

Führen Sie nur die minimal notwendigen nachgelagerten Phasen erneut aus.

Abhängigkeitsregeln:

• Strategie geändert → Text, Visuals, Build, QA erneut ausführen
• Markenprofil geändert → Text, Visuals, Build, QA erneut ausführen
• Text geändert → Build, QA erneut ausführen
• Visuals geändert → Build, QA erneut ausführen
• Build geändert → QA erneut ausführen

4. Admin / Inspektion

Beispiele:

• "Welche Artefakte fehlen?"
• "In welcher Reihenfolge sollten wir das ausführen?"
• "Erstelle ein neues Seitenpaket"

Prüfen, berichten und vorbereiten. Erfinden Sie keine fehlenden Artefakte.

Vorabprüfungen

Bevor Sie nachgelagerte Arbeiten aufrufen, überprüfen Sie die erforderlichen Artefakte.

Markenebene:

• workspace/brand/extract.md
• workspace/brand/extract.json
• workspace/brand/profile.md wenn Text, Visuals oder Build es benötigen
• workspace/brand/palette.json wenn Visuals oder Build es benötigen

Seitenebene:

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

Wenn ein für die angeforderte Phase erforderliches Artefakt fehlt, stoppen Sie und leiten Sie zur frühesten fehlenden Phase weiter.

Haltestopps

Fahren Sie niemals über diese hinaus:

• keine strategy.json für Text, Visuals oder Build
• kein eindeutiger Mechanismus identifiziert
• kein CTA-Ziel für Lead-Gen- oder aktionsorientierte Seiten
• Nachweis zu dünn für die vorgeschlagene Sicherheitsstufe
• Firecrawl für die Extraktion erwartet, aber nicht konfiguriert oder zur Laufzeit blockiert
• Bloom für Visuals erwartet, aber nicht konfiguriert oder zur Laufzeit blockiert, es sei denn, der Benutzer genehmigt ausdrücklich Nano Banana oder manuelle Assets

Geben Sie bei Blockade an:

1. was fehlt
2. welche Phase als nächstes ausgeführt werden muss
3. was herabgestuft werden kann und was nicht

Herabstufungen

Fahren Sie mit einer Herabstufung nur fort, wenn der Phasen-Skill dies zulässt.

Typische Herabstufungen:

• schwacher Nachweis → weichere Behauptungen, QA-Ziel nur als Entwurf
• teilweise Visuals → neutrales Layout zur Unterstützung
• Fehler bei exakten Produktbildern → Markenumgebung oder Operator-Asset
• fehlende Bloom-Marke → Onboarding für Anbieterkontext, aber Repository-Markenartefakte als Quelle der Wahrheit behalten

Benennungsregeln

Verwenden Sie beschreibende Seitenpaketnamen unter workspace/pages/.

Muster:

• Basisausführung: [marke]-[kernwinkel]
• Variantenausführung: [marke]-[zielgruppe]-[winkel]

Gute Beispiele:

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

Vermeiden Sie:

• test-page
• v2
• new-one

Varianten-Workflow

Beim Erstellen mehrerer Varianten:

1. eine gemeinsame Markenwahrheit in workspace/brand/ behalten
2. ein separates Seitenpaket pro Variante erstellen
3. Zielgruppe, Winkel, Angebotsrahmen, Nachweisschwerpunkt oder visuelle Gestaltung bewusst ändern
4. vollständige seitenbezogene nachgelagerte Phasen für jede Variante ausführen
5. QA-Ergebnisse und Überprüfungsflags über Varianten hinweg vergleichen

Lassen Sie nicht zu, dass Varianten sich gegenseitig stillschweigend überschreiben.

Regeln für die Phasenreihenfolge

Verwenden Sie diese exakte Logik:

• Wenn der Benutzer nur eine URL angibt: beginnen Sie bei site-extract

• Wenn Markenartefakte vorhanden sind, aber das Seitenpaket nicht: beginnen Sie bei page-strategy

• Wenn strategy.json vorhanden ist und der Benutzer nach Text fragt: führen Sie page-copy aus

• Wenn copy.md und Markenartefakte vorhanden sind und der Benutzer nach Visuals fragt: führen Sie page-visuals aus

• Wenn Strategie, Text und Visuals vorhanden sind: führen Sie page-build aus

• Wenn Build-Artefakte vorhanden sind: führen Sie page-qa aus

Build- und Visual-Skripteinstiegspunkte

Für Cowork und andere Skill-Ordner-Laufzeiten bevorzugen Sie die Skill-lokalen Skripte:

• 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

Repository-Root scripts/ Einstiegspunkte sind nur lokale Wrapper.

Verwenden Sie den Admin-Helfer für Orchestrierungsunterstützung:

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py status --page-name [seitenname] Gibt den aktuellen Artefaktstatus und die früheste fehlende Phase zurück.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py suggest-name --brand [marke] --audience [zielgruppe] --angle [winkel] Gibt einen sauberen, nicht kollidierenden Seitenpaketnamen zurück.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --page-name [seite-a] --page-name [seite-b] Gibt eine nebeneinanderliegende JSON-Zusammenfassung von Artefaktstatus, Bereitschaftsbewertung, Bereitschaftshinweisen, Überschrift, Seitentyp, CTA-Ziel, Bildanzahl, Überprüfungsflags und QA-Ergebnis (falls vorhanden) zurück.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [marken-prefix] --format markdown Gibt eine für Menschen lesbare Markdown-Vergleichstabelle für Cowork-Überprüfungen zurück, geordnet nach Bereitschaft.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [marken-prefix] --format markdown --output workspace/pages/[berichtsname].md Schreibt den Vergleichsbericht auf die Festplatte.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [marken-prefix] Vergleicht alle Seitenpakete, die mit dem Präfix übereinstimmen.

• python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py log-memory --title "[titel]" --page-name [seitenname] --stages "[phasen]" --verdict "[urteil]" Fügt einen kurzen Ausführungsprotokolleintrag zu memory/YYYY-MM-DD.md hinzu.

Verwenden Sie den Runner, wenn der Orchestrator die skriptbasierten Teile der Pipeline tatsächlich ausführen soll:

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --page-name example-proof --format markdown Führt die Extraktion bei Bedarf aus und stoppt dann an der nächsten Skill-erstellten Phase mit genauen Übergabeanweisungen.

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --page-name example-proof --format markdown Nimmt ein vorhandenes Seitenpaket wieder auf und fährt durch die Build-Kette fort, wenn die erforderlichen Artefakte bereits vorhanden sind.

• python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --brand Example --audience enterprise --angle time-saving --format markdown Erstellt einen nicht kollidierenden Variantenseitennamen und führt aus, bis zur nächsten manuellen Phase.

Der Runner ist absichtlich hybrid:

• er führt skriptbasierte Phasen direkt aus
• er stoppt sauber bei page-strategy, brand-profile, page-copy und den meisten Arbeiten von page-visuals, wenn erstellte Artefakte noch fehlen
• er wird automatisch fortgesetzt, sobald diese Artefakte vorhanden sind

Extraktionsrichtlinie:

• bevorzugen Sie automatisch Firecrawl, wenn FIRECRAWL_API_KEY verfügbar ist
• wenn Firecrawl nicht konfiguriert ist, ist eine grundlegende Extraktion erlaubt, sollte aber als Herabstufung behandelt werden
• für veröffentlichungsreife Ausführungen empfehlen Sie die Hinzufügung von Firecrawl, anstatt stillschweigend so zu tun, als ob die Extraktionsqualität gleichwertig wäre

Anbieterdurchsetzung:

• erlauben Sie nicht, dass site-extract leise auf WebFetch/manuelles Scraping zurückfällt, wenn Firecrawl der beabsichtigte Weg ist
• erlauben Sie nicht, dass page-visuals leise auf die standardmäßige integrierte Bildgenerierung zurückfällt, wenn Bloom der beabsichtigte Weg ist
• wenn der bevorzugte Anbieter blockiert, nicht vorhanden oder nicht konfiguriert ist, pausieren Sie und fragen Sie den Operator, welche Herabstufung akzeptabel ist
• fahren Sie mit einer Herabstufung nur fort, wenn der Benutzer sie ausdrücklich genehmigt

Cowork-spezifisches Verhalten:

• wenn Cowork api.firecrawl.dev blockiert, sagen Sie dies direkt und empfehlen Sie entweder eine Whitelist der Domain oder die Ausführung der lokalen Extraktionsvorabprüfung
• wenn Cowork Bloom nicht erreichen kann, sagen Sie dies direkt und fragen Sie, ob Bloom konfiguriert, Nano Banana verwendet oder mit manuellen Assets fortgefahren werden soll
• lassen Sie "es hat irgendwie mit WebFetch/Standardbildern funktioniert" nicht als erfolgreiche Anbieterausführung gelten

Behaupten Sie nicht die vollständige Automatisierung für Phasen, die noch auf das Urteil des Skill-Erstellers angewiesen sind.

Speicherprotokollierung

Fügen Sie nach jeder sinnvollen Ausführung einen kurzen Hinweis zu memory/YYYY-MM-DD.md hinzu mit:

• Marken- oder Seitenname
• abgeschlossene Phasen
• QA-Ergebnis, falls verfügbar
• Blocker oder Herabstufungen
• bemerkenswerte Erkenntnisse

Halten Sie es kurz. Ein kurzer Abschnitt pro Ausführung ist ausreichend.

Ausgabeerwartungen

Geben Sie bei der Orchestrierung immer an:

• gewählter Modus: Vollständige Pipeline, Variante, Phasen-Neustart oder Admin
• Seitenpaketname(n)
• ausgeführte Phasen oder nächste erforderliche Phasen
• Blocker, Herabstufungen oder Überprüfungsflags

Für Variantenausführungen fügen Sie einen einfachen Vergleich bei:

• Variantenname
• Zielgruppe / Winkel
• aktueller Artefaktstatus
• QA-Ergebnis, falls vorhanden