bbulman/labeling

Labeling (Bezeichnungen)

Labels sind die Wörter, die den Leuten sagen, was sich hinter einer Tür verbirgt, bevor sie sie öffnen. Dieser Skill dient der Entscheidung, wie jedes Ziel, jeder Abschnitt oder jede Aktion heißt und welches Benennungssystem auf jeder Ebene verwendet wird. Der Test für jedes Label: Könnte ein Neuling vorhersagen, was dahintersteckt?

Bevor Sie beginnen

Sie benötigen	Wenn es fehlt
Die aktuellen Labels, jeweils mit dem, was dahintersteckt und wo es erscheint	Lesen Sie die Navigation oder fragen Sie danach. Wenn es noch nichts gibt, liefern Sie die leere labels.csv und den Testplan.
Wer sie liest und was diese Personen versuchen zu tun	Fragen Sie. Wenn keine Antwort kommt, geben Sie Ihre Annahme oben an.
Die eigenen Worte der Nutzenden: Suchprotokolle, Supportfragen, Kartensortierungs-Gruppennamen, Interviews, Bewertungen	Erstellen Sie einen Entwurf auf Basis des Inhalts und der Konventionen ähnlicher Produkte, markieren Sie jedes Label als untested (ungetestet) und liefern Sie den Testplan, damit die Wörter überprüft werden können. Präsentieren Sie niemals eine Vermutung als die Sprache der Nutzenden.

Methode

1. Listen Sie die Labels im Kontext auf. Halten Sie für jedes Label die Gruppe (die gemeinsam gesehenen Labels), das Ziel und das, was wirklich dahintersteckt, fest. Ein Label ohne seine Geschwister zu beurteilen, ist der Weg, wie Überschneidungen übersehen werden.

2. Sammeln Sie die Wörter der Nutzenden. Ihre Wörter sind die ersten Kandidaten; Ihre internen Begriffe sind es nicht.

   Quelle	Was sie Ihnen liefert	Achten Sie auf
   Suchprotokolle	Die exakt eingegebenen Wörter, die stärksten Trigger-Wörter	Führen Sie den Findability-Skill-Logbericht aus; schätzen Sie niemals Volumen
   Supportfragen	Wie die Leute das Bedürfnis beschreiben	Menschen in Not formulieren Dinge anders
   Kartensortierungs-Gruppennamen	Wie die Leute ein Cluster nennen	Verwenden Sie ihre häufigsten Wörter
   Interviews, 5 bis 10 Personen	Wortschatz und was Wörter für sie bedeuten	Hören Sie auf das Wort, das sie unaufgefordert verwenden
   Ähnliche Produkte	Wörter, die die Leute bereits gelernt haben	Vertrautheit schlägt Cleverness

3. Wählen Sie ein Benennungssystem pro Ebene aus. Wenn man sie in einem Menü mischt, beantwortet jeder Punkt eine andere Frage, und die Leute können sie nicht vergleichen.

   System	Beispiel	Funktioniert, wenn	Bricht, wenn
   Aufgabe	„Sendung verfolgen“	Leute kommen mit einer zu erledigenden Aufgabe	Aufgaben überschneiden sich oder die Liste wird lang
   Zielgruppe	„Für Entwickler“	Gruppen benötigen unterschiedliche Inhalte und können sich selbst einordnen	Jemand ist in zwei Gruppen oder weiß nicht, zu welcher er gehört
   Thema	„Abrechnung“	Das Thema entspricht der Denkweise der Leute	Die Themen sind die der Organisation, nicht die der Nutzenden
   Format	„Videos“, „Vorlagen“	Leute wählen nach Format aus	Ihnen liegt zuerst das Thema am Herzen
   A bis Z	Glossare, Verzeichnisse	Leute kennen den genauen Namen	Sie stöbern, um zu entdecken

4. Schreiben Sie Kandidaten nach diesen Regeln.

   Regel	Schwach	Stärker
   Spezifisch und vertraut, kein „Mystery Meat“	Ressourcen, Lösungen, Entdecken	Anleitungen und Vorlagen
   Parallelkonstruktion zwischen Geschwistern	Preise, Erste Schritte, Für Teams	Preise, Einrichtung, Teams
   Das unterscheidende Wort nach vorne	Berichtseinstellungen, Berichtsverlauf	Einstellungen, Verlauf, unter Berichte
   Eine Sache, ein Name überall	„Team“ im Menü, „Personen“ auf der Seite	Wählen Sie eines und verwenden Sie es in Navigation, Titel und Breadcrumb
   Die Tür passt zum Raum	„Pläne“ öffnet „Wählen Sie Ihr Abonnement“	Linktext und Seitenüberschrift stimmen überein
   Linktext sagt, was Sie bekommen	Mehr erfahren	Onboarding-Checkliste herunterladen

5. Entscheiden Sie, was mit internen Namen passiert.

   Der Name ist	Tun Sie dies
   Ein Team-, Abteilungs- oder Projektcodename	Zeigen Sie ihn niemals. Nennen Sie, wozu die Person gekommen ist
   Ein Markenname für eine Funktion, die die Leute lernen müssen	Kombinieren Sie ihn bei jeder Navigation mit einem einfachen Deskriptor
   Ein Kunstbegriff, den das Publikum wirklich verwendet	Behalten Sie ihn, auch wenn Außenstehende ihn nicht kennen würden, und testen Sie ihn mit diesem Publikum
   Ein rechtlicher oder regulatorischer Begriff	Behalten Sie den genauen Begriff und setzen Sie eine einfache Erklärung daneben
   Ein Akronym	Schreiben Sie es aus, es sei denn, das Publikum sucht mehr nach dem Akronym als nach den Wörtern

