Was macht webbuild?
Erstelle Websites, für die ein Geschäftsinhaber bezahlen würde: spezifisch für ihn, schnell auf dem Handy, ein unvergesslicher Moment und nichts, das nach „das hat eine KI gemacht“ schreit. Die Handwerkskunst liegt größtenteils in den Entscheidungen vor dem Code und im ehrlichen Betrachten des Ergebnisses danach.
Die Pfade unten sind relativ zum Ordner dieser Skill (scripts/, references/, assets/).
0. Projekt einrichten (2 Min.)
- Neue Website → Kopiere
assets/starter/in den Projektordner (reines HTML + CSS + ES-Module, feste CDN-Importe, kein Build-Schritt: überall bereitstellbar, einfach zu bearbeiten). Verwende Next.js / Astro / R3F nur, wenn der Benutzer danach fragt oder das Projekt sie bereits verwendet (references/3d-playbook.md§5). - Bestehendes Projekt → Behalte dessen Framework, Tokens und Komponenten; diese Skill fügt Richtung, Bewegung und Qualitätssicherung hinzu, keine Neuschreibung.
- Erstelle
BUILD_NOTES.mdim Projekt. Es ist das Gedächtnis über Kontext-Resets hinweg: Kurzbeschreibung, Entscheidungen, offene Fragen, Korrekturen, die funktioniert haben.
1. Briefing – das echte Geschäft verstehen
Sammle (vom Benutzer, von der aktuellen Website des Unternehmens, vom Google Business-Profil, von Instagram): Name, was sie verkaufen, wo, seit wann, die eine primäre Aktion (Anruf / Buchung / Bestellung / Angebot / Besuch), echte Beweise (Bewertung + Anzahl, Jahre, Lizenzen, Presse), echte Fotos, Logo/Farben, Öffnungszeiten, Adresse, Telefon. Schreibe das 5-zeilige Briefing aus references/design-system.md §2 in die BUILD_NOTES.md.
Erfinde niemals Fakten – erfundene Bewertungen, Statistiken, Preise oder Adressen in einem Pitch zerstören das Vertrauen, sobald der Eigentümer sie liest. Stattdessen:
- Schreibe um Unbekanntes herum, sodass die Demo trotzdem fertig aussieht: „Koregaon Park, Pune“ anstelle einer erfundenen Hausnummer; „Bewertet mit 4,7 auf Google“ anstelle erfundener Zitate; Dienstleistungsnamen ohne Preise oder „ab ₹…“ nur, wenn bekannt.
- Wo eine Tatsache zwingend erforderlich ist (Telefon, genaue Adresse, Öffnungszeiten), verwende einen sichtbaren
{{Platzhalter}}–slop_check.pyblockiert die Auslieferung, bis es ausgefüllt ist. - Setze jede Unbekannte und Annahme auf eine „Fragen Sie den Kunden“-Liste für den Abschlussbericht.
Für eine Creator- oder Channel-Website frage (oder ziehe) die Dashboard-Zahlen und das Profilbild im Voraus: YouTube Studio / Instagram Insights Screenshots sowie vidIQ oder ähnliches, falls verbunden. Ein aus echten Zahlen aufgebauter Abschnitt „Ergebnisse“ ist der Verkaufsfaktor.
Wenn das Briefing dünn ist und der Benutzer in der Nähe ist, stelle maximal 3 Fragen (Unternehmen + Stadt, primäre Aktion, eine Website, die sie lieben). Wenn sie wollen, dass du einfach loslegst, triff vernünftige Annahmen, schreibe sie auf und mach weiter.
2. Referenz (wenn der Benutzer eine Website nennt, eine Aufnahme sendet oder einen „Neubau“ möchte)
Folge references/reverse-engineer.md: node scripts/teardown.mjs <url> misst den Stack, die Schriften, die Palette, Medien und Shader-Nachweise und macht Screenshots des Scrollens; Bildschirmaufnahmen werden zu Frames, die du liest und in eine detaillierte Bewegungsvorgabe umwandelst. Wenn dieser schnelle Durchlauf einen Effekt nicht erklären kann, gehe mit der REA-Engine tiefer: scripts/rea-teardown.sh <url> erfasst die Seite, nimmt Fingerabdrücke des Bundles und exportiert jedes Skript, damit du lesen kannst, wie es tatsächlich gebaut ist (Anleitungen in references/rea/). Dokumentiere BEOBACHTET → SCHLUSSFOLGERUNG → ENTSCHEIDUNG. Lerne die Technik; kopiere niemals Marke, Kopie, Assets oder Code.
3. Richtung – plane, dann greife den Plan an
Lies references/design-system.md (die Anti-Slop-Regeln – klassisch und die neueren „geschmackvollen KI“-Anzeichen wie Creme + Terrakotta, GROSSBUCHSTABEN-Augenbrauen, editoriale Haarlinien). Schreibe in BUILD_NOTES.md:
- 4–6 benannte Farb-Tokens, die vom Unternehmen stammen, Typ-Kombination + Rollen, Radius-Sprache
- ASCII-Drahtmodell jedes Abschnitts (variiere den Rhythmus – kein Held → 3 Karten → Logos → Testimonials)
- den Signature-Moment (genau einen) und warum er zu diesem Unternehmen passt
- 3 Prinzipien, die es unverwechselbar machen
Überprüfe dann den Plan anhand der Erkennungsliste und rechtfertige für jede Wahl, die wie ein Standardwert wirkt, warum sie für dieses Unternehmen richtig ist, oder ändere sie. Die Frage „Könnte diese Website einem anderen Unternehmen gehören, wenn ich das Logo austausche?“ fängt die meisten Probleme hier, wo sie billig zu beheben sind.
Für eine unentschlossene Richtung, die der Benutzer wählen möchte, zeige 2–3 wirklich unterschiedliche Richtungen (jeweils ein Standbild oder eine kurze HTML-Skizze), bevor du baust – 21st-ui-explore kann helfen, wenn es installiert ist.
4. Hero-Bereich – wähle den Modus, der dem Unternehmen dient
references/3d-playbook.md §1 enthält die Entscheidungstabelle. Kurzfassung:
- Standbild (gutes Foto / Typografie) – Restaurants, Lebensmittel, Salons, Kliniken, Dienstleistungen. Oft die richtige Wahl.
- Video – Atmosphären-Schleife, idealerweise bearbeitet mit
assets/starter/grade.js, damit KI-/Stock-Filmmaterial eine maßgeschneiderte Gradierung erhält (Korn, Halation, Lift/Gamma/Gain, Vignette). Wähle einen LOOK und halte ihn subtil. - Frames – die „10.000-Dollar-3D-Website“: KI-Start-/End-Keyframes → Video des ersten/letzten Frames →
scripts/frames.sh→ Canvas, das durch Scrollen abgetastet wird. Liesreferences/scroll-video-playbook.mdfür die Keyframe-Regeln, Prompts und das Blending. - Szene – live Three.js / R3F, wenn 3D die Produktgeschichte ist (konfigurierbares Produkt, Architektur, Technik). Das Objekt muss die Sache des Unternehmens sein, niemals der Platzhalter-Knoten.
- Ganze Seite – wenn der Eigentümer nach einer „3D-Website“ fragt, meint er normalerweise 3D durchgängig, nicht nur einen 3D-Hero. Verwende eine feste Szene mit einer Kamerastation pro Abschnitt (
references/3d-playbook.md§6).
Generiere Assets mit dem, was verbunden ist (Higgsfield / Kling / kie.ai / Nano Banana MCPs oder Skills), oder bitte den Benutzer, Dateien abzulegen. Wenn nichts verfügbar ist, baue mit einem klar gekennzeichneten Platzhalter und liste genau auf, welches Asset mit welchem Prompt generiert werden soll.
5. Bauen
Reihenfolge: Tokens (styles.css :root) → semantische HTML-Abschnitte mit echtem Text → Layout bei 390px und 1440px → Hero-Modus → Bewegung zuletzt.
- Textregeln:
references/design-system.md§8 (Ergebnis + Ort + Details, echte CTA-Verben, verbotene Wörter). - Erforderlich für eine Business-Website: ein offensichtlicher CTA oberhalb der Falz und noch einmal am Ende,
tel:/ Buchung / Formular, Öffnungszeiten + Adresse + Kartenlink, echte Beweise, Titel + Beschreibung + OG-Bild, LocalBusiness-JSON-LD, Favicon, sticky Call/Book-Leiste auf Mobilgeräten, wenn die Aktion ein Anruf ist. - Bewegung: ein Signature-Moment + leises 150–300 ms Micro-Feedback; ease-out, niemals bounce; nur
transform/opacity; reduced-motion zeigt Endzustände. - Komponenten: Suche in
references/resources.md-Registern (21st.dev, React Bits, Aceternity, Motion Primitives…), bevor du komplexe Effekte von Hand schreibst, und style sie dann auf die Tokens um. Erstelle in einer statischen Website React-Komponenten in Vanilla neu, anstatt React für einen Effekt hinzuzufügen. - Footer: Baue ihn nach
references/design-system.md§11 (Markenblock, Linkspalten mit Plattformlogos, Kontakttasten, überdimensionales Wortmarken, untere Reihe). Eigentümer beurteilen die gesamte Website danach. Der kleine Builder-Hinweis ist bereits im Starter enthalten; der Kunde kann um Entfernung bitten. - Buttons und Scroll: Folge
references/design-system.md§12 (taktile 0,16 s Buttons, Cursor-Ring viacursor.jsdes Starters, keine native Scrollleiste:blockbar.jsdes Starters ersetzt sie). - Bevor du es als erledigt bezeichnest, lies noch einmal
references/design-system.md§10: die Dinge, die Eigentümer immer noch als „Slop“ bezeichnen, nachdem alle Regeln bestanden wurden.
6. Anschauen – hier entstehen gute Websites
Lokal bereitstellen (npx serve . oder den Dev-Server des Projekts), dann:
node scripts/shoot.mjs http://localhost:3000 ./shots– Handy / Laptop / Desktop Screenshots während des Scrollens + Konsolenfehler, Überläufe, LCP, Gewicht. Lies die PNGs. (Oder verwende den Browser-Bereich / Playwright MCP, falls verfügbar.) Führe es auch einmal mit--reduced-motionaus.python3 scripts/slop_check.py .– muss mit 0 FAIL enden. Behandle WARNs als Fragen. (npx impeccable detectist eine gute zweite Meinung, falls installiert.)- Kritisiere ehrlich anhand des Briefings: Hierarchie, Typografie, Farbe, der Signature-Moment, Mobilversion, Spezifität des Textes. Korrigiere in Chargen mit klarer Absicht („Untere Abschnitte wirken generisch – mach sie teurer, nicht überladener“).
- Entferne ein dekoratives Element, bevor du es als erledigt bezeichnest.
Erwarte 3–6 Runden; niemand schafft das auf Anhieb. Dokumentiere, was was behoben hat, in BUILD_NOTES.md.
7. Ausliefern + Pitchen
- Bereitstellen: Vercel / Netlify / Cloudflare Pages / GitHub Pages. Commite den Frames-Ordner (der häufigste Grund, warum der Hero in der Produktion verschwindet). Füge
<meta name="robots" content="noindex">zu spezifischen Demos hinzu, bis der Kunde kauft. - Wenn es ein Pitch ist, lies
references/pitch-and-sell.md: Vorher/Nachher-Video, Outreach-Skripte, Preisanker, die pitchbereite Checkliste, Übergabe.
Abschlussbericht an den Benutzer
Halte es kurz und konkret:
- Was gebaut wurde (Richtung in einem Satz, Signature-Moment, Hero-Modus) und wo (Pfade, URL)
- Wie man es ausführt (
npx serve .oder der Dev-Befehl) - QA-Ergebnisse: slop_check FAIL/WARN-Anzahl, shoot.mjs LCP / Fehler pro Viewport, was du angesehen und behoben hast
- Fragen Sie den Kunden-Liste: jeder
{{Platzhalter}}und jede Annahme - Noch zu generierende Assets (mit gebrauchsfertigen Prompts), falls vorhanden
Referenzkarte
| Lesen | Wann |
|---|---|
references/design-system.md | Immer, vor der Wahl von Farbe/Schrift/Layout/Text |
references/3d-playbook.md | Bei der Wahl des Hero-Bereichs; Three.js/R3F; Performance + a11y-Budget |
references/scroll-video-playbook.md | Scrollgesteuerter „3D“-Hero aus KI-Video |
references/reverse-engineer.md | Eine Referenz-Website, eine Aufnahme oder Neubau einer potenziellen Kundenwebsite |
references/rea/README.md | Tiefer gehen als teardown.mjs mit REA-Werkzeugen |
references/resources.md | Komponentenregister, Effektwerkzeuge, Inspiration, Begleit-Skills |
references/pitch-and-sell.md | Spezifikationsseite für einen Interessenten, Preisgestaltung, Kontaktaufnahme, Übergabe |
| Skript | Funktion |
|---|---|
scripts/teardown.mjs <url> | Eine Referenzseite vermessen (Stack, Schriften, Palette, Medien, Shader, Screenshots) |
scripts/rea-teardown.sh <url> | Tiefenanalyse mit REAs Engine: Seitenaufnahme, Fingerabdrücke des Bundles, exportierte Skripte |
scripts/frames.sh <video> <out> | Video → WebP-Framesequenzen (Desktop + Mobil) + Manifest |
scripts/shoot.mjs <url> [out] | Screenshots in 3 Breiten entlang des Scrollens + Fehler/LCP/Überläufe |
scripts/slop_check.py <dir> | KI-Slop- + Auslieferungsbereitschafts-Linter (0 FAIL zum Ausliefern) |
Playwright für die .mjs-Skripte: npm i -D playwright && npx playwright install chromium.