Communitygithub.com

WordPress-Seite: Vom leeren Ordner zur Produktion

Start hier für jede WordPress-Site, die mit wp-site-kit erstellt wird – vom leeren Ordner zur Live-Site. Verwende dies, wenn jemand sagt „baue eine WordPress-Site“, „neue Website für einen Kunden“, „wo stehen wir auf der Site“, „was ist als Nächstes vor dem Launch“ oder bittet, ein Site-Projekt fortzusetzen. Findet die aktuelle Phase aus der SITE_STATUS.md, wendet die harten Regeln an und übergibt an die richtige Phasen-Skill.

Was ist WordPress-Seite: Vom leeren Ordner zur Produktion?

Diese WordPress-Site-Skill bietet eine strukturierte, phasenbasierte Methode, um eine WordPress-Website von einem leeren Ordner bis zur Produktion zu entwickeln. Sie wurde auf einer echten, mehrsprachigen Buchungs-Website erlernt, die echte Kundenzahlungen verarbeitet. Die Skill unterstützt acht aufeinanderfolgende Phasen (Kickoff, Design, Build, Content, SEO & Sprachen, Qualität, Ship, Betrieb), wobei jede Phase mit einem definierten Gate endet, das wahr sein muss, bevor die nächste Phase beginnen kann. Der Skill identifiziert automatisch den aktuellen Projektstatus mithilfe der SITE_STATUS.md-Datei, wendet 14 harte Regeln an (z. B. Plugin-First-Ansatz, keine hartcodierten Daten, echte Fotos, keine Fake-Bewertungen) und übergibt die Arbeit an die entsprechende Phasen- oder Builder-Skill (wie wp-kickoff, wp-design, wp-task-file). Er ist für Entwickler und KI-Agenten konzipiert, die mit dem wp-site-kit auf Plattformen wie Claude Code, Cursor oder Codex arbeiten, und legt Wert auf Qualität, Sicherheit und Besitzerkontrolle.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/umairmsm/wp-site-kit/tree/HEAD/skills/wp-site

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht WordPress-Seite: Vom leeren Ordner zur Produktion?

Dieses Kit ist eine Methode plus ein Starter-Projekt. Es wurde auf einer echten mehrsprachigen Buchungs-Website gelernt, über die echte Kunden bezahlen. Die Phasen werden der Reihe nach durchlaufen. Jede Phase endet mit einem Gate: Verlasse eine Phase nur, wenn ihr Gate wahr ist und die Belege dokumentiert sind.

1. Finde heraus, wo das Projekt steht

  1. Suche nach SITE_STATUS.md im Projektverzeichnis.
    • Fehlt: Das Projekt wurde noch nicht gestartet. Verwende wp-kickoff.
    • Vorhanden: Lies sie ein. Die aktuelle Phase ist die erste Phase mit einem nicht abgehakten Gate.
  2. Lies AGENTS.md (die Projektregeln), dann die neuesten Zeilen von SESSION_LOG.md und DECISIONS.md.
  3. Teile dem Besitzer in zwei Zeilen mit: die aktuelle Phase und den nächsten konkreten Schritt.

2. Die Phasen

#PhaseSkillGate zum Verlassen (Belege kommen in SITE_STATUS.md)
1Kickoffwp-kickoffBrief vom Besitzer genehmigt; getroffene Entscheidungen festgehalten; privates Repo; Zugangsdaten nach Namen aufgelistet
2Designwp-designStatischer Prototyp abgezeichnet (Screenshots + Datum); Tokens gesetzt; Schriften selbst gehostet
3Buildwp-buildLokale Site läuft; Core-Plugin + Child-Theme aktiv; echte Inhalte werden durch Core-Funktionen gerendert; Anfragen werden gespeichert, bevor sie weitergeleitet werden; Strukturtests grün
4Contentwp-contentJede öffentliche Seite hat vom Besitzer genehmigten Text und echte Fotos; rechtliche Seiten vorhanden; kein nicht genehmigter KI-Text
5SEO & Sprachenwp-seoTests für Titel, Beschreibung, Canonical, Schema und hreflang grün; Weiterleitungen für alte URLs; jede zusätzliche Sprache hat ihren Piloten bestanden
6Qualitätwp-qualityVollständige Suite grün; 0 Barrierefreiheitsverstöße; Leistungsbudgets auf dem Staging erfüllt
7Auslieferungwp-shipStaging spiegelt Live; Härtung angewendet; Launch-Auditor BESTANDEN; Cutover durchgeführt; 7 Tage beobachtet
8Betriebwp-operateAutomatische Backups mit einer externen Kopie; eine Wiederherstellungsübung durchgeführt; Update- und Alert-Routinen geschrieben
  • Übergabe der Arbeit einer Phase an einen Builder-Agenten (Antigravity, Codex, ein anderer Claude): wp-task-file.
  • Review vor einem Merge: Agent wp-rules-reviewer. Vor dem Go-Live: Agent launch-auditor.

