Projektlernen

Das meiste, was ein Agent über dein Projekt lernt, lernt er durch Lesen von Code. Warum eine Queue beim ersten Netzwerkfehler anhält, über welchen Helper jeder Zahlungspfad läuft, wie das Team die letzte Diskussion über Fehlerbehandlung entschieden hat: Ein Agent findet es heraus, nutzt es, und dann endet die Session. Der nächste Agent, oder der Agent einer Kollegin, zahlt erneut dafür, es herauszufinden.

Projektlernen bewahrt diese Schlussfolgerungen auf. Ein Agent speichert, was er herausgefunden hat, zusammen mit den Dateien, die er gelesen hat, und jeder Agent im Workspace setzt darauf auf, solange der Code es noch hergibt.

Was eine Erkenntnis ist

Eine Erkenntnis ist eine einzelne Schlussfolgerung, die ein Agent aus deinem Code gezogen hat, plus die Dateien, auf denen sie beruht, und deren Inhalt zum Zeitpunkt des Lesens. Pathrule gleicht die Dateien mit dem Stand auf der Festplatte ab, bevor es die Erkenntnis annimmt. Gespeichert wird eine Erkenntnis also immer nur über Code, der tatsächlich existiert.

Eine Erkenntnis ist weder eine Memory noch eine Regel oder ein Skill. Sie wird nie von selbst zu einem davon und blockiert nie etwas. Sie liegt in einer eigenen Schicht, neben dem Wissen, das dein Team geschrieben hat.

Wie sie Agenten erreicht

Erkenntnisse kommen in dem Kontext an, den ein Agent über pathrule_get_context bei Pathrule anfragt. Sie sind als zu prüfende Hinweise gekennzeichnet, und Agenten werden angewiesen, sie als Information und nicht als Anweisung zu behandeln. So kann in einer Datei platzierter Text nicht zu einem dauerhaften Befehl werden.

Eine Erkenntnis wird nur ausgeliefert, solange ihre Belege in deinem Checkout zutreffen:

• Unveränderte Quellen. Die Erkenntnis wird ausgeliefert.
• Eine Quelle hat sich geändert. Die Erkenntnis wird zurückgehalten, bis ein Agent den Code erneut liest und sie bestätigt oder korrigiert. Niemand bekommt eine Antwort über Code, den es nicht mehr gibt.
• Zwei Erkenntnisse widersprechen sich. Beide werden zurückgehalten, statt zwischen ihnen zu raten.

Diese Prüfung läuft pro Checkout. Eine Kollegin auf einem älteren oder neueren Branch bekommt also nur die Erkenntnisse, die für den Code vor ihr zutreffen.

Korrigieren und Zurückziehen

Ein Agent kann eine Erkenntnis korrigieren, indem er eine neue mit frisch geprüften Quellen erfasst, die sie ersetzt. Erweist sich eine Erkenntnis als falsch, kann die Person, deren Agent sie erfasst hat, sie zurückziehen. Das Zurückziehen gilt sofort für den gesamten Workspace, und ein alter Sendeversuch von einem Rechner, der offline war, kann sie niemals zurückbringen.

Agenten können aktuelle, veraltete und widersprüchliche Erkenntnisse auflisten, auch die, die aus dem Kontext zurückgehalten werden. So sieht man genau, was in der Schicht liegt und warum etwas nicht ausgeliefert wurde.

Aus früheren Reviews lernen

Mit GitHub-Zugriff über deinen bestehenden gh-Login kann ein Agent frühere Review-Diskussionen im Repository lesen, um zu sehen, wie das Team eine ähnliche Frage schon einmal entschieden hat, und das in einer Erkenntnis zitieren. Pathrule speichert die Kommentare selbst nicht und überspringt Reviews von Bots, von Externen sowie verworfene Reviews. Ohne GitHub-Zugriff funktioniert alles andere weiterhin.

Was deinen Rechner verlässt

Projektlernen braucht kein lokales Modell und schreibt nichts in dein Repository.

In einem lokalen Workspace bleiben Erkenntnisse in dessen lokalem Speicher auf deinem Rechner. In einem Cloud-Workspace teilt Pathrule die Erkenntnis und ihre Herkunft, also die Dateipfade und einen Fingerabdruck des jeweiligen Dateiinhalts, damit andere Checkouts erkennen können, ob die Erkenntnis noch zutrifft. Dateiinhalte werden nicht hochgeladen. Eine offline erfasste Erkenntnis wartet in einer Warteschlange und wird gesendet, sobald die Verbindung wieder steht.

Es gibt keinen Prüfschritt

Eine Erkenntnis wird geteilt, sobald ihre Quellen geprüft sind; niemand muss sie vorher freigeben. Das ist Absicht: Erkenntnisse sind Hinweise, die bei jeder Auslieferung erneut gegen den Code geprüft werden, keine Team-Richtlinie. Alles, was für jeden Agenten verbindlich sein soll, gehört weiterhin in eine Regel oder eine Memory, geschrieben und geprüft von deinem Team.

Die zugehörigen Tools sind in der MCP-Tools-Referenz aufgeführt.