Communitygithub.com

wuongg/wait_skills

Übergabevertrag zwischen `landing-page-composition-architect` (Planer) und `cinematic-landing-page` (Ersteller). Legt das Blueprint-JSON-Schema, die Mapping von Layout-Familie zu visuellem Archetyp, die vom Ersteller zu erhaltenden Invarianten und die Fehlermodi fest, die beide Seiten ablehnen müssen.

Was ist wait_skills?

Diese Skill-Beschreibung definiert den Integrationsvertrag zwischen zwei KI-Agenten in einer Landing-Page-Pipeline: dem Planer (`landing-page-composition-architect`), der die Struktur und Reihenfolge der Abschnitte festlegt, und dem Ersteller (`cinematic-landing-page`), der die visuelle und bewegungstechnische Umsetzung codiert. Der Vertrag spezifiziert ein Composition-Blueprint-JSON-Schema, das der Planer als endgültiges Artefakt ausgibt. Dieses enthält unter anderem Abschnittsliste, Layout-Familien, Rhythmus-Regeln und eine Kill-Liste. Der Ersteller leitet daraus einen Build-Spec ab, der den gewählten Stack, den dominanten visuellen Archetyp (A–F) und die Motion-Signaturen festlegt. Es werden klare Grenzen gezogen: Der Ersteller darf keine Abschnitte hinzufügen, entfernen oder umordnen, und der Planer darf keine nicht verfügbaren Layout-Familien oder unvollständige Blueprints ausgeben. Der Vertrag enthält auch ein Validierungs-Gate (Checkliste) und ein formelles Revisionsprotokoll für den Fall, dass der Ersteller ein Blueprint ablehnen muss. Das Ziel ist es, Fehler durch Missverständnisse zu vermeiden und eine saubere, automatisierte Zusammenarbeit zwischen den Skills zu gewährleisten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wuongg/wait_skills/tree/HEAD/.cursor/skills/landing-page-skills-integration

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Landing Page Skills – Integrationsvertrag v1

Zwei Skills, eine Pipeline:

User Brief
   │
   ▼
[ landing-page-composition-architect ]   ← entscheidet WAS & REIHENFOLGE
   │  gibt aus: Composition Blueprint (gesperrt)
   ▼
[ INTEGRATION.md  ← diese Datei ]       ← übersetzt Blueprint → Build Spec
   │  gibt aus: Build Spec (Archetyp + Bewegung + Stack)
   ▼
[ cinematic-landing-page ]               ← entscheidet WIE ES AUSSIEHT & SICH BEWEGT, schreibt Code
   │
   ▼
Ausgelieferte Seite

Goldene Regel. Der Planer besitzt die Struktur. Der Ersteller besitzt die Oberfläche. Keiner darf die Linie überschreiten. Diese Datei sorgt dafür, dass sie ehrlich bleiben.


1. DAS ÜBERGABE-ARTEFAKT – Composition Blueprint (JSON)

Das endgültige Artefakt des Planers MUSS als dieses JSON darstellbar sein, selbst wenn es dem Benutzer als Tabelle präsentiert wurde. Der Ersteller liest dieses JSON wörtlich.

{
  "blueprint_version": "1.0",
  "page": {
    "intent": "I1 | I2 | I3 | I4 | I5 | I6",
    "intent_name": "Launch | Conversion | Brand | Portfolio | Product Story | Campaign",
    "awareness": "cold | warm | hot",
    "traffic": "ads | organic | social | referral | direct",
    "narrative_spine": "Hook -> Value -> Proof -> CTA",
    "pace": "fast | balanced | slow-burn",
    "density": "minimal | balanced | rich",
    "primary_emotion": "string (ein Wort)",
    "total_sections": 5
  },
  "sections": [
    {
      "index": 1,
      "slot": "S1",
      "name": "Hero",
      "jtbd": "Aufmerksamkeit erregen + Ton setzen",
      "why_here": "Erster Eindruck",
      "layout_family": "full-bleed hero",
      "content_required": ["headline", "subcopy", "hero_media"],
      "visual_weight": "very high",
      "cta_role": "soft"
    }
  ],
  "rhythm_rules": [
    "Keine zwei Abschnitte mit 'very high' Gewicht nebeneinander.",
    "Nach einem Full-Bleed-Hero oder einer Mood-Gallery muss als nächstes eine zentrierte Aussage oder ein redaktioneller Block kommen.",
    "Primärer CTA erscheint genau einmal."
  ],
  "kill_list": [
    "Kein FAQ",
    "Kein 6-Karten-Feature-Grid",
    "Keine Metrikleiste"
  ],
  "handoff_note": "Ein Absatz: zu bewahrende Emotion, welche Slots eine filmische Behandlung wünschen, welche ruhig bleiben.",
  "locked": true
}

