bbulman/sitemaps

Was macht sitemaps?

Eine Sitemap legt fest, was existiert, wo jeder Inhalt lebt und wie viele Entscheidungen eine Person von ihm trennen. Menüs, URLs, Vorlagen und Weiterleitungen werden aus dieser Entscheidung abgeleitet, daher belastet ein falscher Baum alles Nachgelagerte.

Was du zuerst brauchst

Eingabe	Woher sie kommt	Wenn sie fehlt
Die aktuelle Struktur	In einer Codebasis zuerst die Routen, Navigationskomponenten, sitemap.xml, das CMS-Schema und Kategorientabellen lesen. Niemals nur von der Startseite aus neu gestalten.	Nach einer URL-Liste oder einem Export fragen. Wenn nichts vorhanden ist, den Baum als leere Vorlage kennzeichnen.
Inhaltsmenge, jetzt und in zwei Jahren	Elemente pro Abschnitt zählen. Leere und überladene Abschnitte sind Erkenntnisse.	Nach einer groben Schätzung fragen. Falls nicht möglich, zeigen, welche Form die jeweilige Größe wahrscheinlich erfordert.
Zielgruppen und Hauptaufgaben	Der Benutzer, Analysen, Suchprotokolle, Fragen, die der Support ständig beantwortet	Fragen oder die Annahme oben im Ergebnis notieren.
Wohin sich die Organisation entwickelt	Der Benutzer	Fragen. Ein allgemeines Briefing führt zu einem allgemeinen Baum.

Ein Ordner mit Inhalten: die gesamte Sammlung vor der Gruppierung überblicken, dann zurückmelden, was es ist und wem es zu dienen scheint, damit der Benutzer dich korrigieren kann. Eine Datenbank oder ein dynamisches CMS: zuerst Titel, Typen, Tags und Daten exportieren. PDFs und andere Binärdateien: in Text konvertieren und angeben, wie gut die Konvertierung war. Eine sehr große Sammlung: nach Typ überblicken, innerhalb jedes Typs eine Stichprobe nehmen und angeben, was du beprobt hast.

Wenn du nichts davon erhalten kannst, sag, was du bräuchtest, und übergib das Baumformat in references/tree-format.md mit den für diese Art von Website vorgeschlagenen Knotentypen.

Methode

1. Zeichne, was existiert. Den aktuellen Baum, eine Zählung pro Abschnitt und seine Probleme: Überschneidungen, Leerstellen, Waisen, alles, was nach Abteilung sortiert ist.

2. Bemesse es. Verwende die Gesamtmenge in zwei Jahren, nicht die heutige.

   Elemente	Struktur
   Unter 50	Flach, 1 bis 2 Ebenen
   50 bis 500	2 bis 3 Ebenen
   500 bis 5.000	3 bis 4 Ebenen plus Facetten
   Über 5.000	Durchsuchen, Suche und Facetten zusammen

3. Wähle die Form aus dem Inhalt, niemals aus dem Organigramm.

   Der Inhalt	Form	Was sie kostet
   Einige wenige klare Angebote, unter etwa 50 Seiten	Hub-and-Spoke: einige breite, flache Abschnitte, jeder ein Klick von der Startseite entfernt. Der Standard für Marketing-Websites.	Die Startseite übernimmt die gesamte Weiterleitung. Wenig Raum zum Wachsen vor einem Neuschnitt.
   Wirklich kategorisch, wie ein großer Katalog oder Branche für Branche	Tiefe Hierarchie	Jede Ebene kostet einen Klick und ein wenig Duft. Eine falsche frühe Entscheidung führt in die Irre.
   Meist flach mit ein bis zwei dichten Bereichen wie Dokumentation oder einer Bibliothek	Hybrid: Hub-and-Spoke oben, eine schmale Hierarchie innerhalb dieser Abschnitte. Die übliche Antwort für größere Websites.	Zwei Navigationsmodelle, die erstellt und erklärt werden müssen.
   Elemente, die Personen auf verschiedene Weise schneiden, oder eine Kategorie, die eine Liste überwuchern wird	Facetten: unabhängige Dimensionen, die sich als Filter kombinieren lassen	Saubere Metadaten für jedes Element und jemand, der sie pflegt.

4. Erstelle zwei oder drei Alternativen, entlang verschiedener Achsen geschnitten (nach Aufgabe, nach Zielgruppe, nach Inhaltstyp), nicht drei Versionen einer Idee. Gib für jede an, wem sie dient, was sie kostet und wo sie schwächelt. Empfehle eine und begründe warum. Eine einzelne Antwort verbirgt die Entscheidung.

5. Gib jedem Element ein kanonisches Zuhause. Es kann von anderswo verlinkt sein, aber es lebt an einem Ort, an dem die Leute es erwarten. Zwei Zuhause teilen Suchergebnisse, Links und Wartung.

   Ein Element scheint an zwei Orte zu gehören	Entscheidung
   Eine Handvoll echter Querschnitts-Elemente	Ein Zuhause, Querverweise von den anderen
   Viele Elemente gehören an mehrere Orte	Der Baum ist entlang der falschen Achse geschnitten. Verwende Facetten.
   Du kannst nicht sagen, wo die Leute suchen würden	Das wahrscheinlichste Zuhause wählen und für den Baumtest markieren

