Communitygithub.com

bbulman/information-architecture

Setze dieses Skill ein, wenn jemand die Organisation, Umstrukturierung oder Überprüfung der Gruppierung und Auffindbarkeit einer Website, App, Dokumentation, Wissensdatenbank oder Content-Bibliothek benötigt – auch wenn der Begriff „Informationsarchitektur“ nicht fällt. Nicht geeignet für klar abgegrenzte Einzelaufgaben wie einen reinen Baumtest oder eine reine Weiterleitungsübersicht.

Was ist information-architecture?

Dieses Skill definiert den Rahmen für die Arbeit an der Informationsarchitektur (IA) – also wie Inhalte und Funktionen eines Systems gruppiert, bezeichnet und verknüpft werden, damit Nutzer schnell und intuitiv finden, was sie brauchen. Es ist vorgelagert zu Design, Content-Entwicklung und Technik und verhindert spätere Workarounds in CMS, Navigation und URLs. Das Skill strukturiert den Prozess in sechs Schritte: (1) Auswahl der konkreten Teilleistungen (z.B. Content-Inventur, Navigation, Taxonomien), (2) Bestandsaufnahme und Nutzerkontext, (3) übergreifende Regeln (z.B. nach Aufgaben statt Organigramm strukturieren), (4) spezifische Hinweise für KI-gestützte Arbeit, (5) Integration mit anderen Skills bei größeren Projekten und (6) Mustererkennung für häufige Fehler. Es ist plattformunabhängig einsetzbar und eignet sich für Projekte in Codebasen, CMS, Content-Ordnern oder Datenbanken. Besonders wertvoll ist die Empfehlung, als KI niemals Entscheidungen zu treffen, sondern mehrere Optionen mit ihren Trade-offs vorzuschlagen und alle Artefakte (Sitemaps, URL-Strukturen, Navigationsspezifikationen, Content-Modelle, Redirect-Maps) vollständig auszuliefern.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bbulman/information-architecture-skill/tree/HEAD/skills/information-architecture

In Ihrer bevorzugten KI fragen

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

Dokumentation

Informationsarchitektur

Informationsarchitektur beschreibt, wie Inhalte und Funktionen eines Systems gruppiert, bezeichnet und verknüpft werden, damit Menschen das Gesuchte finden und verstehen, was sie tun können. Jede Entscheidung dient einem Test: Hilft diese Struktur der Person davor, schnell und ohne Anleitung eine gute Wahl zu treffen?

Sie ist alles anderem vorgelagert. Eine falsche Struktur belastet die Inhalte, die kein Zuhause haben, das Design, das zusätzliche Navigationen erfinden muss, die Suche, bei der URLs rotieren, und das CMS, das zum Sammelbecken von Workarounds wird.

Dieses Skill definiert den Umfang des Auftrags und hält die Regeln fest, die für das gesamte Projekt gelten. Die eigentliche Arbeit wird in den nachfolgenden Skills ausgeführt.

1. Die Arbeit auswählen

Die meisten Anfragen benötigen nur einen Teil des Werkzeugkastens. Nenne, was du liefern wirst, damit die Person weiß, was sie erhält.

AufgabeFühre in dieser Reihenfolge aus
Vorhandene Inhalte reorganisierencontent-inventory, card-sort oder taxonomies, sitemaps, url-structure (falls Adressen geändert werden), tree-tests, redirect-maps
Neue Website, App-Bereich oder Sektionsitemaps, navigation, url-structure, content-models
Menü, Navigation oder App-Switcher überdenkennavigation, labeling, tree-tests
Tags und Kategorientaxonomies
Namen, die nicht funktionierenlabeling
„Menschen finden X nicht“findability, dann das Skill, auf das die Diagnose verweist
Website verschieben oder neu aufbauensitemaps, navigation, url-structure, content-models, redirect-maps
Struktur vor dem Bau prüfentree-tests
KI-Funktion oder -ProduktAbschnitt 5 hier, dann findability

Ein reines Sitemap-Diagramm ist Dekoration. Für einen Website-Aufbau gehören dazu: Sitemap, URL-Regeln, Navigationsspezifikation, Content-Modell und bei einem Umbau eine Weiterleitungsübersicht. Ohne die anderen vier kann niemand darauf aufbauen.

Falls ein verwandtes Skill nicht verfügbar ist, erledige diesen Teil hier mit den nachfolgenden Regeln und weise darauf hin.

2. Rahmung und Bestandsaufnahme

Kläre vor jedem Schritt: Wer nutzt dieses System und was versuchen sie zu tun? Wie viele Inhalte gibt es jetzt und in zwei Jahren? Was will das Unternehmen damit erreichen? Wie wird der Erfolg gemessen? Halte die aktuellen Zahlen für diese Messgrößen fest, bevor sich etwas ändert – sonst gibt es später nichts Vergleichbares.