Invarianten.

  • sections.length ∈ [4, 9]; 5–8 für Standard-Intents.
  • Jeder slot ∈ {S1..S16}, eindeutig pro Seite.
  • layout_family ∈ geschlossene Liste (siehe §3).
  • locked: true ist ein Versprechen: Der Ersteller DARF Abschnitte NICHT neu anordnen, hinzufügen, entfernen oder umbenennen.

2. WAS DER ERSTELLER ENTSCHEIDEN DARF (und was NICHT)

Der Ersteller darf entscheiden

  • Filmischer Archetyp (A/B/C/D/E/F aus cinematic-landing-page).
  • Bewegungssignaturen, Easing-Kurven, Scroll-Verhalten.
  • Farbstimmung, Typografie, Abstandsskala.
  • Medienbehandlung (Körnung, Unschärfe, Rahmung, Ausschnitte).
  • Technologie-Stack (V1 Vanilla vs. V2 React+Vite+Tailwind).
  • Mikrotext-Verfeinerung (solange intent-erhaltend).

Der Ersteller darf NICHT entscheiden

  • Anzahl der Abschnitte.
  • Reihenfolge der Abschnitte.
  • Welcher Slot welcher Position zugeordnet wird.
  • Ob ein Abschnitt überhaupt existiert.
  • Umbenennung des Zwecks eines Slots (benutzerseitiger Name kann sich ändern; JTBD nicht).
  • Hinzufügen von Abschnitten, die nicht im Blueprint sind (kein überraschender CTA-Banner, kein überraschender Newsletter-Block).
  • Entfernen des primären CTA oder Duplizieren.

Wenn der Ersteller der Meinung ist, dass das Blueprint falsch ist, muss es anhalten und eine Neuplanung anfordern, nicht stillschweigend mutieren.


3. LAYOUT-FAMILIE → VISUELLER ARCHETYP MAPPING

Der Planer spricht in Layout-Familien. Der Ersteller spricht in filmischen Archetypen (A–F). Dies ist die Übersetzungstabelle.

Layout-Familie (Planer)Primärer Archetyp (Ersteller)FallbackAnmerkungen
full-bleed heroA (Fixed-Viewport Hero)BGerahmte Leinwand-Variante, wenn Stimmung = Premium
split heroA (Muster: split)DLinks Text / rechts Medien
centered statementD-Abschnitt ODER A (zentriert)—Wenig Bewegung, hohe Lesbarkeit
benefit railD-Kartenreihe—3–4 Elemente, keine Karten schwerer als Icon+Titel+Zeile
card gridD-Grid—Max. 6 Kacheln; Hover-Animation bei I3 deaktivieren
staggered stackD-asymmetrischer AbschnittBAbwechselnde Bild-/Textzeilen
editorial blockD-redaktioneller BlockF (wenn Anzeigetyp)Langform; Karten-UI vermeiden
mood galleryB (Sticky-Scroll) oder E (Switcher)—Wählen nach Tempo: Slow-Burn→B, Ausgeglichen→E
logo stripD-ruhige Reihe—Keine Bewegung außer Laufband, falls angefordert
metric bandD-Großzahlen-Reihe—Count-Up-Animation nur, wenn Tempo ≠ Slow-Burn
quote panelD- oder A-Einzelszene—Ein Pull-Quote > Karussell
accordion listD-Akkordeon—Für I3 gesperrt (siehe Kill-Liste)
CTA bandD-zentrierter CTAAPrimärer CTA lebt hier
sticky footer CTAD-Sticky-Footer—Nur wenn Tempo = Fast
soft footerD-minimaler Footer—Ruhiger Ausgang am Seitenende

Archetyp-pro-Seite-Obergrenze.

  • Max. 2 Signatur-Archetypen pro Seite (geerbt von der cinematic-landing-page-Regel).
  • Der Hero-Abschnitt wählt den dominanten Archetyp. Andere Abschnitte verwenden standardmäßig die D-ähnliche Ausführung, es sei denn, die handoff_note des Planers fordert explizit eine filmische Behandlung für sie.

Intent-basierte Archetyp-Standardwerte (wenn der Planer keinen Hinweis gegeben hat):

IntentDominanter ArchetypZweiter Archetyp (optional)
I1 LaunchAE
I2 ConversionA (Split)— (ruhig bleiben)
I3 Brand EditorialF oder BE
I4 PortfolioF oder CB
I5 Product StoryA + B (Scroll-Story)—
I6 Campaign / TeaserA oder F—

4. BUILD SPEC – das Artefakt, das der Ersteller vor dem Codieren ausgibt

