Ein Pattern importieren

Du kannst jedes Pattern auf zwei Wegen übernehmen. Entweder fügst du sein Token in einen beliebigen verbundenen KI-Assistenten ein, und Pathrule schreibt die Bestandteile für dich auf die richtigen Pfade, oder du kopierst das Bundle von Hand aus dem Katalog.

Das Referenz-Token

Jedes Pattern hat ein Referenz-Token der Form:

::pathrule:package:<slug>

Das Pattern für den Next.js App Router hat zum Beispiel das Token ::pathrule:package:nextjs-app-router. Das Token steht auf jeder Katalogseite und lässt sich direkt kopieren.

Das Präfix ::pathrule: ist ein reservierter Namensraum. Es wird vor dem Aufrufpfad ::skill-name geprüft, deshalb wird ein Pattern-Token nie mit einem Skill verwechselt und löst nie die Skill-Erkennung aus. Diese Trennung gilt im Prompt-Hook ebenso wie in der Kontext-Anfrage.

Füge das Token als reinen Text ein. Wie bei einem Skill-Aufruf wird ein Token in Backticks oder in einem Codeblock als zitierter Code behandelt und ignoriert. Du kannst mehrere Tokens in einen Prompt schreiben; jedes Pattern wird einmal erfasst.

Import per Token

Um ein Pattern hinzuzufügen, fügst du sein Token in einen Prompt in einem verbundenen Workspace ein. Den Rest erledigt Pathrule:

1. Es erkennt das Token. Wenn Pathrule den Kontext für deinen Prompt zusammenstellt, erkennt es die Markierung ::pathrule:package:<slug> und gibt eine Import-Anweisung für diesen Slug aus.
2. Es zeigt vor dem Schreiben eine Vorschau. Ein Dry Run löst das Pattern auf und liefert seine Version, das Problem, das es löst, seine Bestandteile und die Pfade, die es verwenden will, ohne bereits etwas zu verändern. Diese Vorschau meldet außerdem die deklarierten Pfade, Stacks und Abhängigkeiten des Patterns, damit der Assistent es mit deinem tatsächlichen Projekt abgleichen kann.
3. Es wählt Pfade, die zu deiner Verzeichnisstruktur passen. Ein Pattern deklariert vorgeschlagene Pfade, aber echte Repositories sehen unterschiedlich aus. Der Assistent wählt eine Basis, die zu deinem Aufbau passt, und hängt die Pfade des Patterns darunter neu ein, sodass die Bestandteile dort landen, wo sie tatsächlich hingehören. In einem Monorepo können die /app-Regeln eines Next.js-Patterns unter /apps/web/app landen.
4. Es fragt bei Abweichungen nach. Zielt das Pattern auf einen Stack, den dein Projekt offenbar nicht verwendet, etwa ein React-Native-Pattern in einem Projekt ohne Expo, hält der Assistent an und fragt dich, ob und wo es hinzugefügt werden soll, statt blind zu importieren.
5. Es schreibt das Bundle. Nach deiner Bestätigung wird jeder Bestandteil über den normalen Schreibpfad angelegt: Eine Memory wird zur Memory, eine Regel wird zur Regel mit ihrem Scope-Typ und ihrer Priorität, und ein Skill wird zu einem aufrufbaren Skill, der mit dem Pattern markiert ist, aus dem er stammt. Fehlende Knoten entlang eines Pfads werden bei Bedarf angelegt.

Anschließend gibt der Assistent eine einzeilige Zusammenfassung weiter, zum Beispiel wie viele Regeln, Memories und Skills importiert wurden, wie viele bereits vorhanden waren und wie viele fehlgeschlagen sind.

Nach dem Import sind die Bestandteile gewöhnlicher Workspace-Inhalt. Sie werden über dieselben Hooks und dieselbe Abfrage ausgeliefert wie alles, was du selbst geschrieben hast, und du bearbeitest sie auf dieselbe Weise. Eine importierte Regel ist zunächst beratend: Sie wird als Kontext mitgegeben und blockiert keine Änderung, solange niemand eine ausführbare Einschränkung für sie freigibt (siehe Regeln als Leitplanken).

Der Import schreibt in deinem Namen. Jeder Bestandteil durchläuft dieselbe Zugriffsprüfung wie jeder andere Schreibvorgang. In einem Team brauchst du daher Schreibzugriff auf den Ziel-Workspace: Ein Viewer kann nicht importieren. Siehe Rollen und Berechtigungen.

Import per manueller Kopie

Du brauchst das Token nicht, um ein Pattern zu nutzen. Jede Katalogseite hat die Aktion „Manual copy (full bundle)“, die das vollständige Bundle als reines Markdown kopiert. Dabei ist jeder Bestandteil mit Art und Zielpfad beschriftet und jede Regel mit Scope und Priorität. Füge das in deinen Assistenten oder in deine eigenen Notizen ein und lege die Bestandteile an, wo immer du willst. Das funktioniert ohne Einrichtung und ohne Konto.

Jedes Pattern ist außerdem als rohes Markdown unter /patterns/<slug>/raw verfügbar. Das ist praktisch, wenn ein Assistent das ganze Bundle über einen Link lesen soll.

Einmalig übernehmen statt abonnieren

