Communitygithub.com

MCERQUA/jam-skills

Erstellen Sie produktionsreife Next.js 15-Websites von Grund auf – forschungsorientierter Workflow: Discovery → Tiefenrecherche (Keywords, Wettbewerber, Content-Strategie, Topical Map) → Design-Planung → Gerüst → Bau → Deployment.

Was ist jam-skills?

Diese Skill-Anleitung für KI-Agenten (z. B. Claude Code, Cursor, Codex) beschreibt einen 13-Phasen-Workflow zur Erstellung von Next.js 15-Websites. Der Schwerpunkt liegt auf einem forschungsorientierten Ansatz, bei dem vor dem Schreiben von Code eine gründliche Keyword-Recherche, Wettbewerbsanalyse, Content-Strategie und Design-Planung durchgeführt wird. Sie unterstützt verschiedene Website-Typen (SEO-Leadgenerierung, lokale Dienstleistungen, Portfolio, SaaS/Produkt) und enthält spezifische Regeln für lokale Dienstleistungsseiten zur Steigerung der Conversion-Rate (3–5 %). Der Tech-Stack umfasst Next.js 15, React 19, TypeScript, Tailwind CSS v3, shadcn/ui, Motion und Lenis. Die Anleitung enthält nicht verhandelbare Regeln, z. B. niemals Code vor der Forschung zu schreiben, keine Vorlagen-Standardwerte zu liefern, keine Angsttaktiken zu verwenden und einen Sweep für Platzhalter durchzuführen. Der Workflow umfasst die Phasen Discovery, Setup, Forschung, Design-Planung, Gerüst, Design-System, Seitenaufbau, Animation, Inhaltstexte, SEO, Formulare/CTA, Tests und Deployment. Für lokale Dienstleistungsseiten werden detaillierte CRO-Regeln bereitgestellt, die sich auf Telefonnummer-Sichtbarkeit, Formularoptimierung, mobile Geschwindigkeit und die Verwendung echter Fotos konzentrieren.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/MCERQUA/jam-skills/tree/HEAD/website-builder

In Ihrer bevorzugten KI fragen

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

Dokumentation

⚠️ ZUERST LESEN: PNPM_11_REQUIREMENTS.md in diesem Skill-Verzeichnis. Webdev-Container (in denen Mike Ihre Websites Vorschaut) laufen mit pnpm 11.1.1 seit 2026-05-13. JEDES neue Projekt MUSS pnpm.onlyBuiltDependencies in der package.json deklarieren (mindestens: ["sharp"] für jedes Next.js-Projekt), sonst startet der Dev-Server NICHT. Überspringen Sie dies, und der Container gerät in Neustart-Schleifen, die Website gibt 502 aus, und der Benutzer gibt Ihnen die Schuld. 60-Sekunden-Lektüre; ignorieren auf eigene Gefahr.


Website-Baukasten – Komplette Next.js-Website-Skill

Forschungsgesteuerter, designintentionaler Website-Bau. Jede Entscheidung datengestützt, jeder Abschnitt durch Recherche gerechtfertigt.

Wann dieser Skill verwendet werden soll

AUSLÖSEN, wenn der Benutzer bittet:

  • Eine neue Website zu bauen
  • Eine Website für sein Unternehmen zu erstellen
  • Ein neues Webprojekt zu starten
  • "Mach mir eine Seite"

NICHT VERWENDEN für:

  • Canvas-Seiten (dafür den Skill canvas-web-design verwenden)
  • Bearbeiten eines bestehenden Website-Projekts (dort der .claude/CLAUDE.md dieses Projekts folgen)
  • Remotion-Videoprojekte (dafür den Skill remotion-video verwenden)

