Kernkonzepte

Das Datenmodell von Pathrule ist bewusst klein gehalten: drei Arten von Inhalten, ein Baum aus Knoten und ein pfadbasierter Geltungsbereich. Wenn du diese Struktur einmal verinnerlicht hast, ergibt sich der Rest von Pathrule daraus.

Einen Punkt solltest du beim Lesen dieser Seite im Hinterkopf behalten: Die drei Inhaltsarten unten sind die Autorenoberfläche. Sie sind das, was ein Mensch schreibt, bearbeitet und diskutiert, und sie sind Eingaben. Was ein Agent erhält, hängt von der Aufgabe ab: nur die Einträge, die für die anstehende Arbeit gelten, priorisiert und auf die Aufgabe zugeschnitten. Darum geht es im Architekturüberblick; hier geht es um das, was du schreibst.

Der Workspace-Baum

Ein Workspace ist ein Baum aus Knoten. Die Wurzel ist der Workspace selbst. Die Kindknoten sind Ordner oder Dateien, die die Teile deines Repositorys abbilden, zu denen dein Team Wissen festhält.

/                            workspace root
  /apps                      folder node
    /apps/web                folder node
      /apps/web/auth         folder node
        /apps/web/auth/login.tsx   file node

Du musst den Baum nicht von Hand anlegen. Wenn du eine Memory unter /apps/web/auth schreibst, erzeugt Pathrule die Kette der Knoten bei Bedarf. Leere Knoten kosten nichts und lassen sich später leicht löschen, falls der Pfad nicht mehr gebraucht wird.

Memories

Eine Memory ist ein kurzes Markdown-Dokument, das jemand aus dem Team festhält, damit der Assistent es später lesen kann.

• Fakten: Notizen zum Schema, Designentscheidungen, Stolperfallen.
• Postmortems: was kaputtging, was wir gelernt haben, wie wir es behoben haben.
• Konventionen: wie dieses Team etwas am liebsten erledigt.

Memories sind standardmäßig beratend. Sie landen im Kontext des Assistenten, wenn der Hook entscheidet, dass sie für den Pfad relevant sind, in dem der Assistent gerade arbeitet.

Die meisten Memories schreiben Menschen oder ein Assistent, der mit dir zusammenarbeitet. In einem Cloud-Workspace legt Pathrule zusätzlich einige selbst an: kurze Technologienotizen an der Workspace-Wurzel, etwa „TypeScript project“ oder „Docker containerization“, die beim ersten Mal, wenn ein Agent tiefen Kontext anfordert, anhand von Dateinamen erkannt werden. Es sind ganz normale Memories, du kannst sie also wie jede andere bearbeiten oder löschen.

Regeln

Eine Regel ist eine Vorgabe, die der Assistent in einem bestimmten Geltungsbereich befolgen muss.

Regeln haben:

• Einen Scope-Typ. folder bedeutet, dass die Regel unterhalb eines Verzeichnisses gilt. file_type bedeutet, dass sie für ein Datei-Glob wie *.tsx gilt. project bedeutet, dass sie überall im Workspace gilt.
• Eine Priorität. high für die wichtigsten Vorgaben, medium für allgemeine Hinweise, low für stilistische Vorlieben. Die Priorität steuert, wie stark eine Regel in den Vordergrund rückt, nicht ob sie blockiert.
• Einen Durchsetzungsmodus. advisory-Regeln werden als Kontext mitgegeben, und der Assistent entscheidet, wie er sie anwendet. Eine strict-Regel trägt eine ausführbare Vorgabe, die ein Mensch freigegeben hat, und kann eine passende Änderung blockieren, bevor sie übernommen wird, sofern der Client Hooks vor einem Tool-Aufruf ausführt.
• Einen Inhalt. Eine kurze Liste mit Anweisungen im Imperativ funktioniert am besten.

Regeln mit höherer Priorität erscheinen zuerst, wenn ihr Geltungsbereich zum aktuellen Pfad passt. Regeln mit niedrigerer Priorität erscheinen, wenn sie voraussichtlich weiterhelfen.

Skills

Ein Skill ist ein benannter Ablauf, den der Assistent aufrufen kann, statt die Schritte jedes Mal neu herzuleiten.

Beispiele:

• replay-stripe-webhook: eine Checkliste mit dem genauen CLI-Befehl und den Sicherheitsschritten vor dem Ausführen.
• regenerate-fixtures: der Pfad zum Skript, die Eingaben und die erwartete Ausgabe.
• release-check: die Checkliste vor dem Release, die der Assistent nach dem Wunsch des Teams immer durchgehen soll.

Skills lassen sich über ihren Namen finden. Der Assistent kann Pathrule nach den Skills fragen, die am aktuellen Pfad hängen, und den passenden für die Aufgabe auswählen.

Pfadbezogener Geltungsbereich

Jede Memory, jede Regel und jeder Skill liegt an einem Knotenpfad. Der Pfad entscheidet, wo der Inhalt auftaucht.

• Eine Memory unter /apps/web ist für jede Arbeit unterhalb von apps/web relevant.
• Eine Memory unter / ist überall relevant.
• Ein Skill unter /services/billing wird dem Assistenten angeboten, wenn innerhalb des Billing-Service gearbeitet wird.

Der Pfadbezug sorgt dafür, dass das Kontextfenster des Assistenten klein bleibt. Eine kleine UI-Anpassung in apps/web/dashboard muss die Regeln zu Datenbankmigrationen nicht sehen.

Priorität und Durchsetzung

Priorität und Durchsetzung sind zwei voneinander unabhängige Einstellungen.

• Priorität (high, medium, low) legt fest, wie stark eine Regel in den Vordergrund rückt. Setze high sparsam ein, für die wichtigsten Vorgaben.
• Durchsetzung (advisory oder strict) entscheidet, was bei einem Verstoß passiert. Beratende Regeln werden als Kontext bereitgestellt, und der Assistent entscheidet, wie er sie anwendet; jede neue Regel startet beratend. Ein Agent kann für eine Regel eine ausführbare Vorgabe vorschlagen. Sie wird als Vorschlag gespeichert und nicht durchgesetzt. Sobald ein Mensch sie freigegeben hat, prüft der lokale Hook eine passende Bearbeitung, bevor sie übernommen wird, kann die Änderung blockieren und nennt die Regel als Grund.

Die Pathrule CLI und die VS Code-Erweiterung registrieren die verfügbaren Hooks für Claude Code, Codex, Cursor und GitHub Copilot, und Blockieren greift dort, wo der Hook des Clients einen Tool-Aufruf stoppen kann. Windsurf hat keine Hooks, und das Remote MCP installiert keine: Beide erhalten Regeln als Kontext, ohne blockierendes Pathrule-Ereignis vor dem Schreiben.

Wie das zusammenpasst

• Was Pathrule berechnet beschreibt die abgeleitete Schicht rund um diese drei geschriebenen Inhaltsarten.
• So funktionieren Hooks erklärt, wie die Laufzeit den Ausschnitt auswählt, der gesendet wird.
• MCP-Überblick listet die Tools auf, mit denen der Assistent Knoten liest und schreibt.
• Schnellstart ist der schnellste Weg, dieses Modell in Aktion zu sehen.