Zum Inhalt springen
Pathrule

doku

Proposed Knowledge

Alles, was Pathrule oder ein Agent vorschlägt und noch niemand freigegeben hat. Wie sich ein Vorschlag von einer Erkenntnis, verifiziertem Wissen und einer Regel unterscheidet, wo welche Art von Vorschlag wartet und was eine Freigabe für deine Agents ändert.

Auf dieser Seite

Proposed Knowledge ist alles, was auf eine Person wartet, bevor deine Agents ihm vertrauen dürfen.

Pathrule und deine Agents bemerken ständig etwas: eine Konvention, an die sich ein Team immer wieder hält, einen Fix, der immer wieder funktioniert, eine Vorgabe, die ein Absatz nahezulegen scheint. Etwas zu bemerken ist eine Schlussfolgerung, und eine Schlussfolgerung ist kein Wissen, solange niemand dafür einsteht. Gelerntes gilt nie automatisch als vertrauenswürdig.

Fünf Begriffe, die keine Synonyme sind

Der Unterschied zwischen ihnen ist das gesamte Design.

Was es istErreicht es Agents?
ErkenntnisEine Schlussfolgerung, die ein Agent aus deinem Code festgehalten hat, zusammen mit den Dateien, auf denen sie beruhtJa, als zu prüfender Hinweis, nur solange ihre Quellen unverändert sind
VorschlagEtwas, das Pathrule oder ein Agent abgeleitet hat und das niemand freigegeben hatNein
Verifiziertes WissenEtwas, das eine Person freigegeben hatJa
RegelEine Vorgabe, die eine Person für einen Geltungsbereich festgelegt hat; ihre ausführbare Form wird erst durchgesetzt, wenn eine Person sie freigibtJa, als Anforderung
AuslieferungDas, was für eine Aufgabe tatsächlich beim Agent ankommtSie ist das, was ankommt

Woher Vorschläge kommen und wo sie warten

Dein Agent richtet ein Projekt ein

Bitte deinen Agent: „Set up Pathrule for this project“, und er führt einen geführten Scan durch: Er liest das Projekt, schlägt Memories, Regeln und Skills vor und schreibt nur die, die du im Gespräch freigibst. Nichts von dem, was er vorschlägt, wird gespeichert, bevor du zustimmst.

Außerhalb dieses Scans schlägt ein Agent, der etwas Bewahrenswertes entdeckt, es dir in der Regel vor, bevor er es schreibt. Schreibt er es, ist der Schreibvorgang zugeordnet, versioniert und umkehrbar.

Eine Einschränkung an einer Regel

Eine Regel kann eine ausführbare Einschränkung tragen: ein Muster, das eine Änderung nicht enthalten darf, und was stattdessen zu tun ist. Hängt ein Agent eine solche Einschränkung über pathrule_write_rule oder pathrule_update_rule an, wird sie als Vorschlag gespeichert. Sie wird nicht durchgesetzt, und ein Agent kann sie nicht freigeben. Erst wenn eine Person sie freigegeben hat, kann der Pre-Tool-Hook eine passende Änderung blockieren, und zwar in Clients, deren Hooks das unterstützen. Siehe Regeln als Leitplanken.

Team Intelligence auf Pathrule Cloud

Team Intelligence wertet die Belege aus, die bei der Arbeit eines Teams entstehen, und schlägt Patterns vor. Ein Pattern geht vom Entwurf in den Vorschlag über, und ein Owner oder Admin der Organisation verifiziert oder verwirft es in der Webkonsole, unter den Einstellungen Team guidance der Organisation; ein Vorschlag, um den sich niemand kümmert, läuft ab. Nur verifizierte Patterns erreichen Agents. Verfügbar ist das in den Plänen Team und Enterprise.

Deine persönlichen Präferenzen

Eine Präferenz, die du mit pathrule me teach beibringst, wird vor dem Speichern mit deinen eigenen Worten abgeglichen. Eine Präferenz, die noch nicht in Gebrauch ist, listet pathrule me list unter „Not in use yet“ auf, und sie erreicht nie einen Agent. pathrule me explain <id> zeigt, worauf sie beruht, und pathrule me forget <id> verwirft sie. Siehe User Intelligence.

Veraltetes Wissen

Wirkt Wissen veraltet, kann es als Refresh-Aufgabe markiert werden, etwa von einem Agent, der die Abweichung bemerkt und pathrule_request_refresh aufgerufen hat. Eine Refresh-Aufgabe ist ein Vorschlag, bestehendes Wissen zu ändern, und eine Person oder ein Agent arbeitet sie mit pathrule refresh oder den MCP-Refresh-Tools ab. Siehe Vorschläge und Selbstprüfung.

Die Ausnahme: Erkenntnisse

Erkenntnisse sind die einzige Art von gelerntem Wissen, die Agents ohne Prüfschritt erreicht, und das ist Absicht. Eine Erkenntnis ist ein Hinweis, keine Vorgabe:

  • sie wird erst gespeichert, nachdem ihre Quelldateien auf der Festplatte geprüft wurden,
  • sie wird nur ausgeliefert, solange diese Dateien im Checkout des Lesenden unverändert sind,
  • sie wird zurückgehalten, wenn sich ihre Quellen ändern oder sie einer anderen Erkenntnis widerspricht,
  • und sie wird nie von sich aus zu einer Memory, einer Regel oder einem Skill.

Alles, was für jeden Agent verbindlich sein soll, gehört weiterhin in eine Regel oder eine Memory, geschrieben und geprüft von deinem Team.

Was eine Freigabe ändert

Erst die Freigabe macht aus einem Vorschlag verifiziertes Wissen.

  • Ein freigegebener Scan-Vorschlag wird zu einer gewöhnlichen Memory, Regel oder einem Skill und wird wie jede andere ausgeliefert.
  • Ein verifiziertes Team-Pattern erreicht ab dann Agents in den Workspaces dieser Organisation.
  • Eine freigegebene Regel-Einschränkung kann vom Pre-Tool-Hook durchgesetzt werden, in Clients, die das unterstützen.
  • Ein verworfener Vorschlag bleibt verworfen, sodass dieselben Belege ihn nicht sofort wieder hervorbringen.

Was es nie tut

  • Es gibt nie etwas in deinem Namen frei, und nichts, was eine Freigabe braucht, erreicht einen Agent, bevor eine Person sie erteilt.
  • Es lässt nie zu, dass ein Agent seinen eigenen Vorschlag freigibt.
  • Es macht aus einer Erkenntnis nie eine Regel.
  • Es bearbeitet nie, was dein Team geschrieben hat, ohne dass eine Person oder ein Agent auf einen Vorschlag hin handelt.

Was passiert, sobald Wissen freigegeben ist, erfährst du unter Agent IR und Sicherheit und Rückfallebene.