Landing Build
Wandle die genehmigten Texte, die visuelle Ausrichtung und die Design-Tokens in eine statische Seite um, die auch ohne JavaScript voll funktionsfähig ist. Voll funktionsfähig bedeutet, dass ein Besucher jeden Abschnitt lesen, jeden Abschnitt über die Kopfzeile erreichen und das Formular absenden kann. Bewegungen und 3D kommen später, von landing-skills:landing-motion, und bauen auf einer bereits funktionierenden Seite auf.
Zwei Fehler traten in mehreren Testbauten auf, die ohne dieses Skill erstellt wurden. Dieses Skill ist so gestaltet, dass beide unmöglich werden:
- Eine Container-Klasse mit einer
padding-Kurzschreibweise überschrieb den vertikalen Abstand der Sektion, sodass jede Sektion direkt an die nächste anschloss. Der Fix ist strukturell: Die Sektion besitzt die Blockachse, der Container die Inline-Achse, und keiner verwendet die Kurzschreibweise (Schritt 5). - Ein totes Formular:
action="#",onsubmit="return false"oder ein Skript, das "Danke" anzeigte und die Daten wegwarf. Der Fix: eine echteaction, eine echtemethod, eine serverseitige Erfolgsseite und keine Erfolgsmeldung, die die Seite nicht bestätigen kann (Schritt 8).
Eingaben
Lies diese vor dem Schreiben von Code aus dem Projekt des Benutzers.
| Datei | Was du daraus nimmst |
|---|---|---|
| landing/brief.md | Die Felder, die landing-skills:landing-page schreibt. Du verwendest: Sprache (für lang); Conversion-Aktion (entweder ein Formular mit seinen Feldern und seinem Endpunkt oder none yet, oder eine externe URL); Stack (wie benannt, oder detect); Domain (die Produktionsdomain, oder unknown); Kontaktwege (für die Fußzeile und /form-error/); Verfügbare Assets |
| landing/copy.md | Eine H2 pro Seitenabschnitt in Seitenreihenfolge; die letzte H2, Placeholders, listet jede Lücke auf |
| landing/direction.md | Schriftarten mit Quelle und Lizenz, das Layout-Row für jeden Abschnitt, Bildmaterial mit Seitenverhältnissen, Oberflächen und die letzte H2 Motion and 3D intent |
| landing/tokens.css | Die benutzerdefinierten Eigenschaften: --color-*, --font-*, --text-*, --space-*, --radius-* |
Wenn eine Eingabe fehlt:
- Keine
copy.md: Schreibe keine Marketingtexte selbst. Frage den Benutzer nach dem Text oder schlagelanding-skills:landing-copyvor. Wenn der Benutzer dir Text gibt, verwende ihn wie geschrieben. Erfinde niemals Beweise: keine Testimonials, Logos, Zählungen oder Bewertungen. Ein fehlendes Stück wird zu[PLATZHALTER: was wird benötigt]. - Keine
direction.mdodertokens.css: Schlage zuerstlanding-skills:landing-art-directionvor. Wenn der Benutzer ohne fortfahren möchte, schreibelanding/tokens.cssselbst mit den fünf Präfixen, leite die Werte aus den Markenbeschränkungen ab, die der Benutzer angibt, und teile dem Benutzer mit, dass diese Tokens vorläufig sind. - Keine
brief.md: Frage nach der Sprache, der Conversion-Aktion (ein Formular und wohin es posten soll, oder eine externe URL), der Produktionsdomain und einem Kontaktweg. - Ein Brief-Feld, das
unknownodernone yetsagt, ist eine Lücke, kein Fehler: Baue mit der Regel, die dieses Skill dafür vorgibt (keine URL-Tags ohne Domain, der/api/lead-Platzhalter ohne Endpunkt, eine Platzhalter-Kontaktzeile ohne Kontaktwege) und liste es in der Übergabe auf. Erkenne das Stack aus den Projektdateien (siehe "Stack-Erkennung"), anstatt zu fragen, wenn du kannst.
Prozess
1. Erkenne das Stack
Verwende die Tabelle in "Stack-Erkennung". Lies den entsprechenden Abschnitt von references/adapters.md, bevor du Dateien schreibst; er behandelt nur, was von den einfachen Rezepten in den anderen Referenzen abweicht.
2. Erstelle ein Inventar
Schreibe vor jeglichem Markup auf:
- Jede H2 der
copy.mdund welches<section>sie wird, mit ihrerid. - Jeden Token-Namen in
tokens.css. Du wirst diese Namen und keine anderen für Farbe, Schriftart, Abstand und Radius verwenden. - Jedes Bild, das die Direction verlangt, sein Seitenverhältnis und ob die Datei existiert.
- Die Conversion-Aktion aus dem Brief: eine externe URL (ein Link, kein Formular) oder ein Formular mit seinen Feldern und seinem Endpunkt. Mit dem Endpunkt
none yetpostet das Formular an/api/leadund diese Lücke wird in der Übergabe vermerkt (Schritt 11). - Die Domain (bekannt oder
unknown) und die Kontaktwege, die der Kopf, die Fußzeile und/form-error/benötigen.
3. Schreibe den Kopf
Titel, Beschreibung, Canonical, Open Graph und Social Card, Favicon-Set, theme-color, lang, strukturierte Daten. Vorlagen und Regeln sind in references/seo-meta.md. Schreibe Titel und Beschreibung aus copy.md; ein Standardtitel wie der Starter-Titel des Frameworks ist ein verräterisches Zeichen.
4. Lade die Schriftarten
Hoste die in der Direction genannten WOFF2-Dateien selbst, deklariere @font-face mit Familiennamen, die exakt mit den Stapeln in tokens.css übereinstimmen, füge einen metrisch passenden Fallback hinzu und lade nur die ein oder zwei Dateien vor, die oberhalb der Falte verwendet werden. references/performance.md enthält das Rezept und ein getestetes Skript, das die Fallback-Werte berechnet. Eine Seite, die eine Schriftart nennt und sie nie lädt oder auf system-ui zurückfällt, rendert auf jedem Rechner anders.
5. Baue das Layout-Skelett
Jeder Streifen der Seite ist ein <section class="section"> mit einem <div class="container"> darin. Die beiden teilen sich nie eine Aufgabe:
/* Die Sektion besitzt den vertikalen Rhythmus, der Container besitzt Breite und Ränder. */
.section { padding-block: var(--space-section-open); }
.container {
inline-size: min(100% - 2 * var(--space-gutter), var(--space-content-max));
margin-inline: auto;
}
Die obigen Token-Namen sind Beispiele; verwende die Namen in deiner tokens.css. references/css.md listet jede Token-Rolle auf, die die Rezepte annehmen, und was zu tun ist, wenn deine Datei keinen Token dafür hat. Der Container setzt überhaupt kein Padding, sodass keine Regelreihenfolge oder Spezifität den Abstand der Sektion löschen kann. Verwende niemals die padding- oder margin-Kurzschreibweise für eine Sektions- oder Container-Klasse: Eine Kurzschreibweise setzt beide Achsen und ersetzt stillschweigend diejenige, die die andere Klasse gesetzt hat. Das ist die Regel, die Fehler 1 beseitigt. references/css.md zeigt die fehlerhafte Version neben dieser sowie die Fälle für Full-Bleed und Hairline.
6. Baue die Sektionen
- Verwende semantische Elemente:
header,nav,main,section,footer,olfür Schritte,dlodertablefür Spezifikationen,figurefür Medien mit einer Bildunterschrift. - Eine
h1, im Hero. Jede Sektion beginnt mit einerh2auscopy.md. Überspringe keine Ebenen. - Lege jede Sektion so aus, wie ihr Row in
direction.mdes sagt. Wenn die Direction die Form offen lässt, wähle aus den Rezepten inreferences/css.md; Anzahl und Form der Blöcke folgen dem Inhalt, also erscheinen drei gleiche Karten nur, wenn der Inhalt drei gleiche Dinge sind. - Verwende die Tokens für jede Farbe, Schriftart, Größe, Abstand und Radius. Deklariere niemals einen Token im Seiten-CSS neu. Wenn ein benötigter Wert keinen Token hat, setze ihn aus Tokens zusammen (
calc(),color-mix()) und liste ihn in der Übergabe, damit die Direction ihn hinzufügen kann. - Verwende fließende Größen mit
clamp(), logischen Eigenschaften,oklch()-Farbe mit den Fallbacks inreferences/css.mdund Container-Queries für Komponenten, die ihre Form mit ihrer eigenen Breite ändern.
7. Platziere die Medien
Echte Bilder erhalten width und height, alt-Text, der sagt, was darauf zu sehen ist, moderne Formate mit einem Fallback, und fetchpriority="high" nur auf dem Hero-Bild (references/performance.md). Ein Asset, das noch nicht existiert, wird zu einem sichtbaren, beschrifteten Platzhalterfeld mit dem endgültigen Seitenverhältnis, mit Text wie [PLATZHALTER: Foto, die Werkbank von oben, 3:2]. Gib dem Feld kein role="img": Es würde ein Foto ankündigen, das nicht existiert. Gib jedem Platzhalter das Verhältnis, die Breite und den Grund, den die Direction diesem Bild gibt, damit die Rahmen das geplante Layout zeigen und nicht eine Reihe identischer gestrichelter Kästchen (references/css.md, Medienplatzhalter). Zeichne niemals einen gefälschten Produktbildschirm und präsentiere ihn als das Produkt.
8. Baue die Conversion-Aktion
Die Conversion-Aktion des Briefs entscheidet, was du baust:
- Eine externe URL (Checkout, Buchungsseite, App Store): Die Aktion ist ein Link,
<a class="button" href="https://...">mit dem Label auscopy.md. Es gibt kein Formular, keineform.jsund keine/thanks/- oder/form-error/-Seite; überspringe den Rest dieses Schritts. Wenn der Brief sagt, dass der Klick gezählt werden soll, fügtlanding-skills:landing-launchden Beacon hinzu. - Ein Formular mit einem Endpunkt, den der Benutzer bereits hat: Das Formular postet an diese URL und der
/api/lead-Platzhalter wird nicht verwendet. Baue die Ergebnis-Seiten nur, wenn dieser Endpunkt dorthin weiterleitet; sage andernfalls in der Übergabe, wohin der Endpunkt den Besucher sendet. - Ein Formular mit dem Endpunkt
none yet: Das Formular postet an den Platzhalter/api/lead, denlanding-skills:landing-launchals Worker baut.
Für ein Formular lies references/forms-a11y.md. Die nicht verhandelbaren Teile:
<form action="..." method="post">mit dem Endpunkt aus dem Brief oderaction="/api/lead"mit einem HTML-Kommentar daneben, der besagt, dass der Endpunkt noch nicht existiert, aufgeführt in der Übergabe.- Jedes Feld hat einen
name, ein sichtbares<label>, den richtigentypeundautocompleteund einen Hinweis, der mitaria-describedbyverknüpft ist, wenn das Format erklärt werden muss. - Ohne JavaScript sendet der Browser das Formular und der Endpunkt antwortet mit einer
303-Weiterleitung auf eine von zwei statischen Seiten, die du jetzt baust:/thanks/und/form-error/. Sobaldlanding-skills:landing-launchTurnstile hinzufügt, hat ein Besucher ohne JavaScript kein Token und landet immer auf/form-error/, daher muss diese Seite eine andere Kontaktmöglichkeit bieten, die aus den Kontaktwegen des Briefs stammt. - Liefere immer
form.jsausreferences/forms-a11y.mdals progressive Verbesserung aus. Das Formular funktioniert auch ohne; die Datei ist dennoch Teil des Builds, weillanding-skills:landing-motiondie Zustände erweitert, die sie setzt, undlanding-skills:landing-launchsie überprüft. Es zeigt Erfolg nur an, wenn die Antwort ein 2xx-Status ist und ihr JSON-Bodyok: truesagt. Ein 2xx-Status allein beweist nur, dass etwas geantwortet hat:fetchfolgt einer Weiterleitung und meldet die Seite, auf der es landet, als 200, und ein statischer Host kann auf einen POST mit einer gewöhnlichen HTML-Seite antworten. Beides ist beim Testen passiert, und beides sind Fehler. Bei einem Fehler sagt das Skript dies und behält, was der Besucher eingegeben hat. Setze das Formular niemals zurück oder zeige "Danke", bevor der Server bestätigt hat.
9. Erreiche das Mindestmaß an Barrierefreiheit
Skip-Link, Landmarken, ein nav, dessen Links auf echte Sektions-IDs verweisen, das Logo, das auf / verlinkt, ein sichtbarer Fokus-Stil auf jedem interaktiven Element, Ziele von mindestens 44 mal 44 px und eine Kontrastprüfung jedes Text- und Hintergrundpaars, das die Seite tatsächlich rendert: Fließtext auf jeder Oberfläche, Bildunterschriften, Hinweise, Platzhaltertext, Text auf der Akzentfarbe. Details und Zahlen sind in references/forms-a11y.md. Eine Navigation, die ihre Links auf dem Handy ohne Ersatz verbirgt, besteht dieses Mindestmaß nicht; lass die Links stattdessen umbrechen.
10. Lass Bewegungen weg
Bei reduzierter Bewegung wird die Bewegung reduziert, niemals das Feedback. Schreibe daher keine globale Regel, die Übergänge auf null setzt. Baue jedes Element in seinem endgültigen, sichtbaren Zustand. Keine Eingangsanimationen, kein opacity: 0, das auf ein Skript wartet, keine Scroll-Bibliotheken.
Für jeden Moment, der in der Motion and 3D intent der Direction genannt wird, hinterlasse einen Platzhalter: ein Standbild oder einen beschrifteten Platzhalter in der endgültigen Größe und dem endgültigen Seitenverhältnis des Moments, damit sich das Layout nicht verschiebt, wenn landing-skills:landing-motion das Echte montiert. Markiere es mit data-moment="<name>" und verwende den Kurznamen, den die Direction diesem Moment gibt; die Bewegung findet ihr Ziel über dieses Attribut. Der Platzhalter ist ohne Bewegung vollständig: ein echtes Bild mit alt-Text oder Platzhaltertext, der sagt, was der Moment zeigt.
<div class="hero__media" data-moment="exploded-view">
<img src="/img/exploded-poster.jpg" width="1600" height="1000" alt="Die Schichten des Geräts auseinandergezogen: Gehäuse, Platine, Akku, Linse">
</div>
Wenn die Absicht none ist, füge keine data-moment-Elemente hinzu.
11. Überprüfe und übergib
Führe die "Definition of done" aus. Teile dem Benutzer dann in einer kurzen Liste mit:
- was gebaut wurde und wo (Dateien, Ausgabeordner) und das aufgelöste Stack, das in das Stack-Feld des Briefs geschrieben wurde, wenn es
detectsagte, - jeden
[PLATZHALTER: ...], der noch auf der Seite ist, und jedes Asset, das bereitgestellt werden muss, - die gebaute Conversion-Aktion: ein Link zu einer externen URL, ein Formular, das an den Endpunkt des Benutzers postet, oder ein Formular, das an
/api/leadpostet, das noch nicht existiert, - jedes Feld, das das Formular sendet, eine Zeile pro Feld: sein
name, sein Typ (email,tel,text,textarea), ob esrequiredist, und seinmaxlengthaus dem Markup.landing-skills:landing-launchrichtet die Validierung seines Workers, die Längenbegrenzungen, die Speicherung und das Größenlimit für Anfragen anhand dieser Liste ein und weist ein Feld zurück, von dem es nicht wusste, - Werte, die zusammengesetzt wurden, weil kein Token existierte, und jeden optionalen Token, den
tokens.cssnicht hatte, mit dem Fallback, den die Rezepte dafür verwendet haben, - die Produktionsdomain, wenn der Brief
unknownsagt, und die URL-Tags, die deswegen weggelassen wurden (Canonical,og:url,og:image, Sitemap), - Kontaktwege, die der Brief als
unknownhinterlassen hat und die die Fußzeile und/form-error/als Platzhalter anzeigen, - jede Schriftartdatei, die nicht subsetiert wurde, mit ihrer Größe in Bytes,
- jede Überprüfung der Definition of done, die nicht ausgeführt wurde, markiert als "nicht ausgeführt" mit dem Grund,
- jeden Moment aus
Motion and 3D intent: seinendata-moment-Namen und wo sein Platzhalter sitzt (Sektion und Element), oder "none", wenn die Absichtnoneist, - das nächste Skill:
landing-skills:landing-motion, wenn dieMotion and 3D intentder Direction einen Moment nennt, dannlanding-skills:landing-review, dannlanding-skills:landing-launchfür Hosting und den Formular-Endpunkt.
Stack-Erkennung
Überprüfe das Projekt-Root in dieser Reihenfolge und stoppe bei der ersten Übereinstimmung. Das Feld Stack in brief.md entscheidet, wenn der Projektordner leer ist.
Sobald das Stack aufgelöst ist, schreibe es zurück: Wenn das Stack-Feld des Briefs detect sagt, ersetze dieses eine Wort durch das aufgelöste Stack (z. B. Astro oder einfaches HTML und CSS) und ändere nichts anderes in landing/brief.md. Spätere Skills lesen das Feld und sollten kein unaufgelöstes Wort antreffen. Ein Stack, das der Benutzer genannt hat, bleibt wie geschrieben stehen. Wenn es keine landing/brief.md gibt, erstelle keine.
| Signal im Projekt | Stack | Adapter-Abschnitt |
|---|---|---|
astro.config.mjs (oder .ts, .js) oder astro in package.json-Abhängigkeiten | Astro | Astro |
next.config.js (oder .mjs) oder next in package.json-Abhängigkeiten | Next.js | Next.js |
vite.config.js (oder .ts) und react in package.json-Abhängigkeiten und KEIN next | Vite + React | Vite + React |
package.json mit tailwindcss in devDependencies und eine tailwind.config.*-Datei | Tailwind CSS (als Zusatz) | Wie das Basis-Stack, befolge die Referenzen mit Tailwind-Integration |
| Keine der obigen, aber Projektdateien vorhanden | Einfaches HTML und CSS (kein Framework) | (Keine; die Hauptreferenzen gelten direkt) |
| Keine Projektdateien gefunden oder Ordner leer | detect (kann nicht auflösen) | Frage den Benutzer nach dem Stack oder schlage plain HTML and CSS vor |
Definition of done
Führe jede Prüfung aus, die durchführbar ist. Prüfungen, die eine Live-Umgebung oder Assets erfordern, die es noch nicht gibt, werden in der Übergabe als "nicht ausgeführt" markiert.
- Wird das Dokument ohne JavaScript gerendert? Die Seite zeigt alle Abschnitte, die Navigation funktioniert, das Formular sendet.
- Gibt es genau eine
h1? - Enthält jede Sektion eine
h2auscopy.md? - Sind alle Sektions-IDs eindeutig?
- Entspricht die Seitenreihenfolge der Reihenfolge in
copy.md? - Haben alle
<a>-Tags einhref-Attribut? - Haben alle
<img>-Tagswidth,heightundalt(nicht leer)? - Verwenden alle Farben, Schriftarten, Abstände und Radien Token aus
tokens.css? - Hat die Seite ein Favicon?
- Sind
lang,charsetundviewportgesetzt? - Gibt es ein sichtbares Skip-Link in der Kopfzeile?
- Erreicht jedes interaktive Element mindestens 44x44 px?
- Besteht jedes Text-Hintergrund-Paar den Kontrast-Check (WCAG AA)?
- Ist die
oklch()-Farbe mit einem Fallback abgesichert? - Hat die Sektion
padding-blockund der Container wederpadding- nochmargin-Kurzschreibweise? - Wird
fetchpriority="high"nur auf dem Hero-Bild gesetzt? - Haben Formularfelder alle
name,label,typeundautocomplete? - Wird das Formular bei nicht unterstütztem JavaScript per POST gesendet und die Antwort per 303 weitergeleitet?
- Hat
/form-error/eine alternative Kontaktmöglichkeit? - Wird keine
opacity: 0- oder Übergangsregel auf den Standard-CSS-Pfad angewendet? - Ist jedes
data-moment-Element ein vollständiger, bewegungsloser Platzhalter?