Dann erstelle das aktuelle Bild. Gestalte niemals nur von der Startseite aus neu.

  • In einer Codebasis: Lies Routen, Navigationskomponenten, die sitemap.xml, das CMS-Schema und alle Kategorien- oder Tag-Tabellen. Zähle Elemente pro Abschnitt. Leere und überladene Abschnitte sind bereits Erkenntnisse an sich.
  • In einem Content-Ordner: Erfasse den gesamten Korpus, nicht nur ein Element nach dem anderen. Gib zurück, was es ist und wem es zu dienen scheint, und lass die Person dich korrigieren, bevor du auf einer falschen Lesart aufbaust.
  • Inhalte in einer Datenbank oder einem CMS: Exportiere zuerst Titel, Typen, Tags und Daten.
  • Sehr große Datenmengen: Erfasse nach Typ und stichprobenartig innerhalb jedes Typs. Gib an, welche Stichprobe du gezogen hast, damit niemand eine Stichprobe mit einer Vollerhebung verwechselt.

Frage auch nach dem, was nur Menschen wissen: die Zielgruppen und ihre wichtigsten Aufgaben, wohin sich die Organisation entwickelt, Analysedaten, Site-Suchprotokolle und die Fragen, die der Support immer wieder beantworten muss.

3. Die Regeln, die für die gesamte Arbeit gelten

  • Strukturiere danach, was Menschen tun wollen, nie nach dem Organigramm. „Für Entwickler: APIs“ ist besser als „Über uns, Entwicklung, APIs“.
  • Gib jedem Element ein kanonisches Zuhause. Es kann von anderswo verlinkt sein, aber es lebt an einem Ort.
  • Achte auf Duft, nicht auf Klickzahlen. Menschen klicken weiter, wenn jeder Schritt klar nach ihrem Ziel riecht. Die Drei-Klick-Regel ist ein Mythos. Sackgassen und vage Bezeichnungen sind die wahren Kosten.
  • Gestalte für die zehnfache Inhaltsmenge. Wenn eine Kategorie wachsen wird, gestalte jetzt dafür.
  • Biete mehrere Zugänge. Browsen, Suche, Filter, verwandte Links, Breadcrumbs.
  • Platziere Hinweise dort, wo die Entscheidung fällt. Ein guter Hinweis beantwortet eine Frage, die die Person bereits hat, im Moment der Wahl, an der Stelle, wo sie bereits hinschaut – leise und günstig.
  • Gestalte für den nächstgrößeren Kontext. Eine Seite liegt in einem Abschnitt, ein Abschnitt in einer Website, eine Website in einem Unternehmen.

4. Arbeiten als KI an der IA

Was du gut kannst: Einen gesamten Korpus in Minuten lesen, alternative Schemata vorschlagen, eine Taxonomie konsistent auf Tausende von Elementen anwenden, beinahe doppelte Begriffe finden und Elemente identifizieren, die nirgendwo passen.

Was du nicht kannst: Einen Card Sort oder Tree Test mit echten Menschen durchführen oder die Strategie und Politik der Organisation kennen – es sei denn, es wird dir mitgeteilt. Deshalb:

  • Schlage vor, entscheide nicht. Gib zwei oder drei Schemata mit ihren Vor- und Nachteilen an, empfehle eines und begründe warum. Eine einzelne Antwort verbirgt die Entscheidung.
  • Ermittle Zielgruppe und Richtung zuerst. Wenn dir nicht gesagt wurde, für wen das Produkt ist und wohin es sich entwickelt, frage nach oder formuliere deine Annahme zu Beginn.
  • Platziere alles, was du platzieren solltest. Ein „Misfit“ bekommt sein am wenigsten schlechtes Zuhause und einen Hinweis; die Begründung für Verschiebung, Zusammenführung oder Stilllegung ist eine separate Empfehlung.
  • Liefere jedes angeforderte Artefakt aus. Wenn du denkst, eines sollte nicht existieren, liefere es trotzdem aus und argumentiere separat.
  • Erfinde niemals Forschungsdaten. Keine erfundenen Teilnehmerzahlen, Erfolgsraten, Ticketvolumina, Zitate oder Häufigkeiten. „Wird stündlich genutzt“ als Tatsache zählt. Sag „wahrscheinlich“ und liste es als Annahme.
  • Rate nicht über Plattformverhalten. Was ein Host oder CMS kann, variiert. Sag, was du erwarten würdest, und bitte die Person, es zu bestätigen.
  • Schütze die Inhalte. Bevor du Inhalte, Metadaten, Routen oder Weiterleitungen direkt bearbeitest, stelle sicher, dass die Arbeit versioniert oder gesichert ist.

5. IA für KI-Produkte und für Agenten-Kontext