3. Harte Regeln (jede Phase, jeder Agent)

  1. Plugin-First. Logik, Daten, Richtlinientexte, Formulare, Schema und SEO leben im Core-Must-Use-Plugin. Das Theme ist Layout. Das Skin ist das Aussehen. Ein Redesign darf kein Feature verlieren.
  2. Keine hartcodierten Karten, Preise oder Slugs in Templates. Frage den Inhaltstyp ab und rendere über die Render-Funktion des Core-Plugins, sodass eine CMS-Bearbeitung überall sichtbar ist.
  3. Leads werden zuerst gespeichert. Formulare posten an admin-post.php mit einem Nonce. Die Site speichert den Lead in ihrer eigenen Datenbank und leitet ihn dann weiter. Keine API-Schlüssel oder Drittanbieter-Endpunkte auf der Seite.
  4. Keine gefälschten Beweise. Zeige niemals Bewertungen, Rezensionszahlen oder Testimonials an, die niemand belegen kann. Importierte oder „Legacy“-Rezensionszahlen gelten als gefälscht, bis sie belegt sind.
  5. Echte Fotos für jeden benannten Ort, Raum, jedes Produkt oder jede Person. KI-Bilder nur als allgemeine Szenen, benannt ai-*, protokolliert und niemals als „dies ist Ihr Zimmer“ präsentiert.
  6. Fakten stammen vom Besitzer. Preise, Richtlinien, Inklusivleistungen und Sicherheitsfakten werden niemals erfunden. KI-Text ist ein Entwurf, bis der Besitzer ihn genehmigt. Unbekannt = PENDING-<wer>.
  7. Kein KI-geschriebenes PHP in Produktion ohne Branch, lokalen Test, Diff und einen menschlichen Merge. WordPress Coding Standards. Alles mit Präfix versehen.
  8. Keine Page Builder. Keine Google Fonts-Aufrufe. Schriften selbst hosten: Ein deutsches Gericht hat Schadensersatz angeordnet, weil das Nachladen von Google die IP-Adressen der Besucher preisgab.
  9. Staging und lokal werden nie indexiert und senden niemals E-Mails an echte Kunden.
  10. Tests werden niemals abgeschwächt, um grün zu werden: Kein Löschen, Überspringen oder Erneutes Erstellen von Snapshots. Das Umbenennen eines Tests benötigt die Zustimmung des Besitzers.
  11. Deployments gehören dem Besitzer. Von einem Commit über scripts/deploy-safe.sh: zuerst Trockenlauf, zuerst Backup, das Wort live von einem Menschen eingegeben.
  12. Die Datenbank ist Inhalt. Ändere sie nur über eine überprüfbare Änderungsdatei und ein geschütztes Skript mit Trockenlauf. Backup vor jeder DB-Änderung.
  13. Geheimnisse gelangen nie in Git, Logs, Prompts oder auf die Seite. CREDENTIALS_INVENTORY.md listet Namen und Orte, an denen jedes Geheimnis lebt, niemals Werte.
  14. Ein Schema-Besitzer (normalerweise das SEO-Plugin). Gib niemals ein Offer ohne Preis aus.

4. Frage zuerst den Besitzer

  • Installation von Plugins, Themes, Tools oder kostenpflichtigen Diensten (Page Builder: niemals).
  • Jegliche Änderung an Preisen, Währungen, Richtlinien, Markennamen oder Logos. Veröffentlichung einer neuen Sprache.
  • Alles, was DNS, Cloudflare, Hosting, Staging oder Live betrifft. Destruktive DB- oder Dateibefehle.
  • Senden von Code oder Kundeninhalten an eine Drittanbieter-KI-API.