6. Kommentiere jeden Knoten. Jeder erhält einen Vorlagentyp; ein Knoten ohne Vorlage bedeutet normalerweise, dass die Idee nicht fertig ist. Markiere neue, verschobene und gelöschte Knoten. Verwende einen Musterknoten wie /guides/<slug> für sich wiederholende Seiten und setze facets: und items: auf die Knoten, die sie haben.

7. Belaste ihn. Bei der zehnfachen Menge: Wird ein Abschnitt zu einer Liste, die niemand überblicken kann? Gestalte jetzt Unterabschnitte oder Facetten, nicht später. Dient der Baum dem nächstgrößeren Kontext, dem umgebenden Produkt oder Geschäft? Bildet ein Abschnitt eine Abteilung und keine Aufgabe ab? Mehr als 9 auf einer Ebene oder 4 tief braucht einen Grund – und „die Drei-Klick-Regel sagt das“ ist keiner, weil diese Regel ein Mythos ist: Leute klicken weiter, solange jeder Schritt deutlich nach ihrem Ziel riecht. Lies references/depth-and-shape.md, wenn Tiefe und Breite umstritten sind oder wenn du den Baum eines anderen überprüfst.

Ergebnis

Schreibe sitemap-tree.txt, den vorgeschlagenen Baum und nichts weiter, weil die Prüfung ihn liest:

/                          home
├── /guides                section-hub   items: 40
│   └── /guides/<slug>     guide
├── /products              listing       items: 120  facets: use, price
│   └── /products/<slug>   product
├── /pricing               marketing     (new)
└── /about                 marketing     (moved from /company)

Schreibe dann sitemap.md in dieser Reihenfolge:

1. Empfehlung: zwei oder drei Sätze und der Hauptgrund.
2. Was jetzt existiert: der aktuelle Baum und seine Probleme, mit Zählungen.
3. Optionen: eine Zeile pro Struktur, mit Spalten: organisiert nach, dient, kostet, schwächelt bei.
4. Vorgeschlagener Baum: der genaue Text von sitemap-tree.txt in einem Code-Block.
5. Platzierungen: Element, Zuhause, Hinweis. Nur wenn gefragt wird, wohin Dinge gehören.
6. Annahmen und offene Fragen: alles, was du angenommen hast, vor allem Zielgruppe und Richtung.
7. Validierung: die riskantesten Platzierungen, für Baumtests.

Skaliere es herunter. Eine 12-Seiten-Website braucht die Empfehlung, den Baum und eine dreizeilige Optionstabelle. Ein längeres Dokument ist kein gründlicheres. Eine Aufforderung, jedes Element zu platzieren, bedeutet, dass jedes Element ein Zuhause bekommt: Gib einem Fehlplatzierten sein am wenigsten schlechtes Zuhause, markiere es und argumentiere separat für Verschieben, Zusammenführen oder Löschen.

Prüfe es

node "${CLAUDE_SKILL_DIR}/scripts/tree-check.mjs" sitemap-tree.txt

Es meldet Tiefe und Breite pro Zweig, doppelt vorkommende Bezeichnungen, Knoten ohne Vorlage, Sonstige- oder Diverse-Knoten und Elemente pro Abschnitt. Verwende sein Ergebnis, nicht deine eigene Lesart des Baums. Exit 1 bedeutet Warnungen: korrigiere jede oder schreibe eine Zeile in sitemap.md, die erklärt, warum die Ausnahme besteht. Übergib --items N, wenn der Baum keine Zählungen hat.

Dann von Hand: Zähle die Platzierungen gegen die Gesamtzahlen, verfolge jede Behauptung über die Pfadlänge durch den Baum und bestätige, dass der Code-Block in sitemap.md mit der Datei übereinstimmt.

Was Claude hier nicht kann

• Die Strategie oder Politik der Organisation kennen, es sei denn, sie wird mitgeteilt. Der Baum ist ein Entwurf, auf den reagiert werden kann, und die Entscheidung liegt beim Menschen.
• Traffic, Nutzung oder Forschung erfinden. Das schließt Häufigkeitswörter ein, die als Tatsache genannt werden, wie „täglich genutzt“. Sag „wahrscheinlich“ und führe es als Annahme auf.
• Einen Baumtest oder eine Kartensortierung mit echten Menschen durchführen. Entwirf sie und analysiere die Ergebnisse, die der Benutzer zurückbringt.
• Versprechen, was ein CMS kann. Sag, was du erwarten würdest, wie verschachtelte Routen oder Facettenfilter, und bitte den Benutzer, es zu bestätigen, weil die Plattformunterstützung variiert.

Wo dies übergeben wird

Eine Sitemap allein ist Dekoration: Niemand kann daraus bauen ohne URL-Regeln, eine Navigationsspezifikation, ein Inhaltsmodell und – bei einem Umbau – einen Weiterleitungsplan.

• information-architecture: die Eingangstür, wenn die Aufgabe mehrere dieser Bereiche umfasst.
• content-inventory: wenn noch niemand weiß, was existiert. card-sort: wenn die Gruppierungen von den Benutzern kommen sollen.
• taxonomies: wenn der Baum Facetten oder Tags benötigt. labeling: um die Knotennamen zu formulieren.
• navigation, url-structure und content-models: um Knoten in Menüs, Adressen und Vorlagen umzuwandeln.
• redirect-maps: wenn sich etwas verschiebt.
• tree-tests: um den Baum vor dem Bauen zu validieren. findability: um ihn danach zu messen.
• design-os:create-sitemap: um den vereinbarten Baum als verlinkte Datei zu schreiben, die spätere Designphasen lesen.