Seiten-Build
Die Build-Qualität folgt auf die strategische Genauigkeit, nicht umgekehrt.
Diese Phase setzt die Seite zusammen, während sie bewahrt, was für Vertrauen und Conversion wichtig ist.
Erforderliche Eingaben
workspace/pages/[seitenname]/strategy.jsonworkspace/brand/profile.mdworkspace/brand/palette.jsonworkspace/pages/[seitenname]/copy.mdworkspace/pages/[seitenname]/visuals/references/anti-slop.md(im Skill enthalten)
Fehlt die Strategie, wird abgebrochen.
Wenn workspace/pages/[seitenname]/visuals/manifest.json existiert, wird es als die maßgebliche maschinenlesbare visuelle Quelle verwendet.
Ignorieren Sie keine Provider-Metadaten, wenn sie Vertrauen, Genauigkeit oder Fallback-Chronologie betreffen.
Bewahrungshierarchie
In dieser Reihenfolge anwenden:
- vertrauenskritische Kategoriekonventionen bewahren
- Kommunikationsanforderungen des Mechanismus bewahren
- visuelle Markenidentität bewahren
- Layout-Rhythmus und Interaktionsqualität verbessern
- Anti-Slop-Qualitätsverbesserungen nur dort anwenden, wo sie 1–4 nicht verfälschen
Anti-Slop ist ein Qualitätsfilter, keine Lizenz zum Redesign.
Pre-Build-Checkliste
Vor der HTML-Generierung prüfen:
- Seitentyp bestätigt
- Conversion-Mechanismus bestätigt
- Proof-Inventar geladen
- Vertrauenssignale ausgewählt
- Visuelles Manifest in build-fähige Bildpfade aufgelöst
- Erforderliche Kategoriekonventionen bewahrt
- CTA-Ziel bekannt
- Layout-Wahl in einem Satz begründet
Wenn einer der Punkte falsch ist, abbrechen oder downgraden.
Routing-Logik
Route für physische Produkte
Anwenden, wenn der Seitentyp produktgeführt ist.
Oberhalb der Falte muss enthalten:
- deutliches Produkt- oder Mechanismus-Bild
- Angebots-Headline
- CTA
- Vertrauenssignal
SaaS / App-Route
Oberhalb der Falte muss enthalten:
- bewahrter Screenshot oder UI-Behandlung, falls erforderlich
- Ergebnis-Headline
- Vertrauenssignal
- CTA
Lead-Capture-Route
Oberhalb der Falte muss enthalten entweder:
- Formular + Friction-Reducer oder
- deutlicher CTA zu einem bekannten Ziel
Autoritäts-/Service-Route
Muss enthalten:
- Autoritätssignal oberhalb der Falte
- Proof-Bereich frühzeitig
- Einwandbehandlung bezüglich Vertrauen und Eignung
Regulierte Route
Muss enthalten:
- herabgestufte Gewissheit, wenn Proof unvollständig ist
- Compliance-Überprüfungsflag in Meta-Daten
Design-Regeln
- einzelne HTML-Datei
- responsiv bei mindestens 768px und 1024px Breakpoints
- semantisches HTML
- sichtbare Fokus-Zustände
- Alt-Texte auf allen Bildern
- keine Builder-Attribution, es sei denn, ausdrücklich gewünscht
- kein importiertes Geschmacksmuster, das Quell-Vertrauenssignale überschreibt
Anti-Slop-Nutzung
references/anti-slop.md laden und nach der Bewahrungshierarchie anwenden, nicht davor.
Post-Build-QA-Tabelle
In workspace/pages/[seitenname]/qa.md schreiben und in meta.json zusammenfassen:
| Prüfung | Bestanden? | Anmerkungen |
|---|---|---|
| Mechanismus oberhalb der Falte sichtbar | ||
| Primärer Proof oberhalb der Falte sichtbar | ||
| CTA oberhalb der Falte | ||
| Vertrauenssignal oberhalb der Falte | ||
| Kein erfundener Proof | ||
| Keine verbotenen Slop-Muster | ||
| Mobile-Kollaps geprüft | ||
| Kontrast geprüft | ||
| Alt-Texte vorhanden | ||
| Kategoriekonvention bewahrt |
Metadaten-Vertrag
meta.json muss enthalten:
- brand
- page
- page_type
- mechanism_type
- template_route
- CTA_destination
- proof_items mit Herkunftszusammenfassung
- risk_reversal_present
- compliance_flags
- review_flags
- preserved_elements
- deviations_from_source
- images_used
- sections_present
- build_confidence
Wenn ein visuelles Manifest existiert, zusätzlich:
hero_imageimage_provider_policyimages_usedals strukturierte Objekte, nicht nur als reine Dateinamen- Provider- und Fallback-Kontext, sofern für Review oder QA relevant
Build-Helfer
scripts/resolve-visual-assets.py --page-name [seitenname] verwenden, um visuals/manifest.json
in build-fähige Bild-Metadaten für HTML und meta.json umzuwandeln.
Danach scripts/prepare-build-meta.py --page-name [seitenname] --resolved-assets [datei] verwenden,
um diese aufgelösten Assets mit deterministischen Auswahlfeldern in meta.json zu integrieren:
hero_imagemechanism_imagelifestyle_imageog_imageimage_slots.heroimage_slots.mechanismimage_slots.lifestyleimage_slots.og
Dann skills/page-build/scripts/html-image-context.py --meta workspace/pages/[seitenname]/meta.json verwenden,
um literale HTML-fähige Werte auszugeben wie:
hero_img_srchero_img_altmechanism_img_srcmechanism_img_altlifestyle_img_srclifestyle_img_altog_image_path
Minimaler ausführbarer Builder:
skills/page-build/scripts/build-page.py --page-name [seitenname]Dieser konsumiertstrategy.json,meta.jsonundhtml-image-context.jsonund schreibt ein echtesindex.html-Gerüst.
Verwenden Sie die Skill-lokalen Skripte als primäre Schnittstelle für Cowork oder jede Agenten-Laufzeitumgebung, die nur den Skill-Ordner hochlädt.
Die /scripts-Kopien im Repository-Stamm sind lokale Entwicklungshelfer, keine Verpackungsanforderung.
Eval-Referenz
Bewertungskriterien und Bestehensgrenzen finden Sie in skills/page-qa/references/eval-rubric.md.
Anti-Slop-Muster finden Sie in references/anti-slop.md (im Skill enthalten).
Stopp-/Fortsetzungslogik
Stoppen, wenn:
- CTA-Ziel für eine Lead-Aktionsseite unbekannt ist
- Seite auf fehlendem Proof basiert
- Erforderliche Vertrauenssignale nicht unterstützt werden können
Mit Downgrade fortsetzen, wenn:
- Visuelle Assets teilweise fehlen, aber ein neutraler Layout-Support dennoch funktioniert
- Proof dünn ist, die Seite aber auf weichere Behauptungen umgestellt wird
Ausgabe
Schreiben:
workspace/pages/[seitenname]/index.htmlworkspace/pages/[seitenname]/meta.jsonworkspace/pages/[seitenname]/qa.md
Ein Build ohne QA-Ausgabe ist unvollständig.