Werkzeuge bauen

Vom Wunsch zum Werkzeug

Der Weg von der Idee bis zum freigegebenen Werkzeug, in sieben Schritten.

Ein Werkzeug baust du nicht von Hand, sondern zusammen mit einem KI-Agenten wie Claude Code. Du beschreibst, was dein Betrieb braucht. Der Agent legt die Datenstruktur an und schreibt die Dateien des Werkzeugs. Was davon in die Produktion kommt, entscheidet ein Mensch.

Drei Begriffe

Collection: Eine Collection ist ein Datenbestand mit festen Feldern, etwa eine Liste von Aufgaben. Sie lässt sich ergänzen, aber nichts daran verschwindet wieder.

Werkzeug: Ein Werkzeug ist eine kleine Webseite aus statischen Dateien, die deine Instanz unter /t/<name>/ ausliefert. Es liest und schreibt Collections über die Schnittstelle der Instanz, mit den Rechten der Person, die es gerade benutzt.

Entwurf: Der Entwurf ist der Stand der Werkzeuge, an dem du und dein Agent arbeiten. Er ist unter /t/<name>@draft/ zu sehen, und erst das Veröffentlichen macht ihn zum laufenden Stand.

Der Weg in Schritten

1. Token ausstellen. Der Agent meldet sich mit einem persönlichen Zugriffstoken unter deinem Namen an. Wähle als Raum den Übungsraum. Siehe Zugriffstoken.
2. Arbeitsplatz einrichten. Ein Befehl klont das Repository der Werkzeuge und meldet die Instanz bei deinem Agenten an. Siehe Arbeitsplatz einrichten.
3. Dem Agenten beschreiben, was du brauchst. Sag, welche Angaben das Werkzeug erfasst, wer es benutzt, wozu die Daten dienen und wie lange dein Betrieb sie aufbewahrt. Siehe Mit dem Agenten arbeiten.
4. Collection und Werkzeug entstehen. Die Collection entsteht im Übungsraum, das Werkzeug im Entwurf. Beides berührt die Produktion nicht. Siehe Collections und Felder und Aufbau eines Werkzeugs.
5. Prüfen. Öffne den Entwurf unter /t/<name>@draft/ und probiere ihn mit Übungsdaten aus. Der Agent prüft mit check_tool, ob sich der Stand veröffentlichen lässt. Siehe Entwurf und Veröffentlichen.
6. Veröffentlichen lassen. Eine Administratorin oder ein Administrator überträgt zuerst die Struktur aus dem Übungsraum in die Produktion und veröffentlicht danach den Entwurf. Siehe Aus dem Übungsraum übertragen und Werkzeuge freigeben.
7. Rechte geben. Ohne Grant sieht niemand das Werkzeug, und ohne Recht auf die Collection sieht niemand Daten. Beides hängt an einer Rolle. Siehe Rechte vergeben.

Was du vorher klären solltest

Drei Dinge lassen sich später nicht mehr korrigieren. Kläre sie, bevor der Agent beginnt:

• Feldnamen. Ein Feld, das in der Produktion steht, bleibt. Es lässt sich umbenennen und stilllegen, aber nicht löschen.
• Feldtypen. Ein Typ lässt sich nie wechseln. Ein Feld, das auf eine Person oder auf eine andere Collection zeigt, braucht von Anfang an den passenden Typ.
• Zweck und Aufbewahrungsfrist. Jede neue Collection nennt beides. Der Agent fragt dich danach.

Wenn du lieber selbst schreibst

Der Agent ist nicht Pflicht. Das Repository der Werkzeuge ist ein gewöhnliches Git-Repository, und die Schnittstelle ist HTTP mit JSON. Wie du ein Werkzeug auf deinem Rechner entwickelst, steht unter Lokal entwickeln, die Aufrufe unter Daten lesen und schreiben.