MarketingOS Site Planner
Verwandelt das, was das Business-Gehirn bereits weiß, plus ein kurzes Interview und echte Recherche, in einen Website-Plan, den jemand umsetzen kann: ein Briefing, eine Intentionskarte und eine Spezifikation pro Seite. Der Plan ist das Ergebnis. Dieser Skill endet beim genehmigten Plan: er erstellt niemals Seiten, schreibt keine endgültigen Texte, richtet keine Weiterleitungen ein oder wählt visuelle Designs aus.
MarketingOS-Kontext und Voraussetzungen
Empfohlene Reihenfolge: mos-design-authentication → EmDash-Projektaufbau →
mos-design-site-planner → mos-atomic-design-system. Keiner dieser Schritte ist eine
zwingende Voraussetzung; wenn ein vorheriger Schritt nicht ausgeführt wurde, sagen Sie dies
einmal und fahren Sie fort.
Ermitteln Sie das aktive Business-Gehirn und das Website-Projekt aus der aktuellen Sitzung
und ihren Aufzeichnungen. Lesen Sie die BRAIN.md oder die Agentenanweisungen des Gehirns,
CONTEXT.md und business/ (Marke, Stimme, Zielgruppe, Angebote, Strategie, Nachweise,
Wettbewerber), bevor Sie etwas fragen. Wenn die mos-CLI verfügbar ist, zeigt
mos context show --json die Dateien hinter jedem Kontextfeld an. Halten Sie die Kontexte
jedes Unternehmens getrennt. Ohne MarketingOS arbeiten Sie mit den vom Benutzer bereitgestellten
Dateien und behandeln alles andere als eine Lücke.
Verwenden Sie Bun für die gebündelten Skripte; falls es fehlt, verweisen Sie den Benutzer auf
https://bun.com/docs/installation. Ermitteln Sie $SKILL für das tatsächliche Verzeichnis,
das diese SKILL.md enthält; Installationsorte unterscheiden sich je nach Agent.
Aufruf: /mos-design-site-planner in Claude Code, $mos-design-site-planner
in Codex. Stellen Sie Fragen mit AskUserQuestion in Claude Code und als nummerierte
Fragen mit Buchstaben-Optionen in Codex. Ein einziger erster Prompt steuert den gesamten
Workflow; behalten Sie jede Genehmigung im selben Gespräch.
Evidenzlabel
Jeder Recherche-Fund und jede Absichtsbehauptung trägt ein Label:
- gemessen: eine Zahl aus einem Tool oder Export (Search Console Klicks, ein Keyword-Volumen, eine Crawl-Zahl), mit der Zahl und einer datierten Quellen-ID.
- beobachtet: direkt an einem Datum gesehen, aber nicht gezählt (Autocomplete-Vorschläge, eine Ergebnisseite, „Leute fragen auch“, eine Konkurrenten-Sitemap, eine KI-Antwort), mit einer datierten Quellen-ID.
- angenommen: Begründung oder die Aussage des Benutzers, mit der niedergeschriebenen Begründung.
Ein Fund ohne Quelle gilt als angenommen oder wird weggelassen. Tool-Zugriff, Keyword-Volumen, „Leute fragen auch“-Fragen und Geschäftsfakten werden nur berichtet, wenn ein Durchlauf sie tatsächlich produziert hat.
Workflow
Speichern Sie den Fortschritt in <project>/site-plan/state.json nach jedem Schritt, damit
eine spätere Sitzung dort weiterarbeiten kann, wo diese aufgehört hat. Dateiformate, Vorlagen
und das State-Schema: references/output-format.md.
1. Vorab-Prüfung (Preflight)
Ermitteln Sie das Gehirn, das Website-Projekt (seine docs/project.md oder gleichwertige
Projektnotizen) und eine vorhandene Site-URL. Falls site-plan/state.json existiert, berichten
Sie den Stand und setzen Sie dort fort. Erkennen Sie, welche Recherche-Tools in dieser Sitzung
tatsächlich funktionieren: einen Search Console Export oder ein verbundenes Tool,
DataForSEO-Schlüssel, einen Crawler (Scrapling oder einfaches fetch), Websuche. Testen Sie
jedes; ein Schlüssel in der Umgebung, der seinen Testaufruf nicht besteht, ist nicht verfügbar.
Erkennungsschritte: references/research.md. Falls noch kein Website-Projekt existiert,
fragen Sie einmal, wo gespeichert werden soll; das outputs/YYYY/MM-Mon/YYYY-MM-DD-site-plan/
des Gehirns ist der Fallback.
Erledigt, wenn das Gehirn, das Projekt, der Speicherort, die vorhandene URL (oder „neue Site“)
und die Liste der funktionierenden Tools in state.json aufgezeichnet sind.
2. Was ich bereits weiß
Erstellen Sie die Karte aus dem Gehirn: Unternehmen, Dienstleistungen, Standorte und
Servicegebiet, Zielgruppe, Angebot, Stimme, Nachweise und primäre Aktion. Jeder Punkt nennt
seine Quelldatei und ist als bestätigt (eindeutig im Gehirn genannt), gefolgert
(zwischen den Zeilen gelesen) oder fehlend markiert. Zeigen Sie sie an und lassen Sie den
Benutzer sie korrigieren. Kartenformat: references/interview.md.
Erledigt, wenn der Benutzer die Karte bestätigt oder korrigiert hat.
3. Lücken-Interview (Gap-only interview)
Fragen Sie nur nach dem, was die Karte als gefolgert oder fehlend markiert, in Batches, jede
Frage mit einer empfohlenen Antwort und dem Grund dafür. Der Fragenkatalog deckt Ziele,
Geld-Dienstleistungen, bediente Standorte, neue Site vs. Ersatz, Funktionalität,
Nachweismaterialien, Wettbewerber und Einschränkungen ab:
references/interview.md. Design-Referenzen gehören zu
mos-atomic-design-system und den Design-Skills; lassen Sie sie hier weg.
Erledigt, wenn jedes Briefing-Feld beantwortet oder als LÜCKE aufgezeichnet ist.
4. Briefing bestätigen
Spielen Sie das Briefing auf einem Bildschirm ab: die Fakten mit ihren Quellen, die Lücken, den Rechercheplan und alle bezahlten Aufrufe mit ihren geschätzten Kosten. Fragen Sie vor dem Aufwenden von Recherchezeit oder -geld nach einem Ja.
Erledigt, wenn der Benutzer das Briefing genehmigt; zeichnen Sie es in decisions.md auf.
5. Recherche
Führen Sie jede Methode aus, die die Vorab-Prüfung als funktionierend erkannt hat:
Crawl der vorhandenen Site und URL-Inventar, Search Console Abfragen und Landingpages,
Keyword-Volumen (DataForSEO, falls Schlüssel vorhanden, sonst Autocomplete mit dem Label
„kein Volumen“), Ergebnisseiten und „Leute fragen auch“, Konkurrenten-Sitemaps und eine
optionale KI-Antwort-Prüfung. Fehlende optionale Quellen kommen auf die Liste der
Forschungslücken und die Arbeit wird fortgesetzt. Methoden, Fallbacks und Kostenberichterstattung:
references/research.md. Jede Quelle erhält eine datierte Zeile in
research/sources.md.
Erledigt, wenn jede Methode entweder gekennzeichnete Erkenntnisse oder einen Lückeneintrag hervorgebracht hat.
6. Seiten entscheiden
Gruppieren Sie die Abfragen in Intentionen, wenden Sie dann die Seitenregeln an: eine Seite pro
Intention, eine Dienstleistungsseite pro Geld-Dienstleistung, Standortseiten nur für bediente
Bereiche mit eindeutigem Inhalt, eine explizite Kannibalisierungsprüfung und eine
„Behalten, Zusammenführen, Weiterleiten oder Entfernen“-Entscheidung für jede vorhandene URL
mit Traffic oder Links. Verwenden Sie das bestehende Angebot und die Positionierung des Gehirns
als Rahmen. Regeln und Tests: references/page-rules.md.
Erledigt, wenn jede Intention einer Seite oder keine mit einem Grund zugeordnet ist und jede
vorhandene URL mit Traffic oder Links eine Migrationsaktion hat.
7. Jede Seite spezifizieren
Für jede Seite: URL, Titel-Tag, H1, Zweck, Zielintention und deren Nachweise,
Abschnittsgliederung, primärer CTA, echte Nachweise aus dem Gehirn (oder ein LÜCKE:-Marker),
interne Links und Schema-Typ. Schreiben Sie dann site-plan.md und sitemap.csv und führen
Sie den Validator im Entwurfsmodus aus:
bun $SKILL/scripts/check-site-plan.ts <project>/site-plan --draft
Erledigt, wenn die Entwurfsprüfung bestanden ist.
8. Genehmigungsschleife
Zeigen Sie den Sitemap-Baum, dann die Seitenspezifikationen in Batches von drei oder vier.
Für jede Seite genehmigt, bearbeitet oder entfernt der Benutzer sie; wenden Sie Bearbeitungen
an, führen Sie die Entwurfsprüfung erneut aus und zeigen Sie die Änderung. Zeichnen Sie jede
Entscheidung mit ihrem Datum in decisions.md auf. Wiederholen Sie, bis der Benutzer den
gesamten Plan genehmigt.
Erledigt, wenn die letzte Entscheidung jeder Seite und der Plan selbst als genehmigt markiert sind.
9. Speichern und übergeben
Schreiben Sie die endgültigen Dateien (site-plan.md, decisions.md, sitemap.csv,
research/), setzen Sie state.json auf genehmigt und führen Sie die vollständige
Prüfung aus:
bun $SKILL/scripts/check-site-plan.ts <project>/site-plan
Fügen Sie einen datierten Eintrag in die Projektnotizen (docs/project.md oder gleichwertig;
fragen Sie, bevor Sie einen erstellen) hinzu: was geplant wurde, wo es sich befindet, das
Prüfergebnis und der nächste Schritt, normalerweise mos-atomic-design-system. Wenn das
Website-Projekt bereits ein Git-Repository ist, stagen Sie die Planungsdateien mit explizitem
Pfad und committen Sie sie; stagen Sie niemals Secrets, .env-Dateien oder rohe
Tool-Antworten, und pushen Sie niemals. Commit-Regeln: references/output-format.md.
Enden Sie mit: was sich geändert hat, die Prüfausgabe, offene Lücken und Blockaden und die genaue nächste Aktion. Melden Sie eine Prüfung nur dann als bestanden, wenn sie in dieser Sitzung ausgeführt wurde und bestanden hat.
Referenzkarte
| Datei | Wann lesen? |
|---|---|
references/interview.md | Schritte 2 bis 4: die Karte, der Fragenkatalog, Batching und die Briefing-Wiedergabe |
references/research.md | Schritte 1 und 5: Tool-Erkennung, jede Recherchemethode, Fallbacks und Kosten |
references/page-rules.md | Schritt 6: Intentions-Clustering, Standortseiten, Kannibalisierung, die Migrationskarte |
references/output-format.md | Schritte 7 bis 9: die vom Validator erzwungenen Formate, Status, Entscheidungen und Commits |
assets/ | Startvorlagen für jede Ausgabedatei |
scripts/check-site-plan.ts | --help; in den Schritten 7 bis 9 ausführen |
scripts/test-check-site-plan.ts | Nachweis, dass der Validator bei jedem defekten Plan fehlschlägt |
Verwandte Skills
Optionale Folgeskills aus dem MarketingOS GEO-Paket (mos-geo-skills), hier benannt und
separat installiert: mos-geo-topic-clusters zum Clustern eines großen Search Console- oder
Ahrefs-Exports vor Schritt 6, mos-geo-brand-360 für die KI-Antwort-Prüfung und
mos-geo-fan-out-map, sobald die Site live ist.