Workspace Intelligence

Workspace Intelligence ist die Antwort auf eine einzige Frage: Wie funktioniert dieses Projekt?

Nicht, was in den Dateien steht. Die kann ein Agent lesen, und das kann er gut. Was er nicht lesen kann, ist das Arbeitswissen, das sich in einem Repository rund um den Code ansammelt, und genau dieses Wissen entscheidet darüber, ob eine Änderung richtig ist oder nur plausibel.

Was sie abbildet

• Architekturentscheidungen und die Überlegungen, die zu ihnen geführt haben.
• Verborgene Einschränkungen, die nirgends im Code sichtbar sind.
• Prüfanforderungen: was geprüft werden muss, bevor etwas als erledigt gilt.
• Frühere Fixes: was beim letzten Auftreten genau dieses Problems tatsächlich funktioniert hat.
• Konventionen, die ein Team befolgt, ohne sie aufzuschreiben.
• Abläufe: die festgelegte Reihenfolge, in der eine wiederkehrende Aufgabe hier erledigt wird.
• Kontextfakten, die den richtigen Ansatz verändern, etwa dass eine Datenbank ein schreibgeschütztes Replikat ist.
• Technische Begründungen, die einen Agent davon abhalten, eine bewusste Entscheidung hilfsbereit rückgängig zu machen.
• Bevorzugte Implementierungen unter mehreren, die alle funktionieren würden.
• Abgelöste Entscheidungen, damit eine alte nicht länger als aktuell behandelt wird.

All das steckt in drei Arten von Inhalten, die dein Team lesen und bearbeiten kann: Memories, Regeln und Skills.

Geltungsbereich

Workspace Intelligence bezieht sich auf ein Repository und darin auf Pfade.

Dieser Mechanismus verhindert, dass eine Wissensschicht selbst zu dem Problem wird, das sie lösen sollte. Nicht alles, was in einem Monorepo zutrifft, ist für eine Änderung an einem einzelnen Paket relevant, und wer alles ausliefert, lässt die drei entscheidenden Sätze mit zweihundert unwichtigen konkurrieren. Wissen hängt an dem Pfad, für den es gilt, und eine Aufgabe in diesem Pfad erhält genau das, was dort gilt.

Der Pfadbezug ist auch der Grund, warum ein Workspace weiter wachsen kann, ohne dass jeder Durchgang schwerer wird. Siehe Wie Retrieval das richtige Wissen findet.

Verbindlichkeit

Workspace Intelligence ist die Schicht, die verbindliche Anforderungen enthalten kann.

Anforderungen stehen in Regeln. Eine Regel legt fest, was in einem Geltungsbereich geschehen muss oder nicht geschehen darf, hat eine Priorität und kommt in einem eigenen Abschnitt an, getrennt von Empfehlungen. Eine Regel kann außerdem eine ausführbare Einschränkung enthalten, also ein Muster, das eine Änderung nicht enthalten darf. Schlägt ein Agent eine solche Einschränkung vor, wird sie als Vorschlag gespeichert und nicht durchgesetzt. Sobald ein Mensch sie freigegeben hat, kann der Pre-Tool-Hook eine passende Änderung blockieren, sofern die Hooks des jeweiligen Clients das unterstützen. Siehe Regeln als Leitplanken.

Das sind Eigenschaften des Projekts. Sie fallen nicht weg, nur weil eine persönliche Vorliebe bequemer wäre, und User Intelligence kann sie nicht außer Kraft setzen. Alles andere, was Workspace Intelligence enthält, ist beratend und wird als Empfehlung ausgeliefert, sodass ein früherer Fix nie so dargestellt wird, als hätte er Vorrang vor einer Regel.

Quellen

Es gibt vier Arten, und es ist wichtig, sie auseinanderzuhalten.

Verfasst. Memories, Regeln und Skills, die ein Mensch bewusst geschrieben hat oder die ein Agent über die Tools von Pathrule geschrieben hat, meist nachdem er sie dir vorgeschlagen hat. Auf diese Inhalte kann ein Team zeigen und über sie diskutieren, und sie bilden das Rückgrat.

Erkenntnisse aus dem Code. Schlüsse, die ein Agent beim Lesen deines Codes gezogen hat. Sie werden zusammen mit den Dateien gespeichert, auf denen sie beruhen, und nur als Empfehlung ausgeliefert, solange diese Dateien unverändert sind. Siehe Projektlernen.

Belege aus echter Arbeit. Was Agent-Sessions über sich selbst berichtet haben: welches Wissen ausgeliefert wurde, welches tatsächlich herangezogen wurde, welche Dateien sich gemeinsam geändert haben, wo ein Agent immer wieder hängen geblieben ist. Siehe Was Pathrule berechnet.