Bevor der Ersteller eine einzige Codezeile schreibt, MUSS er aus dem Blueprint einen Build Spec erstellen. Dies ist der zweite Vertrag in der Pipeline.

{
  "build_spec_version": "1.0",
  "blueprint_ref": "locked",
  "stack": "V1 vanilla | V2 react-vite-tailwind",
  "dominant_archetype": "A | B | C | D | E | F",
  "second_archetype": "A | B | C | D | E | F | null",
  "mood": "Dark Cinematic | Warm Editorial | Neo-Tech | Light Minimal | Light Editorial | Soft Glass",
  "sections": [
    {
      "index": 1,
      "slot": "S1",
      "layout_family": "full-bleed hero",
      "archetype": "A",
      "pattern": "framed-canvas",
      "motion": ["hero_fade_in_800ms", "subcopy_delay_200ms"],
      "media": {"type": "image | video | none", "asset_ref": "…"},
      "notes": "Warum dieser Archetyp für diesen Slot gewählt wurde"
    }
  ],
  "acceptance_criteria": [
    "Erster Viewport = nur S1-Komposition.",
    "Primärer CTA in S15 genau einmal.",
    "Keine benachbarten Abschnitte mit 'very high' Gewicht.",
    "Bewegungsanzahl auf der Seite <= 2 Signaturen."
  ]
}

Der Ersteller validiert den Build Spec gegen das Blueprint (siehe §6), BEVOR er codiert. Bei Fehlschlag wird geschlossen.


5. ÜBERSETZUNGSREGELN (Planer → Ersteller)

Angewendet in dieser Reihenfolge.

T1. Abschnittsreihenfolge ist Gesetz. sections[i].index im Blueprint = Position auf der Seite. Der Ersteller ordnet nie neu.

T2. Slot → Archetyp-Berechtigung. Tabelle §3 verwenden. Wenn eine Layout-Familie vorkommt, deren primärer Archetyp mit dem bereits für den Hero gewählten dominanten Archetyp kollidiert, den Fallback verwenden.

T3. Gewicht → Bewegungsbudget.

Visuelles GewichtBewegungsbudget
very highbis zu 2 Signaturinteraktionen
high1 Signaturinteraktion
mediumnur Mikrointeraktionen (Hover, kleine Einblendungen)
lownur Einblendungen
very lowstatisch

T4. CTA-Rolle → Oberflächenbehandlung.

CTA-RolleBehandlung
primaryvollständiger Button + Formular/Anker, hoher Kontrast
hardButton, hoher Kontrast, kein Formular
softTextlink mit Pfeil
nonekein CTA-Element gerendert

T5. Emotion → Stimmungs-Mapping (empfehlend).

primary_emotion (Planer)Vorgeschlagene Stimmung (Ersteller)
reverence, calm, luxuryDark Cinematic / Soft Glass
clarity, trust, precisionLight Minimal / Neo-Tech
warmth, human, storyWarm Editorial / Light Editorial
energy, urgency, hypeNeo-Tech / Dark Cinematic

T6. Tempo → Scroll-Länge.

TempoGesamter Scroll (Desktop)
fast≤ 2,5 Viewports
balanced3–5 Viewports
slow-burn5–8 Viewports

T7. Dichte → Komponentenwahl.

  • minimal → bevorzuge textbasierte Abschnitte, breite Leerräume.
  • balanced → gemischt Text + Medien.
  • rich → schwerpunktmäßig redaktionelle Blöcke; Kill-Liste dennoch beachten.

T8. Kill-Liste ist absolut. Alles in kill_list ist im Build Spec und im Code verboten, selbst wenn es "cool aussehen würde".


6. VALIDIERUNGS-GATE (vor jedem Code ausführen)

Der Ersteller führt diese Checkliste gegen den Build Spec aus. Alle müssen bestanden werden.

  • Jeder Blueprint-Abschnitt hat genau eine Zeile in build_spec.sections.
  • index-Werte sind aufeinanderfolgend, beginnend bei 1.
  • Kein Abschnitt hinzugefügt, entfernt, neu angeordnet oder zusammengeführt.
  • layout_family pro Zeile stimmt mit dem Blueprint überein.
  • Dominanter Archetyp wird vom Hero verwendet (index: 1).
  • Gesamtzahl der Signatur-Archetypen auf der Seite ≤ 2.
  • Summe der "Signaturinteraktionen" über alle Abschnitte ≤ 2.
  • Anzahl primärer CTAs = 1 (oder 0, falls Intent = I3 mit Soft-Footer-Abschluss).
  • Kein Element aus kill_list ist im Spec vorhanden.
  • Awareness-Gate eingehalten: cold ⇒ S2 existiert direkt nach S1.
  • Keine verbotene Nachbarschaft (S6+S9, S11+S13, usw.).

