Knowledge IR

Eine Regel ist keine Wissenseinheit. Sie ist ein Container für eine.

Ein einzelner Absatz, den ein Mensch schreibt, sagt regelmäßig mehrere verschiedene Dinge zugleich: dass etwas nie passieren darf, dass etwas anderes geprüft werden muss und warum das Ganze überhaupt so ist. Als ein einziger Block ausgeliefert, schrumpft das zu „hier ist etwas Text, bitte behalte ihn im Hinterkopf“. Getrennt gehalten, bleiben es drei verschiedene Dinge mit drei verschiedenen Gewichten.

Knowledge IR ist der Name für diese strukturierte Form: Art und Autorität jedes Stücks Wissen, gespeichert neben dem Text, den dein Team geschrieben hat, statt an seiner Stelle.

Arten von Wissen

Jedes Stück Wissen, das ein Agent erhält, gehört zu einer von wenigen Arten, und die Art bestimmt, wie es präsentiert wird.

Was nicht passieren darf. Eine Einschränkung, die ein Mensch für einen Geltungsbereich festgelegt hat. Sie gilt für die Pfade, auf die sie sich bezieht, und für nichts sonst, und sie ist die einzige Art von Wissen, auf die die Laufzeit reagieren kann, statt sie nur zu erwähnen.

Was geprüft werden muss. Eine Prüfung, die stattfinden muss, bevor die Arbeit als erledigt gilt.

Was funktioniert hat, als dieses Problem auftrat. Eine Bedingung und der Fix, der sie behoben hat. Rat: Er sagt einem Agenten, was funktioniert hat, nicht, was ihm verboten ist.

Was unter einer Bedingung bevorzugt werden sollte. Eine bevorzugte Entscheidung samt den Alternativen, gegenüber denen sie bevorzugt wurde. Sie formuliert die Präferenz und verbietet die Alternative nie. Das kann nur eine Regel.

Wie etwas gemacht werden sollte. Ein geordneter Ablauf, dessen Schritte in ihrer ursprünglichen Reihenfolge bleiben, denn ein umsortierter Ablauf ist ein anderer Ablauf. Die meisten Abläufe leben in Skills.

Was hier wahr und nützlich ist. Ein beschreibender Fakt, der den richtigen Ansatz verändert, ohne etwas zu verbieten. Dass die Datenbank hinter einem Modul eine schreibgeschützte Replica ist, ist ein solcher Fakt, und er ist der Grund, warum ein Agent zur Queue greifen sollte statt zu einem Insert.

Warum etwas so funktioniert. Die Begründung hinter einer Entscheidung. Es gibt sie, weil ein Agent, der die Regel kennt, aber nicht den Grund, nur ein gut gemeintes Refactoring davon entfernt ist, sie rückgängig zu machen.

Autoritätsstufen

Die Arten sind nicht gleichwertig, und die Auslieferung sagt das ausdrücklich, statt sich auf die Reihenfolge im Prompt zu verlassen.

Nichts im Auslieferungsweg darf eine niedrigere Stufe so darstellen, als könne sie eine höhere übersteuern. Regeln kommen in einem eigenen Abschnitt an. Erkenntnisse von Agenten kommen als zu prüfender Rat an. Deine persönlichen Präferenzen kommen unter einer Überschrift an, die dem Agenten sagt, dass die Regeln und verpflichtenden Prüfungen des Workspace Vorrang haben. Ein Absatz, der genauso laut klingt wie eine Anforderung, ist ein Absatz, der statt ihrer befolgt werden kann, und genau das soll die Struktur verhindern.

Das meint „Autorität wird kodiert, nicht eingeebnet“ in der Praxis, und darin liegt der Unterschied zwischen einer strukturierten Repräsentation und einem Haufen Sätze.

Dokumente und Atome

Deine Memories, Regeln und Skills bleiben genau das, was sie sind: die Oberfläche, die ein Mensch schreibt, bearbeitet und diskutiert. Die strukturierte Form ist eine Repräsentation davon, kein Ersatz dafür.

Rule document
    |
    +-- what must not happen
    +-- what must be verified
    +-- why

Ein Dokument kann mehrere Arten von Wissen enthalten. Das ist normal, und genau deshalb sind ein Container und eine Einheit nicht dasselbe.

Am wichtigsten ist, woher die bindenden Arten stammen. Eine Anforderung stammt nur aus einer Regel, die ein Mensch festgelegt hat. Eine Regel kann außerdem eine ausführbare Einschränkung enthalten; eine Einschränkung, die ein Agent vorschlägt, wird als Vorschlag gespeichert und erst durchgesetzt, wenn ein Mensch sie freigibt. Nichts, was ein Modell ableitet, wird von selbst zur Anforderung. Siehe Proposed Knowledge.

Konflikte

Zwei Ratschläge können beide plausibel wirken und sich trotzdem widersprechen. Pathrule überlässt es nicht dem Agenten, diesen Widerspruch aufzulösen.

• Erkenntnisse. Wenn sich zwei Erkenntnisse, die Agenten über den Code festgehalten haben, widersprechen, werden beide zurückgehalten, statt zwischen ihnen zu raten.
• Präferenzen. Wenn du eine Präferenz vermittelst, die einer früheren zur selben Art von Arbeit widerspricht, ersetzt die neuere sie, und die ältere wird mit einem Verweis auf ihre Nachfolgerin stillgelegt.
• Regeln und Präferenzen. Eine Regel hat immer Vorrang vor einer persönlichen Präferenz. Siehe User Intelligence.

Zwei widersprüchliche Ratschläge sind schlechter als gar keiner, und erst die Struktur ermöglicht es Pathrule zu erkennen, wann das passiert.