Aus deinem Checkout übernommen, auf einem Cloud-Workspace. Wenn ein Agent Pathrule zum ersten Mal nach tiefem Kontext zu einem Cloud-Workspace fragt, liest die lokale Runtime Dateipfade aus der jüngeren Git-Historie, um zu erkennen, welche Dateien sich gemeinsam geändert haben, und listet Dateinamen in den oberen Ebenen des Verzeichnisbaums auf, um die eingesetzten Technologien zu erkennen, etwa eine TypeScript-, Docker- oder GitHub-Actions-Konfiguration. Die Pfadpaare werden im Workspace als Ausgangspunkt für Dateien, die sich gemeinsam ändern gespeichert, damit das Signal schon nützlich ist, bevor dein Team viel Arbeit protokolliert hat. Jede erkannte Technologie wird zu einer kurzen Memory im Wurzelverzeichnis des Workspace, etwa „TypeScript project“, und wird ohne Rückfrage geschrieben. Es ist eine ganz normale Memory, die du bearbeiten oder löschen kannst. Ein lokaler Workspace überspringt diesen Schritt und lernt allein aus protokollierter Arbeit, welche Dateien sich gemeinsam ändern.

Was keine Quelle ist: dein Quellcode. Pathrule lädt deinen Code nicht automatisch hoch, und die oben beschriebene Grundausstattung liest Dateinamen und Pfade, keine Dateiinhalte, Diffs oder Commit-Nachrichten. Auf einem Cloud-Workspace lädt pathrule snapshot, wenn du oder dein Agent es ausführt, den Dateibaum, Manifeste, kurze Auszüge aus der Dokumentation und aktuelle Git-Metadaten hoch, damit Pathrule das Projekt beschreiben kann. Was Pathrule berechnet führt auf, was gelesen und was gespeichert wird.

Team Intelligence

Auf Pathrule Cloud betrachtet Team Intelligence die Belege, die bei der Arbeit eines Teams entstehen, und schlägt Patterns vor: Konventionen, Fixes und Entscheidungen, die immer wieder auftauchen. Sie ist in den Plänen Team und Enterprise verfügbar, und Inhaber und Admins einer Organisation verwalten sie in der Webkonsole unter den Einstellungen Team guidance der Organisation.

Ein Pattern wechselt vom Entwurf zum Vorschlag, und ein Mensch bestätigt oder verwirft es. Ein Vorschlag, um den sich niemand kümmert, läuft ab. Nur bestätigte Patterns erreichen Agents. Nichts, was Team Intelligence ableitet, gilt von sich aus als vertrauenswürdig.

Lebenszyklus

1. Geschrieben oder vorgeschlagen. Ein Mensch schreibt es mit der CLI, der VS Code-Erweiterung oder seinem Agent. Ein Agent, der etwas Bewahrenswertes entdeckt hat, speichert es über die Schreib-Tools von Pathrule, meist nachdem er es dir vorgeschlagen hat, und der Schreibvorgang ist zugeordnet, versioniert und umkehrbar. Bittest du deinen Agent mit „Set up Pathrule for this project“ um die Einrichtung, startet ein geführter Scan, in dem der Agent Memories, Regeln und Skills vorschlägt und diejenigen schreibt, die du freigibst. Auf einem Cloud-Workspace ergänzt Pathrule außerdem die oben beschriebenen kurzen Technologie-Memories.
2. Freigegeben, wo etwas abgeleitet wurde. Abgeleitetes Wissen wartet auf einen Menschen: Die ausführbare Einschränkung einer Regel wird erst nach der Freigabe durchgesetzt, und ein Pattern aus Team Intelligence erreicht Agents erst, nachdem es bestätigt wurde. Erkenntnisse von Agents sind die einzige Ausnahme, und sie bleiben beratend. Siehe Proposed Knowledge.
3. Ausgeliefert. Der für eine Aufgabe relevante Teil erreicht den Agent über den Mechanismus, den sein Client unterstützt. Siehe Agent IR.
4. Gemessen. Die Auslieferung und das, was der Agent damit gemacht hat, werden erfasst, sodass der Stellenwert eines Eintrags davon abhängt, was passiert ist, und nicht davon, wer ihn geschrieben hat.
5. Aufgefrischt, abgelöst oder ausgemustert. Wissen, das veraltet wirkt, kann als Auffrischungsaufgabe markiert werden, die dann ein Mensch oder ein Agent abarbeitet. Eine Entscheidung, die durch eine spätere ersetzt wurde, wird nicht länger als aktuell behandelt. Siehe Vorschläge und Selbstprüfung.

Was sich ändert, wenn du das Projekt wechselst

Alles. Workspace Intelligence gehört zum Repository, und wer ein anderes öffnet, bekommt einen anderen Bestand an Projektwissen, den er mit allen teilt, die ebenfalls darin arbeiten.

Was du mitnimmst, ist User Intelligence, und die gehört dir: die Vorlieben, die du Pathrule beigebracht hast und überall anwenden lassen willst.