Zum Inhalt springen
Pathrule

doku

Vorschläge und Selbstprüfung

Wie eine veraltete oder abgedriftete Memory oder Regel als Refresh-Aufgabe markiert wird und wie deine eigene KI sie unter deiner Kontrolle repariert.

Auf dieser Seite

Teamwissen veraltet. Pfade werden umbenannt, Meilensteine werden ausgeliefert, festgelegte Abhängigkeitsversionen driften, eine Regel greift irgendwann nirgends mehr. Die Antwort von Pathrule darauf ist eine Refresh-Aufgabe: eine Markierung an einer Memory oder Regel, die veraltet wirkt, mit einer verständlich formulierten Begründung. Dein eigener Assistent repariert sie dann unter deiner Kontrolle.

Die entscheidende Eigenschaft: Eine Refresh-Aufgabe schlägt immer nur etwas vor. Pathrule bearbeitet oder löscht deine Memories, Regeln oder Skills nie von sich aus.

Was die Selbstprüfung erkennt

Die Prüfung findet dort statt, wo die Abweichung auffällt: bei der eigentlichen Arbeit. Ein Assistent, der deinen Code liest, sieht als Erster, dass eine Memory eine Datei beschreibt, die verschoben wurde, oder dass eine Regel dem widerspricht, was der Code inzwischen tut. Passiert das bei seiner normalen Arbeit, markiert er den Eintrag mit dem MCP-Tool pathrule_request_refresh und nennt dabei die Memory oder Regel und den Grund, warum sie falsch wirkt. Typische Gründe:

  • Abdrift. Der Eintrag beschreibt einen Zustand, der nicht mehr zum Code passt, zum Beispiel weil eine darin genannte Datei verschoben wurde oder nicht mehr existiert.
  • Widerspricht dem Code. Der Eintrag sagt das eine, der Code tut eindeutig etwas anderes.
  • Duplikat. Eine andere Memory oder Regel deckt dasselbe Thema bereits besser ab.
  • Zu eng gefasst. Der Eintrag gilt nur für einen Fall, den es längst nicht mehr gibt.
  • Unklar. Es lässt sich nicht erkennen, was der Eintrag verlangt.

Das Markieren ist idempotent: Wird derselbe Eintrag zweimal markiert, kommt dieselbe Aufgabe zurück, sodass sich über mehrere Sessions keine Duplikate ansammeln. Assistenten sind angewiesen, nur Abweichungen zu markieren, die ihnen tatsächlich aufgefallen sind, und nicht gezielt danach zu suchen.

Eine Refresh-Aufgabe speichert nichts von deinem Quellcode. Sie benennt den Eintrag und enthält die Begründung. Der Assistent, der sie später repariert, liest den aktuellen Code mit seinen eigenen Datei-Tools.

Vorschläge prüfen

Eine Refresh-Aufgabe ist ein Anstoß für eine Entscheidung, keine Aktion. In einem Pathrule Cloud Workspace kannst du sie im Terminal bearbeiten:

pathrule refresh list
pathrule refresh claim <refresh-id>
pathrule refresh resolve <refresh-id> --status applied

list zeigt die offenen Aufgaben im aktuellen Workspace, claim liefert das vollständige Briefing zu einer Aufgabe und markiert sie als in Bearbeitung, und resolve schließt sie als applied oder rejected ab. Ein Assistent macht dasselbe über MCP mit pathrule_list_pending_refreshes, pathrule_get_refresh_brief und pathrule_resolve_refresh.

Für jede Aufgabe kannst du deinen Assistenten die Korrektur vornehmen lassen (siehe unten), den Eintrag selbst bearbeiten oder die Aufgabe ablehnen, wenn der Eintrag noch stimmt.

Reparatur durch deinen Assistenten

Pathrule korrigiert dein Wissen nicht automatisch. Bitte deinen Assistenten, die offenen Refresh-Aufgaben abzuarbeiten. Er geht dann so vor:

  1. Er listet die offenen Aufgaben auf und übernimmt eine davon. Dadurch wird sie als in Bearbeitung markiert, sodass keine andere Session sie gleichzeitig übernimmt.
  2. Er untersucht den aktuellen Code und den markierten Eintrag mit seinen eigenen Tools für den Dateizugriff.
  3. Er entwirft die Aktualisierung und schreibt sie über die Schreib-Tools von Pathrule zurück. Wird die Aufgaben-ID mit der Aktualisierung übergeben, wird die Aufgabe als angewendet geschlossen.
  4. Andernfalls markiert er die Aufgabe ausdrücklich als angewendet oder abgelehnt.

Du behältst an beiden Enden die Kontrolle: Die Korrektur läuft über deinen eigenen Assistenten, und die Änderung ist eine ganz normale versionierte Bearbeitung, die du prüfen kannst. Die Refresh-Tools, die der Assistent verwendet, findest du in der MCP-Tools-Referenz.

Nichts ist endgültig

Eine Reparatur ist eine normale versionierte Bearbeitung. Jede Änderung behält ihren Verlauf, und in einem Pathrule Cloud Workspace bleibt ein gelöschter Eintrag im Workspace-Archiv, bis er endgültig gelöscht wird. Bis dahin kann ein Owner oder Admin ihn in den Einstellungen der Webkonsole wiederherstellen. In VS Code bietet ein Löschvorgang sofort Undo an. Stellt sich eine Korrektur als falsch heraus, kannst du sie wie jede andere Bearbeitung rückgängig machen.