Bevor du KI zu einem Produkt hinzufügst, suche nach dem, was tatsächlich im Weg steht. Wenn Menschen nicht erkennen können, wie das System funktioniert, seine Kategorien nicht unterscheiden können oder immer wieder die gleichen Fragen stellen müssen, behebt eine klarere Struktur, eine bessere Bezeichnung oder ein gut platzierter Hinweis das meist günstiger als ein Chat-Fenster. Buttons und Menüs erfüllen zwei Aufgaben: Sie ermöglichen Handlungen und zeigen, was das System kann. Ein offener Chat erledigt das erste langsam und das zweite gar nicht. Nutze Chat dort, wo die Aufgabe wirklich offen ist, und sonst KI hinter einer strukturierten Oberfläche.

Kontext für Agenten ist ebenfalls ein IA-Problem. Gib dem Modell die richtigen Informationen zur richtigen Zeit: eine kurze Einstiegsdatei, die auf tiefere Dateien verweist, ein kanonisches Zuhause für jede Tatsache, konsistente Namen und nichts geladen, was die Aufgabe nicht benötigt.

6. Wenn die Aufgabe mehrere Skills umfasst

Sofern nicht anders gewünscht, gib ein Dokument zurück mit:

  1. Zusammenfassung: die Empfehlung in zwei oder drei Sätzen und der Hauptgrund dafür.
  2. Aktueller Zustand: der aktuelle Baum und die darin enthaltenen Probleme, mit Zählwerten.
  3. Optionen: zwei oder drei Schemata, jeweils mit Angabe, wem sie dienen, was sie kosten und wo sie strapazieren.
  4. Vorschlag: der empfohlene Baum mit dem Vorlagentyp jedes Knotens, dann die Bezeichnungen und die Navigationsspezifikation, sowie die URL-Regeln und das Content-Modell, falls relevant.
  5. Migration: die Zuordnung von alt nach neu und Hinweise zur Neubeschriftung, falls sich etwas verschiebt.
  6. Annahmen und offene Fragen: alles, was du angenommen hast.
  7. Validierung: Aufgaben für einen Tree Test mit korrekten Antworten und Zielen, oder den durchzuführenden Card Sort.

Passe es an die Aufgabe an. Beginne mit der Empfehlung, halte jeden Abschnitt so kurz wie möglich, aber noch nutzbar, und schiebe lange Tabellen ans Ende. Ein längereres Dokument ist nicht gründlicher.

Prüfe die innere Konsistenz, bevor du es abgibst. Zähle Summen gegen die Platzierungstabelle, prüfe jede von dir aufgestellte Regel gegen die von dir geschriebenen Tabellen, überprüfe Behauptungen über Pfadlängen im Baum und stelle sicher, dass jede auslieferbare Datei jede Zeile des Plans umsetzt, aus dem sie stammt.

Um eine Informationsarchitektur – deine eigene oder die eines anderen – zu bewerten, bewerte sie mit references/rubric.md.

7. Muster, die du erkennen und benennen solltest

  • Organigramm-Navigation: Abschnitte, die nach Abteilungen benannt sind.
  • Zwei konkurrierende Taxonomien: Seitenleiste, Breadcrumbs und URL sagen jeweils etwas anderes.
  • Alles unter einem Dach: /services/<ding> für jeden Abschnitt – eine Schublade mit URL.
  • Platzhalter-Abschnitte: „Demnächst“-Seiten, die ausgeliefert werden. Bau es oder lass es weg.
  • Ein Chat-Fenster statt Struktur: eine offene KI-Oberfläche, wo klare Optionen die Frage schneller beantworten und den Menschen zeigen würden, wie das System funktioniert.

Individual skills in this repo

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

bbulman/findability

Use when people can't find something, when site search returns nothing or the wrong thing, when someone wants a search log analysed, best bets or synonyms set up, a no-results page designed or findability measured, or when a chatbot is proposed because "nobody can find anything". Not for redrawing the whole page tree, renaming a menu on its own, or running a tree test.

bbulman/labeling

Use when someone needs to name or rename a section, menu item, tab, category, feature or link, when labels feel vague or read like internal jargon, or when they ask "what should we call this", "is this label clear", "nobody knows what Resources means" or "people don't understand this menu". Not for deciding the structure behind the labels, building a tag vocabulary, or writing body copy and microcopy.

bbulman/navigation

Use when someone wants a navigation or menu designed, audited or cut down, including a main menu, nav bar, sidebar, app switcher, mega-menu, footer, breadcrumbs, tab bar or mobile menu, or says "there are too many items in the menu", "rethink the sidebar", "our nav is a mess" or "where should settings go". Not for deciding which pages exist, for wording a single label, for fixing site search, or for running a tree test.

bbulman/sitemaps

Use when someone needs the structure of a website, app or docs set decided, asking for a sitemap, site tree, page hierarchy or list of sections, or saying "what pages do we need", "how should we organise the site", "where should this page live" or "the site is too deep". This is where the structure gets decided. Not for writing the linked sitemap file that later design stages read once the structure is settled (design-os:create-sitemap), for generating sitemap.xml, or for designing the menus.

Verwandte Skills