5. Wie zu arbeiten ist

  • Eine Phase nach der anderen, ein kleiner Schritt nach dem anderen. Nach jedem sinnvollen Schritt committen (Conventional Commits).
  • Branch, lokaler Test, Diff, dann merged der Besitzer. Agenten pushen, mergen, deployen oder verwenden niemals ssh auf einem Server, es sei denn, der Besitzer bittet um genau diese Aktion.
  • Jede Entscheidung kommt in DECISIONS.md (Datum, wer, warum). Beende jede Sitzung mit einer Zeile in SESSION_LOG.md.
  • „Erledigt“ bedeutet überprüft: Öffne die Seite, führe den Test aus, lese die Antwort des Servers. Wiederhole niemals das „Gelöst“ eines anderen Agenten, ohne es selbst überprüft zu haben.

6. Hilfreiche Skills aus anderen Kits (falls installiert)

  • agent-skills-kit: wordpress-modern, wp-plugin-development, wp-wpcli-and-ops, wp-performance für WordPress-API-Details.
  • agent-loop-kit: supervised-build, agent-supervisor für unbeaufsichtigte Builder-Schleifen mit einem Gate und einem Reviewer.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

umairmsm/wp-build

Stage 3 of a wp-site-kit WordPress build - local DDEV site, the core must-use plugin (modules), the presentation-only child theme with skins, the content model (custom post types, meta, WP_Query, render functions), and the enquiry pipeline that saves leads before forwarding. Use when building or changing features, templates, content types, forms or plugin modules on a wp-site-kit site.

umairmsm/wp-content

Stage 4 of a wp-site-kit WordPress build - real copy and photos. Content truth (facts only from the owner), AI drafts and owner approval, claims audits, banned words and fake proof, legal pages, the photo pipeline (dedupe, real-only, EXIF strip, WebP sizes, alt text, AI image register), and recorded content changes. Use for "write the copy", "add photos", "the owner sent new photos", "check for duplicates", "update prices or text on the live site", "legal pages".

umairmsm/wp-design

Stage 2 of a wp-site-kit WordPress build - design direction, a static HTML/CSS prototype with design tokens, owner sign-off with screenshots, self-hosted fonts, and porting the approved look into a swappable WordPress skin. Use for "design the site", "new look", "redesign", "change colours or fonts", "make a new skin", "port the prototype to WordPress".

umairmsm/wp-kickoff

Stage 1 of a wp-site-kit WordPress build. Use when starting a new WordPress website or taking over or rebuilding an existing one - discovery brief, stack decision, creating the project with bin/wp-site-new, locked decisions, private repo and credentials inventory. Triggers - "new WordPress site", "start a client website", "rebuild this site", "take over this WordPress site".

umairmsm/wp-operate

Stage 8 of a wp-site-kit WordPress build and everything after launch - backups with an off-machine copy, restore drills, the disaster-recovery runbook, credentials inventory, update policy, alerts, and working from more than one machine (bridge file, workstation doctor, encrypted state bundle, rescuing unpushed work). Use for "backup", "restore", "move to a new machine/server", "update plugins", "what if the server dies", "work from the cloud box", "set up a second machine".

umairmsm/wp-seo

Stage 5 of a wp-site-kit WordPress build - titles and descriptions, canonical URLs, one schema owner and JSON-LD, sitemaps, robots.txt and llms.txt, AI crawler access, redirects (301 vs 302), legacy URL maps, Search Console, and adding languages one pilot at a time with Polylang (hreflang, .po/.mo strings, native review). Use for "SEO", "schema", "redirect", "old URLs", "translate the site", "add French/Spanish", "hreflang", "canonical".

umairmsm/wp-ship

Stage 7 of a wp-site-kit WordPress build - staging behind Cloudflare Access, server hardening, safe deploys from a commit (scripts/deploy-safe.sh), database content changes, the launch audit, DNS cutover without breaking a running business, and the first week after launch. Use for "deploy", "set up staging", "go live", "launch", "cutover", "move DNS", "harden the server".

Verwandte Skills