UNVERHANDELBARE REGELN

  1. NIE Code schreiben, bevor die Recherche und Designplanung abgeschlossen sind. Die Phasen 1-4 produzieren null Code. Das ist richtig so.
  2. NIE eine Seite mit Vorlagen-Standardwerten ausliefern. Wenn Sie "Logo", "(555) 000-0000", "[email protected]", "Dienstleistung Eins" sehen – haben Sie VERSAGT.
  3. NIE Werbetexte ohne Keyword-Recherche schreiben. Jede Überschrift zielt auf ein bestimmtes Keyword aus Phase 3.
  4. NIE den Designplan überspringen. Jeder Abschnitt, jede Farbe und jede Animation muss einen dokumentierten GRUND haben.
  5. NIE Angsttaktiken oder angstbasierte Überschriften verwenden. Schreiben Sie nutzenorientierte, SEO-optimierte Texte.
  6. IMMER den Platzhalter-Sweep durchführen, bevor Sie eine Website präsentieren. Null Toleranz.
  7. IMMER jeden Abschnitt anpassen. Wenn ein Abschnitt integrierte Standardwerte rendert, haben Sie vergessen, Props zu übergeben.
  8. NIE Browser-Zurück-Taste-Hijacking ausliefern. Keine history.pushState-Schleifen, keine Redirect-Fallen, keine Modal-/Overlay-Ketten, die den Benutzer daran hindern, mit der Zurück-Taste des Browsers zur SERP zurückzukehren – ein Verstoß gegen die Google-Spam-Richtlinien (bösartige Praktiken, durchgesetzt seit 2026-06-15) mit manuellem Maßnahmen- und Degradierungsrisiko. Prüfen Sie Exit-Intent-Skripte, Interstitials und jeglichen eingebundenen Anzeigen-/Bibliothekscode (der Verstoß stammt oft daher, nicht von First-Party-Code). In Phase 12 verifizieren. (developers.google.com/search/blog/2026/04/back-button-hijacking)

Website-Typen

Identifizieren Sie diese beim Intake – das ändert alles:

TypZielSchlüsselabschnitteSchreibstil
SEO-LeadgenerierungRanken + Leads einfangenHero + TrustBar + CoverageGrid + HowItWorks + FAQ + Testimonials + CTAKeyword-reich, nutzenorientiert, professionell
Lokaler DienstleisterTelefonanrufe + FormulareHero + TrustBar + Dienstleistungen + Servicegebiete + Bewertungen + CTADirekt, vertrauensbildend, zielgebietsbezogen
PortfolioArbeit präsentierenHero + ProjectGrid + Über uns + Prozess + KontaktVisuell, minimaler Text, Arbeit sprechen lassen
SaaS / ProduktAnmeldungen / TestversionenHero + Funktionen + Preise + Testimonials + FAQ + CTANutzenorientiert, vergleichsgetrieben

Lokale Dienstleister-Seiten: Beachten Sie den Abschnitt Lokale Dienstleister CRO-Regeln weiter unten, bevor Sie eine Seite für einen Hausdienstleister oder Handwerker bauen. Die meisten lokalen Seiten konvertieren unter 1 %. Mit diesen Regeln erreichen Sie 3–5 %.


Lokale Dienstleister CRO-Regeln

Quelle: Noah Igler (@noahiglerSEO) Conversion-Audit von Seiten für Hausdienstleister (Klempner, HLK, Dachdecker, Elektriker, Landschaftsgärtner usw.). Die meisten Seiten bekommen guten Traffic, aber das Telefon klingelt nicht – weil die Seite Leads verliert, nicht Traffic.

Die meisten Hausdienstleister-Seiten konvertieren unter 1 %. Diese Regeln zielen auf 3–5 % bei gleichem Traffic ab.

Oberhalb der Falte (80 % der Conversions werden hier gewonnen oder verloren)

Innerhalb von 3 Sekunden nach dem Landing müssen Besucher wissen: was Sie tun, wo Sie es tun, dass Sie vertrauenswürdig sind und wie sie Sie anrufen können. Jedes der folgenden Elemente ist erforderlich – nicht optional.

  • Überschriftenformat: "[Dienstleistung] in [Stadt]" oder "[Stadt]s vertrauenswürdiger [Dienstleistungs]-Betrieb" – NICHT "Ihr vertrauenswürdiger Partner für Hausdienstleistungen seit 2003"
  • Telefonnummer: Oben rechts, große Schrift, beim Scrollen fixiert – direkt als tel:-Link (KEIN Modal, KEIN Popup, KEIN Bestätigungsschritt – ein Modal verursachte bei einem Kunden einen 30%igen Rückgang der Anrufe)
  • Vertrauensleiste / Unterüberschrift: Sternebewertung + Anzahl der Bewertungen + Jahre im Geschäft + Lizenznummer + Servicegebiet – alles im Hero
  • Primärer CTA: "Jetzt anrufen" oder "Kostenloses Angebot" – zeigen Sie die Telefonnummer AUF dem Button oder direkt darunter
  • Hero-Bild: Echte Fotos Ihres Teams in Marken-Shirts, von Fahrzeugen auf Baustellen oder von tatsächlichen Arbeiten – KEINE Stockfotos von lächelnden Familien (Besucher erkennen sie sofort; Vertrauen kippt ins Negative)

Telefonsichtbarkeit – Der stärkste Hebel

  • Sticky-Header: Telefonnummer beim Scrollen auf Mobilgeräten immer sichtbar
  • Sticky-Footer-Leiste auf Mobilgeräten: zwei Buttons – "Jetzt anrufen" (tel:-Link) und "Online buchen" – immer sichtbar
  • Floating-Action-Button auf langen Seiten
  • Steigert die Anrufvolumina in der Praxis um 15–25 %

Formulare – Jedes zusätzliche Feld kostet ~10 % der Conversions

Maximal 4 Felder für jedes Lead-Formular eines Hausdienstleisters:

  1. Name
  2. Telefon
  3. Benötigte Dienstleistung (Dropdown – kein Freitext)
  4. Adresse

Nie hinzufügen: E-Mail, "Beste Zeit für einen Rückruf", "Wie haben Sie von uns erfahren?", Kommentarfeld, Adressnachweis oder irgendwelche Qualifizierungsfragen. Sie führen keine Kreditantragstellung durch – Sie bekommen ihre Telefonnummer, um zurückzurufen. Die Qualifizierung erfolgt beim Anruf.

Mobile Geschwindigkeit – Nicht verhandelbar

  • Unter PageSpeed 50 auf Mobilgeräten = Verlust von 2–3 Map-Pack-Plätzen
  • Unter PageSpeed 70 = Verlust von 20–30 % der mobilen Besucher, bevor die Seite lädt
  • Ziel: PageSpeed 70+ auf Mobilgeräten, Seitenladezeit < 2 Sekunden

Geschwindigkeitsoptimierungen (nach Wirkung geordnet):

  1. Hero-Bild auf 200–400 KB komprimieren (die meisten Seiten liefern 2–3 MB Hero-Bilder aus)
  2. Überflüssige Plugins und Tracking-Skripte entfernen
  3. Ein echtes CDN verwenden (nicht nur die gebündelte Option des Hosters)
  4. Alles unterhalb der Falte lazy laden
  5. Drittanbieter-Widgets minimieren (Live-Chat, Social-Embeds, Bewertungsaggregatoren) – sie laden spät und verdecken die Telefonnummer

Bewertungen / Social Proof – Müssen bei jeder Bildlauf-Tiefe erscheinen

Platzieren Sie nicht alle Nachweise in einem einzigen Testimonial-Abschnitt auf halber Höhe. Besucher müssen sie auf jeder Ebene sehen:

  • Oberhalb der Falte: "4,9 Sterne aus 312 Google-Bewertungen" – Anzahl + Bewertung in der Hero-Vertrauensleiste
  • Hero-Abschnitt: 2-3 kurze Pull-Quote-Zitate aus echten Bewertungen, vorzugsweise dynamisch von GBP
  • Dienstleistungsseiten: dedizierter Bewertungsabschnitt, der Zitate zu dieser bestimmten Dienstleistung zieht
  • Beim Formular: wiederholen Sie den Nachweis direkt vor der Aufforderung

Das Ziel: Wenn sie das Formular erreichen, haben sie den Nachweis 5–6 Mal gesehen.

Fotos – Echte Bilder statt Stockfotos

  • Echte Fotos des Teams in Marken-Shirts auf Baustellen
  • Fahrzeuge, die bei tatsächlichen Kunden zu Hause geparkt sind
  • Vorher-Nachher-Aufnahmen (Rohrreinigung, Schaltschrankarbeit, Klimaanlagen-Installation, Kanalarbeiten, Dachaustausch)
  • Lizenzdokumente, Herstellerzertifikate, Versicherungsnachweise fotografiert und angezeigt
  • Die Seite sollte wie ein physisches Unternehmen mit echten Menschen aussehen, nicht wie eine Vorlage, in die eine Marketingagentur ein Logo gesetzt hat

Finanzierung – Erforderlich für hochpreisige Dienstleistungen (5.000 €+)

~60 % der Kunden für Ersatzaufträge wünschen eine Finanzierung. Wenn Ihr Konkurrent das Logo von Synchrony / GreenSky / Wisetack zeigt und Sie nicht, schließen sie den Deal ab, bevor Sie überhaupt ein Angebot machen können.

  • Logo des Finanzierungspartners oberhalb der Falte auf den Dienstleistungsseiten sichtbar
  • "0%-Finanzierung verfügbar" oder "Zahlungen ab 89 €/Monat"-Hinweis im Hero
  • Separate Finanzierungsseite, die im Hauptmenü verlinkt ist
  • Vorqualifizierungs-Widget auf hochpreisigen Dienstleistungsseiten eingebettet

Häufige Fehler, die Conversions killen

Diese tauchen ständig in Audits auf – liefern Sie nichts davon aus:

  • Längere Formulare, um Leads zu "qualifizieren" – Sie qualifizieren sie nicht, Sie verlieren sie
  • Telefon verstecken, um Formularausfüllungen zu erzwingen – sie gehen stattdessen einfach
  • Auto-Playing-Video im Hero-Bereich – killt die mobile Geschwindigkeit, nervt den Besucher
  • Pop-ups beim ersten Besuch – sofortiger Klick auf die Zurück-Taste auf Mobilgeräten
  • Live-Chat-Widgets – brauchen 4s zum Laden, verdecken die Telefonnummer, bringen für Hausdienstleistungen keinen Mehrwert

Tech-Stack (jedes Projekt)

ToolPaketZweck
Next.js 15nextApp Router, Serverkomponenten, Server-Aktionen
React 19reactUI-Framework
TypeScripttypescriptTypsicherheit
Tailwind CSS v3tailwindcssUtility-First-Styling (v3 – NICHT v4, v4 hat PostCSS-Probleme)
shadcn/uishadcn (CLI)Komponentenbibliothek (Radix + Tailwind)
MotionmotionAnimationen (Federphysik, Scroll, Layout)
LenislenisSmooth Scroll (< 4kb, barrierefrei)
Lucide Reactlucide-reactSVG-Icons

Optional (bei Bedarf installieren)

ToolPaketWann
Pretext@chenglou/pretextTextmessung ohne DOM-Reflow – virtualisierte Listen, Chat-UIs, Mosaik-Raster, sich automatisch anpassende Textcontainer, Canvas-Text-Rendering. ~500x schneller als getBoundingClientRect. Zero Abhängigkeiten. Siehe /mnt/shared-skills/pretext/SKILL.md
GSAPgsapKomplexe Scroll-Sequenzen, SplitText, MorphSVG
Three.jsthree + @react-three/fiber3D-Hintergründe oder Hero-Elemente
MDX@next/mdxBlog mit reichhaltigen Inhalten
PrismaprismaDatenbankzugriff

13-Phasen-Workflow

Folgen Sie diesen Phasen IN REIHENFOLGE. Überspringen Sie keine Phasen. Die Phasen 1-4 produzieren NULL Code – sie produzieren Forschung und einen Plan. Das ist der Punkt.

Phase 1: DISCOVERY

Lesen: instructions/brand-intake.md

Stellen Sie dem Kunden die Brand-Intake-Fragen, BEVOR Sie etwas anderes tun:

  • Geschäftsidentität, Branche, Zielkunde
  • Markenfarben, Ton, Persönlichkeit
  • SEO-Ziele, Wettbewerber, wonach Kunden suchen
  • Benötigte Seiten, besondere Funktionen, primärer CTA
  • Website-Typ (SEO-Leadgenerierung, lokaler Dienstleister, Portfolio, SaaS)

Ergebnis: Ausgefüllte Intake-Antworten

Phase 2: SETUP

Lesen: instructions/folder-setup.md

Erstellen Sie die ai/-Ordnerstruktur innerhalb des Projektverzeichnisses:

  1. Alle Forschungsverzeichnisse erstellen (01-07)
  2. Design-, Inhalts- und Blog-Recherche-Verzeichnisse erstellen
  3. research-status.json initialisieren
  4. 01-business-profile/profile.md aus den Intake-Antworten befüllen

Ergebnis: Komplette ai/-Ordnerstruktur mit ausgefülltem Geschäftsprofil

Phase 3: RECHERCHE (die Grundlage – NICHT HETZEN)

Lesen: instructions/research-plan.md

Sechs Rechercheaufgaben, die ALLES informieren, was folgt:

  1. Keyword-Recherche – 50-100+ Keywords in den Kategorien Primär, Sekundär, Long-Tail, Standort finden. Dokumentieren in ai/research/02-keyword-research/. Google durchsuchen, PAA-Fragen erfassen, Keyword-Cluster aufbauen.

  2. Wettbewerber-Tiefenanalyse – 5-10 Wettbewerber-Seiten im Detail prüfen. Für jede: Homepage-Abschnitte, Hero-Layout, CTAs, visuelles Design, Typografie, Animationen, Inhaltsqualität, Stärken, Schwächen dokumentieren. Pro-Wettbewerber-Review-Dateien in ai/research/03-competitor-analysis/site-reviews/ erstellen. Dann in pattern-analysis.md (gemeinsame Muster in der Nische) und gaps-opportunities.md (was wir ausnutzen) zusammenführen.

  3. Content-Strategie – Jede Seite abbilden: URL, Keywords, Abschnitte, H1, Meta-Tags. Pro-Seite-Content-Briefs in ai/research/04-content-strategy/content-briefs/ erstellen. FAQ-Fragen aus PAA, Reddit, Foren recherchieren.

  4. Topical Map – Topic-Cluster-Architektur aufbauen: Pillar-Seiten, Cluster-Content, interne Verlinkungsstrategie. Dokumentieren in ai/research/05-topical-map/.

  5. Lokales SEO (falls zutreffend) – Zielservicegebiete, lokale Wettbewerber, stadt-spezifische Keywords. Dokumentieren in ai/research/06-local-seo/.

  6. Conversion-Muster – CTAs der Wettbewerber, Vertrauenssignale, Social-Proof-Muster analysieren. Den Conversion-Trichter abbilden. Dokumentieren in ai/research/07-conversion-patterns/.

Ergebnis: 20-40 Recherchedateien in 7 Verzeichnissen. research-status.json aktualisieren.

Phase 4: DESIGN-PLAN (die Denkphase – jede Entscheidung intentional)

Lesen: instructions/design-plan.md