Fehlschlag → Mit einem revision_request zum Planer zurückkehren (siehe §7). Codieren Sie NICHT um ein fehlgeschlagenes Gate herum.


7. REVISIONS-PROTOKOLL

Wenn der Ersteller zurückweisen muss, gibt er eine strukturierte Anfrage aus, keinen freien Text:

{
  "revision_request": {
    "reason": "layout_conflict | asset_missing | motion_budget_exceeded | kill_list_impossible | adjacency_violation",
    "affected_sections": [3, 4],
    "explanation": "ein kurzer Absatz",
    "suggested_fix": "Reihenfolge von S6 und S9 tauschen | S13 entfernen | Gewicht von S1 auf high herabstufen"
  }
}

Der Planer antwortet mit einem neuen gesperrten Blueprint, nicht mit einem Patch-Notiz. Blueprints werden vollständig neu ausgestellt, versioniert durch Erhöhung von blueprint_version.


8. FEHLERMODI, DIE BEIDE SEITEN ABLEHNEN MÜSSEN

Der Planer muss ablehnen:

  • Ein entsperrtes Blueprint auszugeben.
  • Weniger als 4 oder mehr als 9 Abschnitte auszugeben.
  • Einen Slot mit content_required aufzunehmen, den der Benutzer nicht liefern kann.
  • Eine Slot-ID wiederzuverwenden.
  • S1 oder (normalerweise) S15 zu überspringen.
  • Eine Layout-Familie außerhalb der geschlossenen Liste in §3 zu wählen.

Der Ersteller muss ablehnen:

  • Ohne ein gesperrtes Blueprint zu codieren.
  • Ohne einen Build Spec zu codieren, der §6 bestanden hat.
  • Einen Abschnitt hinzuzufügen, "weil die Seite sich leer anfühlte".
  • Einen Abschnitt zu entfernen, "weil er sich redundant anfühlte".
  • Mehr als 2 Signatur-Archetypen zu verwenden.
  • Die Kill-Liste zu ignorieren.
  • Still den primary CTA auf soft herabzustufen.

Wenn ein Benutzer direkt eine Verletzung verlangt, antworten Sie einmalig mit dem Kompromiss und kommen Sie der Aufforderung nur nach, wenn er es explizit bestätigt – und vermerken Sie es im Build Spec als "user_override": true in der betroffenen Zeile.


9. MINIMALES ENDE-ZU-ENDE-BEISPIEL

Blueprint (Planer-Ausgabe, gekürzt)

  • Intent: I2 Conversion, cold, ads, ausgeglichenes Tempo, ausgeglichene Dichte.
  • Abschnitte: S1 → S2 → S4 → S5 → S6 → S12 → S13 → S15
  • Kill-Liste: kein S8, kein S9, kein S14, kein S11.
  • Primäre Emotion: clarity.

Build Spec (Ersteller-Ausgabe, gekürzt)

  • Stack: V2 (React + Vite + Tailwind + framer-motion).
  • Dominanter Archetyp: A (Split Hero). Zweiter Archetyp: keiner.
  • Stimmung: Light Minimal.
  • Genutztes Bewegungsbudget: 2 / 2 (Hero-Split-Enthüllung + Metrik-Count-up).
  • S1 = A Split Hero. S2 = D zentrierte Aussage. S4 = D redaktioneller Block. S5 = D gestaffelter Stack. S6 = D-Karten-Grid (4 Kacheln). S12 = D-Metrikleiste. S13 = D-Zitat-Panel (einzelnes Pull-Quote). S15 = D-CTA-Band mit Formular.
  • Abnahme: primärer CTA einmal (S15); keine S6/S9-Nachbarschaft; gesamter Scroll ≈ 4 Viewports.

Validierung

Alle §6-Prüfungen bestanden. Der Ersteller fährt mit dem Codieren fort.


10. WAS DEM BENUTZER GESAGT WIRD (Skript-Ausschnitte)

Bei Übergabe vom Planer:

"Blueprint đã khóa. Chuyển sang skill build (cinematic-landing-page)? Skill đó sẽ chọn archetype visual + motion + code, không đổi thứ tự section."

Wenn der Ersteller ein Blueprint ablehnt:

"Blueprint này có xung đột ở section {n} — {lý do}. Mình gửi lại planner để phát hành bản mới, thay vì tự sửa."

Wenn der Benutzer auf Überschreibung drängt:

"Nếu ép làm vậy, mình sẽ đánh dấu user_override: true ở section đó. Trang vẫn build được, nhưng rhythm rule bị phá — bạn xác nhận?"


Ende des Integrationsvertrags.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills