Communitygithub.com

bbulman/navigation

Verwenden, wenn jemand eine Navigation oder ein Menü entwerfen, prüfen oder reduzieren möchte – Hauptmenü, NavBar, Sidebar, App Switcher, Mega-Menü, Footer, Breadcrumbs, Tab-Leiste oder mobiles Menü – oder sagt: „Im Menü sind zu viele Einträge“, „Überdenke die Sidebar“, „Unsere Navi ist ein Chaos“ oder „Wohin mit den Einstellungen“. Nicht geeignet, um zu entscheiden, welche Seiten existieren, um einen einzelnen Eintrag zu formulieren, um die Seitensuche zu reparieren oder um einen Baumtest durchzuführen.

Was ist navigation?

Dieses Skill beschreibt eine systematische Methode zur Navigation für Websites und Apps. Es hilft dabei, jede Navigationsfläche zu katalogisieren, globale von lokalen Elementen zu trennen und für jede Fläche (Primärnavigation, Utility, Footer, Kontextnavigation, Tab-Leiste) klare Aufnahmeregeln zu definieren. Das Skill unterstützt Agenten auf allen gängigen Plattformen wie Claude Code, Cursor, Codex, GitHub Copilot und Windsurf und arbeitet mit Markdown, sitemap.xml, Quellcode-Strukturen und vorhandenen UX-Frameworks zusammen. Im Kern wird eine schrittweise Vorgehensweise beschrieben: Karte erstellen, trennen, Aufnahmeregel anwenden, Allokation vorschlagen, bis zu drei Anordnungen anbieten, das passende Muster wählen (Mega-Menü, Dropdown, Breadcrumbs etc.), mobile und Tastaturzugänglichkeit von Anfang an berücksichtigen, Hinweise an den Entscheidungsstellen platzieren und Ausstiegswege für Elemente planen. Das Ergebnis ist ein ‚navigation-spec.md‘-Dokument mit Empfehlung, Ist-Zustand, Optionen, Spezifikation, kanonischen Zielseiten, Vorher-Nachher-Tabelle, Aufnahmeregel, Annahmen und Übergabe an den ‚tree-tests‘-Skill. Es grenzt sich klar von verwandten Skills ab (Informationsarchitektur, Sitemaps, Labeling, Taxonomien, URL-Struktur, Redirect-Maps, Content-Modelle, Tree-Tests, Findability, Content-Inventory, Card-Sort) und gibt explizit an, was Claude nicht kann: Geschäftsstrategie, Traffic, Nutzungsdaten erfinden oder reale Tree-Tests durchführen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht navigation?

Navigation entscheidet, welche Teile der Struktur einen festen Platz auf dem Bildschirm erhalten und welche auf andere Weise erreicht werden. Die Plätze sind knapp, und jede Oberfläche hat ihre eigene Regel, was sich einen verdient.

Was Sie zuerst brauchen

EingabeWoher sie kommtWenn sie fehlt
Jede Oberfläche im aktuellen ZustandIn einer Codebasis zuerst die Routen und die Navigationskomponenten (Header, Footer, App Switcher, Sidebars, Tab-Leisten) lesen. Nie nur von der Startseite aus neu entwerfen.Screenshots oder eine getippte Liste der Einträge pro Oberfläche anfordern.
Der dahinterliegende BaumEine Sitemap oder die RoutenDen aktuellen Baum selbst kartieren und dies angeben. Wenn die Struktur selbst falsch ist, stoppen und sitemaps verwenden.
Top-Aufgaben, die, bei denen Leute scheitern, und NutzungDer Benutzer, Analytics, Suchprotokolle, wiederholte SupportfragenFragen oder die Annahme zu Beginn nennen. Nie Nutzung schätzen; sagen, welche Entscheidungen sich ändern würden, wenn man sie hätte.

Wenn Sie nichts davon bekommen können, sagen Sie, was Sie bräuchten, und erstellen Sie die leere Spezifikation aus references/spec-template.md mit den ausgefüllten Aufnahmeregeln.

Methode

  1. Jede Oberfläche kartieren. Oberfläche, Eintrag, Ziel, Anzahl. Dasselbe Ziel unter zwei Namen markieren, Einträge, die nirgendwo hinführen, und alles, was nur zufällig in einer Oberfläche existiert.

  2. Global von lokal trennen.

    GlobalLokal
    AufgabeWas dieser ganze Ort bietetWas auf dieser Seite umliegt
    ZeigtDasselbe auf jeder SeiteNur innerhalb ihres Bereichs
    OberflächenPrimär, Utility, FooterSidebar, Seiteninhalt, Breadcrumbs, verwandte Links
    Geht schief, wennSie die Kinder eines Bereichs auflistetSie die globalen Einträge wiederholt

    Ein Bereich, der mehr als zwei Navigationsebenen benötigt, will normalerweise eine eigene Sidebar oder eine eigene Startseite.

  3. Jeder Oberfläche eine Aufnahmeregel geben und auf jeden Eintrag anwenden.

    OberflächeWas gehörtWas nicht gehörtAufnahmeregel
    PrimärDie 3 bis 6 Ziele, die für Benutzer und Unternehmen am wichtigsten sindAlles, was sich den Platz nicht verdient hatDient einer Top-Aufgabe oder einem genannten Geschäftsziel, ergibt für Neulinge Sinn und schlägt den schwächsten bereits vorhandenen Eintrag
    UtilityAnmeldung, Konto, Suche, Sprache, EinstellungenMarketing-gereihte EinträgeBetrifft die Sitzung der Person oder das Werkzeug, nicht den Inhalt
    FooterDie vollständigere Sitemap, Rechtliches, Kontakt, sekundäre HandlungsaufforderungenEine Schublade für Allerlei (Menschen und Crawler lesen ihn immer noch)Jemand braucht ihn von jeder Seite aus, oder das Gesetz verlangt es; er passt in eine benannte Gruppe
    KontextuellSidebars, Seiteninhalt, Breadcrumbs, verwandte LinksAlles GlobaleErgibt nur hier einen Sinn und wird durch eine geschriebene Regel platziert
    App-Tab-LeisteHöchstens 5 Tabs; ein 6. wird zu „Mehr“ oder gestrichenSelten genutzte ZieleEine wiederholte, übergeordnete Aufgabe im Produkt
  4. Allokieren. Mehr als sieben primäre Einträge als Zeichen dafür behandeln, dass einige ihren Platz nicht verdienen: Zusammenführen oder in den Footer verschieben. Fast-Zwillinge zu einem Eintrag zusammenführen. Jeder Aufgabe, bei der Leute scheitern, eine kanonische Zielseite geben und angeben, dass jeder andere Einstiegspunkt dorthin führt.

  5. Zwei oder drei Anordnungen anbieten (nach Aufgabe, nach Objekt, nach Zielgruppe), jeweils mit Kosten und wo es eng wird. Eine empfehlen und begründen.

  6. Das Muster wählen.

    SituationVerwendenHinweis
    Ein Eintrag hat drei oder mehr Untergruppen mit eigenen KindernMega-MenüTastaturfokus und mobile Version als separate Arbeit entwerfen
    Eine kurze flache Liste von KindernEin einfaches Dropdown oder ein Link zu einer Hub-SeiteOft ist die Hub-Seite besser
    Tiefe von drei Ebenen oder mehrBreadcrumbsJeder Krümel ist eine echte Seite. Ein Pfad pro Seite, der dem kanonischen Zuhause folgt, nicht dem Weg, den die Person genommen hat.
    Lange ReferenzseitenSeiteninhaltNur lokal
    Unterschiedliche Rollen benötigen unterschiedliche StartpunktePersonalisierte AbkürzungenDie Abkürzungen personalisieren, nicht die Karte. Wenn alle ein anderes Menü sehen, können Leute keine Wegbeschreibungen geben, Support kann nicht beschreiben, wo Dinge sind, und Analytics hören auf, etwas zu bedeuten.
  7. Mobil und Tastatur jetzt entwerfen. Auf mobilen Geräten angeben, wie die Primärnavigation zusammenklappt, was sichtbar bleibt und was mit jedem Mega-Menü passiert. Auf der Tastatur muss jeder Eintrag in visueller Reihenfolge erreichbar sein, der Fokus sichtbar sein, Escape das schließen, was Enter geöffnet hat, und nichts funktioniert nur durch Hover. Details sind in references/mobile-and-keyboard.md; sie für jedes Menü lesen, das sich öffnet.

  8. Hinweise dort platzieren, wo die Entscheidung fällt. Ein guter Hinweis beantwortet eine Frage, die die Person bereits hat, im Moment der Wahl, dort, wo sie bereits hinschaut, leise und günstig. Der Pfeil neben der Tankanzeige eines Autos, der zeigt, auf welcher Seite der Tankdeckel ist, ist das Vorbild. Die aktuelle Position mit einem aktiven Zustand anzeigen.

  9. Planen, wie Einträge verschwinden. Einen Link zu entfernen ist nicht dasselbe wie eine Seite zu entfernen.

    SchrittWas zu tun ist
    Sein Schicksal entscheidenZusammengeführt, in den Footer oder Utility verschoben, nur durch Suche erreichbar oder weg
    Wenn die Seite verschwindetZur Redirect-Map hinzufügen
    Wenn sie bleibtBestätigen, dass ein anderer Pfad sie noch erreicht
    Leute informierenIn einem angemeldeten Produkt einen Hinweis an der alten Stelle für ein oder zwei Releases belassen und Hilfsartikel, Touren und E-Mails korrigieren, die den alten Pfad nennen
    Das Wort behaltenDas alte Label als Suchsynonym belassen, dann Suche und Support darauf beobachten
  10. Validierung an tree-tests übergeben. Es schreibt den Plan und die Aufgaben. Ihm jedes Problem übergeben, das die Arbeit ausgelöst hat, jede unsichere Platzierung und die vorgeschlagenen Antworten. Ziele: mindestens 70 % Erfolg, 80 % für Top-Aufgaben, Pfadverhältnis maximal 1,5.

Liefergegenstand

navigation-spec.md, in dieser Reihenfolge:

  1. Empfehlung: zwei oder drei Sätze und der Hauptgrund.
  2. Ist-Zustand: jede Oberfläche, ihre Anzahl, ihre Probleme.
  3. Optionen: eine Zeile pro Anordnung, mit ihren Kosten.
  4. Die Spezifikation: pro Oberfläche, Label und Ziel, und warum jeder primäre Eintrag seinen Platz verdient. Dann Breadcrumb-Muster, mobil, Tastatur und aktiver Zustand.
  5. Kanonische Zielseiten: jede Problemaufgabe, ihr einziges Ziel und die Einstiegspunkte, die dorthin führen.
  6. Vorher und Nachher: jeder aktuelle Eintrag und wohin er gegangen ist, einschließlich was eingestellt wurde und wie.
  7. Aufnahmeregel: der Test, den ein neuer Eintrag auf oberster Ebene bestehen muss.
  8. Annahmen und offene Fragen.
  9. Übergabe an tree-tests: die Problemaufgaben, die unsicheren Platzierungen und die vorgeschlagenen Antworten.

Skalieren Sie es herunter. Ein Menü-Rethink braucht die Diagnose, den neuen Baum, ein Zuhause für jede Problemaufgabe und die Übergabe an tree-tests; es braucht kein Content-Modell oder eine URL-Richtlinie. Ein längeres Dokument ist kein gründlicheres. Eine Anfrage, jeden Eintrag zu platzieren, bedeutet, dass jeder Eintrag ein Zuhause bekommt.

Prüfen

Es gibt kein Skript. Diese Prüfungen sind kurz und erfordern das Lesen der Spezifikation, also von Hand durchführen und reparieren, was fehlschlägt:

  • Primäre Einträge zählen (höchstens 7, 3 bis 6 bevorzugt) und Tabs (höchstens 5).
  • Jeder aktuelle Eintrag erscheint in der Vorher-Nachher-Tabelle mit einem neuen Platz oder einer angegebenen Einstellung.
  • Jedes Ziel existiert im Baum oder in den Routen, jeder Breadcrumb-Elternteil ist eine echte Seite, und Sidebar, Breadcrumbs und URL erzählen dieselbe Geschichte.
  • Jede Problemaufgabe hat genau ein Zuhause und ist in der tree-tests-Übergabe mit ihrer vorgeschlagenen Antwort enthalten.
  • Keine Nutzungsbehauptung, die Ihnen nicht mitgeteilt wurde. Häufigkeitswörter als Annahmen markieren.

Was Claude hier nicht kann

  • Die Strategie oder Politik der Organisation kennen, es sei denn, sie wird ihm mitgeteilt. Welcher Eintrag einen Platz verdient, ist teilweise eine geschäftliche Entscheidung, also einen Entwurf präsentieren und sagen, wessen Entscheidung es ist.
  • Traffic, Nutzung oder Forschung erfinden oder einen Baumtest mit echten Menschen durchführen.
  • Sagen, was die Menükomponente eines Frameworks tut. Sagen, was Sie erwarten würden, und den Benutzer bitten, es zu bestätigen, da die Unterstützung einer Plattform variiert.

Wo dies übergeben wird

  • information-architecture: die Eingangstür, wenn die Aufgabe mehrere dieser Skills umfasst.
  • sitemaps: wenn der darunterliegende Baum geändert werden muss.
  • labeling: um die Einträge zu formulieren. taxonomies: wenn Filter oder Facetten das eigentliche Bedürfnis sind.
  • url-structure und redirect-maps: wenn Ziele ihre Adresse ändern. content-models: wenn eine kontextuelle Regel Felder dahinter benötigt.
  • tree-tests: um die Studie durchzuführen. findability: wenn das Problem die Suche oder die Duftmarke ist. content-inventory und card-sort: wenn niemand weiß, was da ist oder wie Leute es gruppieren.

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/information-architecture

Use when someone wants to organize, restructure or review how a site, app, docs set, knowledge base or content library is grouped and found, and the job spans several pieces or it isn't yet clear which piece is needed, even if they never say "information architecture" or "IA". Not for a job that is clearly one piece, such as only a tree test or only a redirect map, and not for visual design.

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/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