Client-Website erstellen
Die Hauptsitzung führt diese Pipeline aus und delegiert an Unteragenten. (Unteragenten können keine anderen Unteragenten starten, weshalb dies ein Skill und kein Orchestrator-Agent ist.)
[0 Erfassungstor] Brief + DESIGN.md + Referenzen
↓
[1 Plan] Sitemap, Seitenabschnitte, Texte → plan.md, src/data/*
↓
[BENUTZERTOR 1] Plan und Texte genehmigen
↓
[2 Bau] Seiten und visuelles System
↓
[3 SEO] SEO-Agent → seo-report.md
↓
[4 Verifizieren] npm run verify (hartes Tor)
↓
[5 Review] Site-Reviewer-Agent → review-report.md
↓
[6 Fehlerbehebung] P0/P1 → beheben → verifizieren → erneut reviewen (max. 2 Runden)
↓
[BENUTZERTOR 2] Website genehmigen
↓
[7 Launch-Vorbereitung] Launch-Checkliste + Übergabedokument
↓
[8 Lessons Learned] An docs/lessons.md anhängen
Artefakte
Alles wird in .claude/pipeline/ abgelegt:
pipeline-state.md Phase, Fehlerbehebungsrunde, letzte Aktualisierung
plan.md Sitemap, Abschnitte pro Seite, Hauptaktion pro Seite
review-report.md Vom Site-Reviewer
seo-report.md Vom SEO-Agenten
screenshots/ Von npm run verify
Lies zu Beginn jeder Phase pipeline-state.md und setze ab dem dort angegebenen Punkt fort. Aktualisiere die Datei am Ende jeder Phase. Dadurch kann der Bau über mehrere Sitzungen hinweg erfolgen.
Phase 0: Erfassungstor
Prüfe jedes Element. Wenn etwas fehlt, stoppe und hilf dem Benutzer, es zu ergänzen, bevor du fortfährst.
| Element | Bereit, wenn |
|---|---|
.agents/product-marketing.md | Geschäftsfakten-Abschnitt vollständig, Hauptaktion benannt, Zielgruppe und Tonfall ausgefüllt. Verwende den product-marketing-Skill, um es aus den Angaben des Benutzers zu entwerfen. |
src/data/business.json | Name, Telefon, Adresse, Öffnungszeiten, Maps-Link stimmen mit dem Brief überein. Kopiere sie aus dem Brief. |
DESIGN.md | Jeder Abschnitt ausgefüllt. Wenn der Benutzer nur Referenzen hat, entwerfe es aus references/ und bitte um Bestätigung. |
references/ | Mindestens zwei Screenshots oder URLs mit einem Hinweis, was daraus übernommen werden soll. |
| Client-Assets | Logo und Fotos, oder ein expliziter Hinweis, dass Platzhalter vorerst in Ordnung sind. |
| Bearbeitung | Wird der Kunde die Website selbst bearbeiten? (Beeinflusst Phase 7.) |
Fülle dann src/styles/tokens.css aus DESIGN.md.
Phase 1: Plan
- Schreibe
plan.md: die Seiten (die meisten Kunden benötigen Startseite, eine Seite pro Hauptangebot oder eine Menü-/Dienstleistungsseite, Über uns, Kontakt), die eine Hauptaktion pro Seite und die Abschnitte auf jeder Seite in Reihenfolge. Verwende den Brief undsite-essentials. - Schreibe die Texte mit dem
copywriting-Skill und führe danncopy-editingdarauf aus. Beginne mit der Kundensprache des Briefs und den eigenen Worten des Kunden und verwende einige dieser Phrasen nahezu wörtlich. Befolge Hausregel 9 in CLAUDE.md (keine generische KI-Formulierung). Lege sie insrc/data/ab (home.json, services, FAQs), nicht in Komponenten. - Markiere alles, was du nicht weißt, als
[NEED: ...]. Fülle nie eine Lücke mit einer erfundenen Tatsache.
Benutzertor 1
Stoppe. Zeige dem Benutzer: die Sitemap, die Abschnitte und Hauptaktionen jeder Seite, den vollständigen Text und jedes [NEED: ...]-Element. Warte auf Genehmigung oder Änderungen. Texte sind jetzt günstiger zu ändern als nach dem Bau.
Phase 2: Bau
Baue mit dem design-taste-frontend-Skill (Geschmacksskill) innerhalb dieses Astro-Projekts. Sage ihm vor dem Start:
- Die Art ist
place(Menschen kommen zu ihm) oderservice(Menschen werden eingestellt), niemals eine technische Art. - DESIGN.md und
references/legen Palette, Typografie und Stil fest. Die eigene Standardpalette und Schriftarten werden überschrieben. - Geschäftsfakten stammen aus
src/data/business.json. Die Platzhalter-Kontaktregeln gelten nicht. - Bewegung folgt den Hausregeln in CLAUDE.md.
Baue Seite für Seite, zuerst die Startseite. Führe nach der Startseite npm run verify aus, sieh dir die drei Screenshots an und behebe, was du siehst, bevor du die nächste Seite baust. Das Abschlusstor des Geschmacksskills wird automatisch ausgeführt, wenn er stoppt; behandle seine Ergebnisse als Eingabe, aber CLAUDE.md hat bei Konflikten Vorrang.
Phase 3: SEO
Der SEO-Agent bearbeitet Head-Tags, JSON-LD und Robots, daher wird er vor Verifizierung und Review ausgeführt. So beurteilt das Review die fertige Website.
seo: "Auditiere und implementiere SEO für diese Website, einschließlich des lokalen Business-Schritts. Brief: .agents/product-marketing.md. Schreibe deinen Bericht nach .claude/pipeline/seo-report.md."
Phase 4: Verifizieren (hartes Tor)
npm run verify
Alle check-site-Fehlschläge und Screenshot-Probleme (seitliches Scrollen, Konsolenfehler) müssen vor dem Review behoben werden. [NEED: ...]-Fehlschläge sind nur für Fakten erlaubt, nach denen der Benutzer bereits gefragt wurde; liste sie auf. Schreibe jeden Text um, den check-site als generisch markiert, es sei denn, der Kunde verwendet dieses Wort tatsächlich.
Phase 5: Review
Der Reviewer ist schreibgeschützt und gibt seinen Bericht als letzte Nachricht zurück. Speichere diese Nachricht wörtlich in .claude/pipeline/review-report.md.
site-reviewer: "Überprüfe die gebaute Website. Plan: .claude/pipeline/plan.md. Brief: .agents/product-marketing.md. Design: DESIGN.md. Screenshots: .claude/pipeline/screenshots/. Bereits vorgenommene SEO-Änderungen: .claude/pipeline/seo-report.md. Gib den vollständigen Bericht als deine letzte Nachricht zurück."
Phase 6: Fehlerbehebung
| Site-Reviewer-Befund | Aktion |
|---|---|
| Bereit | Gehe zu Tor 2 |
| Nachbesserung erforderlich, nur P2s | Gehe zu Tor 2, liste die P2s auf |
| Nachbesserung erforderlich (P1s) oder blockiert (P0s) | Runde < 2: Behebe sie, führe Phase 4 (Verifizieren) erneut aus, führe Site-Reviewer erneut auf den geänderten Seiten aus und speichere seinen Bericht. Runde = 2: Stoppe und zeige dem Benutzer. |
Verwende den bug-fixer-Agenten für alles, was defekt ist und nicht nur vom Brief abweicht. Erhöhe die Runde in pipeline-state.md jedes Mal.
Benutzertor 2
Stoppe. Zeige dem Benutzer: Startseiten-Screenshots bei 390 und 1440, den Befund, verbleibende P2s, erforderliche SEO-Entscheidungen, verbleibende [NEED: ...]-Elemente und Platzhalterfotos, die ersetzt werden müssen. Warte auf Genehmigung.
Phase 7: Launch-Vorbereitung
- Führe
npm run check:launchaus und behebe jeden Fehlschlag. Fülle danndocs/launch-checklist.md, markiere jedes Element als erledigt, nicht zutreffend oder wartend auf jemanden (nenne wen). - Fülle
docs/handoff.mdfür den Kunden. - Wenn der Kunde die Website bearbeiten wird, folge
docs/client-editing.md. - Nachdem die Website auf ihrer echten Domain live ist, erinnere den Benutzer daran, claude-seo darauf auszuführen:
/seo local <url>und/seo audit <url>.
Phase 8: Lessons Learned
Durchsuche die Berichte und die Fehlerbehebungsrunden nach allem, was zweimal schiefgelaufen ist oder echte Zeit gekostet hat. Hänge eine datierte Zeile pro Erkenntnis an docs/lessons.md an. Sage dem Benutzer, welche Erkenntnisse es wert sind, zurück in site-starter kopiert zu werden, damit jede zukünftige Website davon profitiert.