Hier verwandelt sich eine Seite von "einer weiteren Vorlage" in etwas, das FUNKTIONIERT. Sechs Designdokumente:

  1. Wettbewerber-Visual-Audit (ai/design/competitor-visual-audit.md) – Alle Wettbewerber-Seiten auf visuelle Muster prüfen: Hero-Typen, Abschnittsreihenfolge, Farbschemata, Typografie, Animationen, Fotografie-Stil. Nach visueller Qualität ordnen. Identifizieren, was zu übertreffen ist.

  2. Stilrichtung (ai/design/style-direction.md) – Ästhetik mit Begründung wählen. Farben, Schriftarten, Hell/Dunkel-Modus, Abstände – jede Wahl zurückverfolgt zum Brand-Intake + Wettbewerbsanalyse + Branchenkontext.

  3. Komponentenplan (ai/design/component-plan.md) – Jede benötigte Komponente, in Reihenfolge, mit ihrem Zweck. Warum dieses Hero-Layout? Warum dieser Trust-Bar-Stil? Warum diese Abschnitte in dieser Reihenfolge? Auf den Conversion-Trichter abbilden.

  4. Animationsplan (ai/design/animation-plan.md) – Was sich bewegt, warum, wie. Eintrittsanimationen, Hover-Zustände, Scrolleffekte. Intentionale Bewegung, keine zufällige Dekoration.

  5. Seiten-Wireframes (ai/design/page-wireframes.md) – Abschnitt-für-Abschnitt-Layout für jede Seite. ASCII-Wireframes, die die Struktur zeigen.

  6. Design-Brief (ai/design/design-brief.md) – Master-Dokument. Fasst alle Designentscheidungen zusammen, listet auf, was diese Seite "knallen" lässt im Vergleich zu Wettbewerbern, verbindet jede Wahl mit der Recherche.

Ergebnis: 6 Designdokumente. Der Design-Brief ist die Referenz für den gesamten Bau.

Phase 5: GERÜST

Lesen: instructions/architecture.md Verwenden: templates/project/-Verzeichnis

  1. templates/project/ kopieren nach Websites/<projektname>/
  2. pnpm install ausführen
  3. shadcn installieren: pnpm dlx shadcn@latest init
  4. Core-shadcn-Komponenten installieren: pnpm dlx shadcn@latest add button card badge separator input textarea label
  5. Animationsabh. installieren: pnpm add motion lenis
  6. Git initialisieren, Gerüst committen
  7. Privates GitHub-Repo erstellen, pushen, web-dev-Branch erstellen
  8. .claude/CLAUDE.md mit templates/config/claude-project.md befüllen

Phase 6: DESIGN-SYSTEM

Lesen: instructions/design-system.md Verwenden: templates/config/design-system.ts

  1. globals.css einrichten – Tailwind-Variablen, Custom-Properties von denen im Design-Plan
  2. lib/utils.ts – Vom shadcn-Init kopieren
  3. components/ui/ mit Design-System-Varianten überschreiben:
    • button.tsx: Primär-, Sekundär-, Outline-, Ghost-Stile
    • badge.tsx: Standard-, Sekundär-, Outline-Badges
    • card.tsx: Kartenkomponente anpassen
    • separator.tsx: Trennlinien-Stile
  4. Typografie-Klassen in app/globals.css – Überschriften, Fließtext, Link-Stile
  5. Individuelles tokens/-Verzeichnis erstellen (bei Bedarf):
    • tokens/colors.ts – Vollständige Farbpalette aus dem Design-Plan
    • tokens/typography.ts – Font-Größen, Gewichtungen, Zeilenhöhen
    • tokens/spacing.ts – Abstandsskala
    • tokens/animation.ts – Übergangs-Kurven, -Dauern

Ergebnis: Bereites Design-System, das die visuelle Sprache der Seite definiert

Phase 7: SEITEN – BAU

Fortschrittsdokument: ai/working/sections-status.md

Bauen Seite für Seite. Jede Seite wird zu einem eigenen Zweig erstellt:

  1. Homepage (feature/homepage, Abschnitte nacheinander bauen):

    • Header / Navigation
    • Hero-Abschnitt
    • Trust-Bar
    • Dienstleistungen / Funktionen (je nach Typ)
    • Über uns / zugehöriger Abschnitt
    • Testimonials / Bewertungen
    • Prozess / How-It-Works
    • FAQ
    • CTA / Kontakt
    • Footer
  2. Weitere Seiten (jeweils eigene Zweige):

    • "Über uns"-Seite
    • Dienstleistungen / Produktseiten
    • Blog / Ressourcen
    • Kontaktseite
    • Rechtliches / Datenschutz

Jeder Abschnitt: Komponente bauen (in components/sections/), in Seiten integrieren, auf Mobilgeräten testen. Nach jedem abgeschlossenen Abschnitt committen.

Ergebnis: Voll funktionsfähige Website mit allen Seiten und Abschnitten

Phase 8: ANIMATIONEN & INTERAKTION

Lesen: instructions/animation.md

Motion + Lenis für eine ausgefeilte, intentionale Benutzererfahrung verwenden:

  1. Lenis einrichten – Smooth-Scroll-Anbieter in die App einfügen
  2. Seiteneintrittsanimationen – Fade-In, Slide-Up für Abschnitte beim Scrollen
  3. Hover-Effekte – Karten, Buttons, Links
  4. Scroll-Animationen – Parallaxe, fortlaufende horizontale Abschnitte (nach Bedarf)

Ergebnis: Animierte, flüssige Benutzererfahrung

Phase 9: INHALTE & TEXTE

Lesen: instructions/content-writing.md (mit den Research-Ergebnissen aus Phase 3)

  1. Jede Überschrift schreiben – auf das primäre Keyword dieser Seite ausgerichtet
  2. Jedes H2 und H3 schreiben – Sekundär-Keywords
  3. Fließtext schreiben – natürliche Keyword-Verwendung
  4. FAQ-Abschnitte schreiben – alle relevanten PAA-Fragen beantworten
  5. Meta-Titel und -Beschreibungen für alle Seiten schreiben
  6. Alt-Texte für alle Bilder schreiben
  7. Schema-Markup erstellen (LocalBusiness, FAQ, Article, je nach Typ)

Ergebnis: SEO-optimierte, gebrauchstaugliche Texte auf jeder Seite

Phase 10: SEO & LEISTUNG

  1. Meta-Tags: Überprüfen, ob alle Seiten eindeutige Titel und Beschreibungen haben
  2. Open Graph: OG-Bilder und -Meta für soziale Freigabe
  3. Strukturierte Daten: JSON-LD für LocalBusiness (falls zutreffend), FAQ, BreadcrumbList
  4. Seitenladegeschwindigkeit: Lighthouse-Audit – auf PageSpeed 70+ auf Mobilgeräten abzielen
  5. Kern-Web-Vitals: LCP, FID, CLS optimieren
  6. Sitemap: sitemap.ts erstellen
  7. Robots: robots.txt konfigurieren
  8. Analytics: Google Analytics oder Plausible im <Head> (nicht im Body-Bereich, wo es andere Skripte blockiert)

Phase 11: FORMULARE & CTAs

  1. Kontaktformular validieren (siehe Fehlerzustände)
  2. CTA-Buttons überprüfen: richtige Verlinkung, auffällig in der Farbe
  3. Mobile CTAs: Sticky-CTA-Leiste auf Mobilgeräten testen
  4. Danke-Seite / Bestätigungsnachricht nach Formularabsendung
  5. Formular-Spam-Schutz (Honeypot, Rate-Limiting)
  6. Formular-Workflow mit Server-Aktion (keine clientseitige API-Route)

Phase 12: QUALITÄTSSICHERUNG

Lesen: instructions/testing.md

  1. Vollständigen Seiten-Sweep für alle Seiten durchführen – registrieren Sie Ihre Fortschritte in ai/working/qa-sweep-log.md
  2. Sweep für Platzhalter-Inhalte durchführen: "Logo", "(555) 000-0000", "[email protected]", "Lorem Ipsum", "Dienstleistung Eins"
  3. Link-Checker: Alle internen und externen Links testen
  4. Mobile Ansicht testen: Alle Seiten auf iPhone 12, iPad, Desktop
  5. Barrierefreiheit: Kontrastverhältnisse, Alt-Texte, Tastaturnavigation, aria-Labels
  6. Ladegeschwindigkeit testen (Lighthouse, PageSpeed Insights)
  7. Browser-Kompatibilität testen (Chrome, Firefox, Safari)
  8. Formular-Absendung testen
  9. QR-Code-Test: über QR-Code auf Mobilgerät zugreifen (für lokale Dienstleister unerlässlich – Kunden scannen das Angebot)
  10. Sicherheits-Sweep: Prüfen auf API-Key-Leaks, offene Endpunkte, unsichere Drittanbieter-Skripte
  11. Back-Button-Hijacking-Audit – Geschlossene Seite im Inkognito-Fenster öffnen, auf eine andere Seite (z. B. eine echte SERP oder eine andere Website) navigieren, dann Zurück-Taste drücken. Sie sollten zur vorherigen Seite zurückkehren. Wenn Sie eine endlose Schleife erreichen oder auf einer Modal-Seite landen, müssen Sie die Ursache finden und beheben (oft ein Exit-Intent-Skript oder Overlay-Code).

Ergebnis: QA-bestehende, einsatzbereite Website

Phase 13: DEPLOYMENT

Lesen: instructions/deploy.md

  1. main-Branch in dev-Branch mergen und auf Live-Server deployen (Vercel, Netlify, oder eigener Server)
  2. Domain einrichten (DNS, SSL)
  3. Umgebungsvariablen setzen
  4. Nach dem Deployment testen (alles auf Live-Umgebung prüfen)
  5. Google Search Console einrichten
  6. Analytics-Zielsetzung überprüfen (Conversions, Formular-Einreichungen)
  7. Geschwindigkeit erneut testen (PageSpeed Insights)
  8. Dokumentation für den Kunden erstellen (Anmeldung, Verwaltung aktualisieren)

Verzeichnisstruktur (erwartet)

<projektname>/
├── .claude/
│   └── CLAUDE.md              # Die Anleitung dieses Projekts
├── ai/
│   ├── research/
│   │   ├── 01-business-profile/
│   │   ├── 02-keyword-research/
│   │   ├── 03-competitor-analysis/
│   │   │   └── site-reviews/
│   │   ├── 04-content-strategy/
│   │   │   └── content-briefs/
│   │   ├── 05-topical-map/
│   │   ├── 06-local-seo/
│   │   └── 07-conversion-patterns/
│   ├── design/
│   ├── working/
│   └── research-status.json
├── app/
│   ├── layout.tsx
│   ├── page.tsx
│   └── ...
├── components/
│   ├── ui/
│   └── sections/
├── lib/
│   └── utils.ts
├── public/
│   └── images/
├── types/
├── instructions/              # Enthalten in der Skill-Struktur
├── templates/
│   ├── project/
│   └── config/
├── next.config.ts
├── package.json
├── tailwind.config.ts
└── tsconfig.json

Dateiorganisation

Jede wesentliche Datei wird in ihrem beabsichtigten Verzeichnis abgelegt:

  • instructions/ – Anleitungen, die jede Phase leiten (Phase-X-Dateien)
  • templates/ – Projekt-Scaffold, Konfigurationsvorlagen
  • ai/research/ – Alle Forschungsdateien, gegliedert nach Phase
  • ai/design/ – Designdokumente
  • ai/working/ – Aktuelle Arbeitsdokumente (Sections-Status, QA-Log)
  • app/ – Next.js-App-Router-Seiten
  • components/ui/ – Wiederverwendbare UI-Komponenten (shadcn-Stil)
  • components/sections/ – Seitenabschnitt-Komponenten
  • lib/ – Hilfsfunktionen, Dienstprogramme
  • public/images/ – Bilder, Grafiken

Verwandte Skills

  • canvas-web-design – Verwenden Sie diesen Skill für Canvas-Seiten, bei denen Sie in einem visuellen Editor arbeiten.
  • remotion-video – Verwenden Sie diesen Skill für Remotion-Videoprojekte.
  • web-dev – Verwenden Sie diesen Skill, um eine bestehende Website zu bearbeiten (folgen Sie dem .claude/CLAUDE.md dieser Website).
  • article-writer – Verwenden Sie diesen Skill, um einen einzelnen Blogbeitrag oder Artikel zu schreiben.

Verwandte Skills