Ein Pattern zu importieren ist eine einmalige Übernahme. Die Kopie in deinem Workspace gehört ab diesem Moment dir; sie bleibt nicht mit dem Katalog verknüpft und ändert sich nicht ohne dein Zutun. Pathrule speichert nicht, welche Version du importiert hast, und benachrichtigt dich nicht, wenn eine neuere Version veröffentlicht wird. Es wird also nie etwas über Inhalte synchronisiert, die du bereits angepasst hast.

Ob sich ein Pattern seit deinem Import verändert hat, erkennst du, indem du Version und Aktualisierungsdatum auf seiner Katalogseite vergleichst und sein Changelog im offenen Paket liest. Ein erneuter Import übernimmt keine Änderungen, weil jeder Bestandteil übersprungen wird, dessen Titel bereits vorhanden ist. Um eine neuere Version zu übernehmen, entfernst du das Bundle und importierst es erneut. Dabei gehen deine Änderungen an den importierten Bestandteilen verloren. Wenn du nur einen einzelnen verbesserten Bestandteil willst, kopiere ihn von Hand von der Katalogseite.

Erneut importieren und entfernen

• Ein erneuter Import erzeugt nie Duplikate. Führst du denselben Import noch einmal aus, wird jeder Bestandteil übersprungen, dessen Titel bereits vorhanden ist, und du erhältst eine Übersicht, was hinzugefügt wurde und was schon da war. Eine Memory gilt als vorhanden, wenn an ihrem Pfad eine Memory mit demselben Titel existiert; eine Regel oder ein Skill gilt als vorhanden, wenn irgendwo im Workspace eine Regel bzw. ein Skill mit demselben Namen existiert. Übersprungene Bestandteile bleiben genau so, wie sie sind, einschließlich deiner Änderungen. Einen Bestandteil, den du nach dem Import umbenannt hast, erkennt Pathrule nicht mehr, ein erneuter Import fügt ihn also wieder hinzu.
• Das Entfernen ist ein einziger Schritt. Die Definition eines Patterns ist sein eigenes Manifest aus Titeln und Pfaden. Du kannst deinen Assistenten also bitten, das Pattern zu entfernen, und ein einziger Aufruf macht das gesamte Bundle rückgängig. Wenn du unter einem Basispfad importiert hast, gib beim Entfernen dieselbe Basis an; Bestandteile, die dort nicht gefunden werden, werden als nicht gefunden gemeldet und nicht als Fehler behandelt.

Was beim Entfernen betroffen ist

Das Entfernen findet jeden Bestandteil über seinen Titel an seinem Pfad, nicht über eine Erinnerung daran, was der Import angelegt hat. Daraus ergeben sich drei Konsequenzen, die du kennen solltest, bevor du es ausführst:

• Bearbeitete Bestandteile werden ebenfalls entfernt. Eine importierte Memory, Regel oder ein importierter Skill, den du inzwischen bearbeitet hast, wird samt deinen Änderungen entfernt, solange Titel und Pfad unverändert sind.
• Dein eigenes Element mit demselben Titel wird entfernt. Hast du selbst eine Memory, eine Regel oder einen Skill mit demselben Titel wie einer der Bestandteile des Patterns am selben Pfad angelegt, wird auch dieses Element gelöscht. Beim Vergleich der Titel spielt Groß- und Kleinschreibung keine Rolle.
• Umbenannte oder verschobene Bestandteile bleiben erhalten. Benennst du einen Bestandteil um oder verschiebst ihn an einen anderen Pfad, ist er für das Entfernen nicht mehr erreichbar. So behältst du einen einzelnen Bestandteil und entfernst den Rest.

Entfernte Elemente werden archiviert, nicht gelöscht. In einem Cloud-Workspace bleiben sie im Workspace-Archiv, bis sie endgültig gelöscht werden. Ein Owner oder Admin kann sie dort in den Einstellungen der Web-Konsole unter Workspace, Archive wiederherstellen.

Wo es funktioniert

Import und Entfernen per Token nutzen die lokalen stdio-MCP-Tools, auch wenn diese Laufzeit mit einem Cloud-Workspace verbunden ist. Remote MCP stellt diese Hilfsfunktionen nicht bereit. Ein Remote-Client kann das rohe Bundle lesen und ausgewählte Einträge mit den ihm verfügbaren Wissens-Tools anlegen.

Der Import verhält sich in Claude Code, Codex, Cursor, Windsurf und GitHub Copilot gleich, sofern sie über Pathrule CLI oder die VS Code-Erweiterung verbunden sind. Import und Entfernen funktionieren in einem lokalen Workspace genauso wie in einem Pathrule Cloud-Workspace. In Claude Code und Codex erkennt der Prompt-Hook das Token, bevor der Agent handelt. Cursor, GitHub Copilot und Windsurf haben keinen Prompt-Hook. Dort lernt der Assistent denselben Ablauf für Import und Entfernen aus der Kontext-Anfrage und den Protokollhinweisen in seinen Instruktionsdateien.

Weiterlesen

• Patterns im Überblick für das Gesamtbild.
• Anatomie eines Patterns dazu, was ein Bundle enthält und wie die Versionierung funktioniert.
• So funktionieren Hooks dazu, wie importierte Bestandteile ausgeliefert werden, sobald sie in deinem Workspace sind.