6. Bieten Sie für jedes umstrittene Label zwei oder drei Optionen an, mit Angabe der Vor- und Nachteile jeder Option, und empfehlen Sie eine. Eine einzelne Antwort verbirgt die Entscheidung.

7. Verstärken Sie die Duftspur um das Label. Kurzbeschreibungen, Elementanzahlen, Breadcrumbs und aktive Zustände tragen das, was das Wort allein nicht kann. Lesen Sie references/information-scent.md, wenn Labels für sich genommen in Ordnung sind, die Leute aber trotzdem abspringen.

8. Testen Sie die Vorhersagbarkeit. Zeigen Sie in eine Richtung das Label allein und fragen Sie, was die Leute dahinter erwarten; in die andere Richtung geben Sie ein Ziel und fragen, welches Label sie wählen würden. Als ersten Durchgang können Sie kalt lesen: Decken Sie das Ziel ab, schreiben Sie, was Sie erwarten würden, und vergleichen Sie. Berichten Sie das als Ihre eigene Einschätzung, nicht als Forschung. references/predictability-test.md enthält den Plan und die Bewertung.

9. Überprüfen Sie andere Sprachen. Wenn die Labels übersetzt werden, lesen Sie references/locales.md, bevor Sie sie festlegen. Übersetzen Sie nach Sinn, nicht Wort für Wort, und testen Sie erneut mit Personen in diesem Markt.

Liefergegenstand

Schreiben Sie diese, es sei denn, der Nutzer nennt andere Dateien.

• labels.csv, eine Zeile pro Label: group,label,destination,system,was,evidence,status. evidence gibt an, woher das Wort stammt (Suchprotokoll, Support, Annahme). status ist kept (behalten), renamed (umbenannt) oder new (neu), plus tested (getestet) oder untested (ungetestet), getrennt durch ein Semikolon: renamed; untested.
• labels.md, in dieser Reihenfolge: Empfehlung (zwei bis drei Sätze); Das gewählte System für jede Ebene; Umstrittene Labels (Optionen, Abwägungen, die Wahl und warum); Interne Namen und was mit jedem passiert; Wie zu testen ist; Annahmen und offene Fragen. Die vollständige Liste lebt nur in labels.csv, daher dürfen die beiden nicht widersprechen.

Aufgabe	Rückgabe
Ein Ding umbenennen	Drei Optionen mit Abwägungen, eine Wahl und eine Testfrage, in der Antwort
Ein Menü überprüfen	Die labels.csv-Zeilen und eine kurze Liste der Änderungen
Eine ganze Website oder App	Beide Dateien

Ein längeres Dokument ist kein gründlicheres.

Überprüfen Sie es

Führen Sie die mechanische Prüfung aus und verwenden Sie ihre Zählungen:

node "${CLAUDE_SKILL_DIR}/scripts/label-check.mjs" labels.csv

Sie findet vage Wörter, Duplikate in einer Gruppe, Geschwister, die mit demselben Wort beginnen, Gruppen mit gemischten grammatikalischen Formen, ein Label mit mehreren Zielen und ein Ziel mit mehreren Labels. Die Formprüfung feuert nur bei klaren Mustern, also lesen Sie jede Gruppe selbst auf parallele Konstruktion hin. Überprüfen Sie dann:

• Jede Gruppe verwendet ein Benennungssystem, und labels.md gibt an, welches.
• Jedes Label ist als tested oder untested markiert. Ein sauberer Skriptdurchlauf beweist nichts über das Verständnis.
• Jedes Label evidence ist echt. Wenn es eine Annahme ist, sagt die Zeile das.

Was Claude hier nicht tun kann

Sie können nicht lernen, was echte Menschen verstehen, indem Sie ein Label selbst lesen, und Sie können die Strategie, Markenverpflichtungen oder Politik der Organisation nicht kennen, es sei denn, es wird Ihnen mitgeteilt. Erfinden Sie niemals Nutzungszahlen, Suchvolumina, Testergebnisse oder Zitate. Schlagen Sie Alternativen mit ihren Abwägungen vor, empfehlen Sie eine und sagen Sie warum; der Mensch trifft die Entscheidung, insbesondere wenn ein Name Marken- oder Rechtsgewicht hat.

Übergabe an andere Skills

Nächster Bedarf	Skill
Die Gruppen selbst sehen falsch aus	card-sort, sitemaps
Welche Labels in welches Menü kommen	navigation
Begriffe für Tags und Filter	taxonomies
Ein umbenannter Abschnitt ändert seine Adresse	url-structure, redirect-maps
Testen von Labels in einer Hierarchie	tree-tests
Umbenennung hat „Leute finden es nicht“ nicht behoben	findability
Eine Liste dessen, was zuerst existiert	content-inventory
Felder hinter einer Vorlage	content-models
Eine komplette Website-Umstrukturierung oder Unsicherheit, wo anzufangen	information-architecture