Wissen — die Dokumente der Firma

Im Wissen liegen die Dokumente, die erklären, wie eure Firma arbeitet: das Handbuch, die Vereinbarungen mit einem Kunden, der Grund, warum ihr etwas anders macht als alle. Das ist das, was der Agent durchsucht, wenn er eine Frage nicht aus Datensätzen beantworten kann.

Drei Arten von Dokument

kyte kennt drei Arten von Dokument. Sie sehen gleich aus — Markdown, ein Titel, etwas Text —, liegen aber an verschiedenen Orten. Davon hängt ab, wer sie sieht und wo du sie änderst.

liegt wer es sieht wo du es änderst
Ein Dokument in deinem Ordner als Markdown-Datei in dem Ordner, den du gewählt hast, auf diesem Rechner wer diesen Ordner öffnen kann im Wissen oder in jedem Editor
Eine Notiz an einem Datensatz im Arbeitsbereich, an einem Kunden, Projekt, einer Aufgabe … alle, die diesen Datensatz sehen dürfen — Kollegen und der Agent eingeschlossen am Datensatz
Die Firmenbeschreibung Prozesse, Rollen und Richtlinien, im Arbeitsbereich alle im Arbeitsbereich in der App, zu der sie gehört — ein Prozess in Prozesse

Ein Dokument in deinem Ordner

Zeigt das Wissen auf einen Ordner, sind eure Dokumente gewöhnliche Markdown-Dateien darin: in jedem Editor änderbar, vom Betriebssystem durchsuchbar, gesichert von dem, was diesen Ordner ohnehin sichert. Die Unterordner sind der Baum links.

Die Datei ist die Wahrheit, und sie ist die einzige Fassung. kyte speichert nichts darüber in der Datenbank. Darum wandert auch nichts davon zu deinen Kollegen oder zu einem Agenten auf einem Server: Der Ordner gehört diesem Rechner. Teilt euer Team den Ordner — ein Netzlaufwerk, ein Git-Repository —, sieht jeder dieselben Dateien, weil der Ordner geteilt ist, nicht weil kyte etwas kopiert.

kyte beobachtet den Ordner. Eine Datei, die du in einem anderen Editor änderst, aus dem Finder hineinziehst oder per Git holst, erscheint sofort. Ändert sich das Dokument, das du gerade offen hast, auf der Platte, während du tippst, entscheidet kyte nicht für dich: Es sagt es dir, und du wählst Datei laden oder Meine behalten.

Für diese Dokumente gibt es in kyte keinen Verlauf. Ein Ordner, der einen Verlauf will, ist ein Git-Repository.

Eine Notiz an einem Datensatz

An jedem Datensatz — einem Kunden, einem Projekt, einer Aufgabe — schreibt Wissen → + Neu eine Notiz über diesen Datensatz. Sie liegt im Arbeitsbereich, nicht in einem Ordner. Darum erreicht sie alle, die den Datensatz sehen dürfen, auch den Agenten auf einem Server. Sie hat einen Verlauf wie der Datensatz selbst.

Die Firmenbeschreibung

Wie die Firma arbeitet, so aufgeschrieben, dass Menschen und Agenten danach handeln können: ihre Prozesse, Rollen und Richtlinien. Ein Prozess ist ein Teil davon — du schreibst und startest ihn in Prozesse.

Ist der Ordner, den du gewählt hast, schon das Beschreibungs-Repository eurer Firma (er enthält eine company.yaml), sind seine Dateien Dateien wie alle anderen: Du liest, änderst, benennst und löschst sie im Wissen. kyte lässt stehen, was sie zur Beschreibung macht — die api:-Zeile, die Kennung, den Verantwortlichen — und ändert nur den Titel und den Text, den du tippst. Soll eine Änderung erst geprüft werden? Dann liegt der Ordner in git, und ihr committet wie gewohnt.

Eines schreiben

+ Neu für ein Dokument im ausgewählten Ordner, mit Titel und einem Text in Markdown. Ein Dokument öffnen heißt, es zu bearbeiten — es gibt keinen Bearbeiten-Modus. Überschriften, Listen, Tabellen, [[Verweise]] zwischen Dokumenten — derselbe Umfang, den auch das Gespräch darstellt.

Was der Agent damit macht

Er liest sie. „Was haben wir mit Northwind zur Rechnungsstellung vereinbart?" durchsucht die Dokumente, die du sehen darfst, und antwortet daraus, mit der Angabe, wo es steht. Der Agent auf deinem Rechner liest deinen Ordner; ein Agent auf einem Server sieht die Notizen an Datensätzen und die Firmenbeschreibung, nie deinen Ordner.

Er kann auch eines schreiben: „Schreib auf, was wir gerade entschieden haben, als Dokument ins Wissen." Das ist ein Schreibvorgang, wird dir also vorher gezeigt.

Was hierher gehört und was nicht

Das Wissen ist die Bibliothek der Firma. Ein Ordner, den du dem Agenten für eine Aufgabe gibst, ist eine Werkbank — siehe Einen Ordner freigeben.

Faustregel: Wenn ein Kollege es nächstes Jahr brauchen würde, gehört es hierher. Wenn es Gerüst für die heutige Aufgabe ist, nicht. Und wenn das ganze Team es braucht, schreib es als Notiz an den Datensatz, um den es geht, oder leg den Ordner dorthin, wo das Team ihn teilt.