Distart Live Session · 25. August 2026
Was ist Harness Engineering?
Woraus ein Agent tatsächlich besteht — und an welcher Stelle
du ihn steuern, begrenzen und kontrollieren kannst.
①
Modell und Harness
Das Sprachmodell ist austauschbar. Was den Agenten ausmacht, ist die
Umgebung darum — im Fachjargon das Harness. Das Geschirr, das dem Pferd
sagt, woran es zieht.
// die vier Schichten
Sprachmodell
generiert Text, entscheidet nichts allein
↓
Kontext
CLAUDE.md · Skills · Dateien im Arbeitsverzeichnis
↓
Werkzeuge
Dateizugriff · Programme · MCP-Server wie Figma
↓
Grenzen
Permissions · Hooks
- Modell
Sagt das nächste Wort vorher. Dasselbe Modell, das im
Chatfenster sitzt — nur ohne Umgebung.
- Kontext
Alles, was zur Laufzeit im Fenster steht. Was nicht drin ist,
existiert für den Agenten nicht.
Deine Markenregeln gehören hier hinein, nicht in den Prompt.
- Werkzeuge
Definierte Schnittstellen, die das Modell aufrufen darf —
lesen, schreiben, ausführen, in Figma bauen.
- Grenzen
Der einzige Teil, der nicht vom Modell abhängt.
Alles darüber ist Auslegung. Erst hier wird es zwingend.
Es heißt Claude Code, weil die Umgebung aus der
Softwareentwicklung stammt. Was du hineinschreibst, ist trotzdem Prosa.
②
Die CLAUDE.md
Eine Datei im Arbeitsverzeichnis, die bei jedem Start vollständig in den
Kontext geladen wird. Sie legt fest, wer der Agent ist und was er nicht tut.
# Marketing Nordlicht Sport — Arbeitsanweisung
## Rolle
Du arbeitest dem Marketing-Team zu.
Intern duzt du, nach außen siezt du.
## Grenzen
- Du erstellst ausschließlich Entwürfe.
- Du veröffentlichst nichts — kein Post,
kein Newsletter, keine Schaltung.
- Du setzt nie auf „freigegeben".
- Jede Zahl braucht einen Beleg aus daten/.
Fehlt er, sagst du das.
## Ablage
Kampagnen: kampagnen/
Marke: marke/
Belege: daten/
- Geltungsbereich
Gilt für jede Sitzung in diesem Ordner — ohne dass
jemand sie aufrufen muss. Du schreibst sie einmal, nicht in jeden Prompt.
- Rolle
Legt Perspektive, Sprache und Ton fest.
- Grenzen
Verbote in Prosa. Das Modell liest sie und befolgt sie
in aller Regel.
In aller Regel — nicht immer. Dazu Panel ⑤.
- Hierarchie
Mehrere Dateien überlagern sich; die speziellere geht vor.
// Geltungsreihenfolge — die speziellere Anweisung verdrängt die allgemeinere
~/.claude/
Grundsätze für alle Projekte
marketing/
Regeln dieses Teams
marketing/kampagnen/
Besonderheiten einer Kampagne
Wie das Kampagnen-Briefing das Markenhandbuch überschreibt:
nur an der einen Stelle, an der etwas anderes drinsteht.
③
Die SKILL.md
Eine Arbeitsanweisung aus zwei Teilen: einem Kopf, der den Anwendungsbereich
bestimmt, und einem Körper, der die Schritte anordnet. Das, was du einem neuen
Werkstudenten am ersten Tag erklärst.
---
name: briefing-eingang
description: Nutze diesen Skill, wenn eine
neue Kampagnen-Anfrage vorliegt und die
Eingangsprüfung durchzuführen ist.
---
# Briefing-Eingang
1. Anfrage laden.
2. Fehlt Zielgruppe, Kanal oder Zeitraum:
Rückfrage stellen, abbrechen.
3. Kampagnenart und Kanal setzen.
4. Jede Aussage gegen daten/ prüfen.
Nicht gedeckt → streichen UND Ersatz
vorschlagen.
5. Status auf „in Arbeit" setzen.
- description
Der Anwendungsbereich. Das Modell prüft bei jeder Anfrage,
ob der Fall darunter fällt — und lädt den Skill nur dann.
Ist er unscharf gefasst, greift der Skill zu selten oder zu oft.
- Körper
Die angeordneten Schritte. Prosa, nummeriert,
in der Sprache deines Hauses.
- references/
Ausgelagerte Details, die erst bei Bedarf nachgeladen werden —
der Kontext bleibt schlank.
Kanalmaße, Feldwerte, Zielgruppen-Segmente.
Der häufigste Fehler ist nicht der falsche Körper,
sondern die unscharfe description: Der Skill greift dann gar nicht erst.
④
Werkzeuge
Bis hierhin kann der Agent lesen und schreiben. Ein Werkzeug ist alles,
womit er darüber hinaus etwas tut — ein Programm starten, oder über einen
MCP-Server in einem fremden System arbeiten. Zum Beispiel in Figma.
Agent
→
MCP-Server
spricht das fremde System
→
Figma
Datei, Frames, Text, Farben
// beim ersten Zugriff
Der Agent will das Werkzeug benutzen
↓
Nachfrage — erlauben oder ablehnen
↓
erst danach greift er zu
- MCP
Ein offener Standard, über den Werkzeuge angeschlossen werden.
Nicht auf einen Anbieter beschränkt.
- Nachfrage
Er fragt nicht aus Höflichkeit. Er fragt, weil er es nicht
darf, bis du es erlaubst.
Das ist schon Panel ⑤ — die zweite Stufe.
- Grenze
Ein Werkzeug zu haben heißt nicht, es überall benutzen zu
dürfen. Was erlaubt ist, steht in der settings.json.
Der Unterschied zwischen einem Chatbot und einem Agenten ist
nicht die Intelligenz. Es ist der Zugriff.
⭐️ Mitmach-Aufgabe
Welche Aufgabe dauert bei dir länger als fünf Minuten und kommt jede
Woche wieder?
Schreib sie in den Chat — und dazu den Satz, der bei dir den
Anwendungsbereich beschreiben würde.
⑤
Drei Härtegrade der Steuerung
Sie werden regelmäßig verwechselt. Der Unterschied entscheidet darüber,
ob eine Vorgabe ein Wunsch ist oder eine Kontrolle.
Instruktion
CLAUDE.md · SKILL.md
Das Modell liest die Vorgabe und wägt sie gegen den Auftrag ab.
Probabilistisch. Verhandelbar.
→
Berechtigung
settings.json · allow / deny
Das Werkzeug steht gar nicht zur Verfügung. Kein Ermessen nötig.
Deterministisch, statisch.
→
Hook
PreToolUse · exit 2
Ein Programm prüft den konkreten Aufruf und hält ihn an.
Deterministisch, situativ. Zwingend.
Wer Markenkonformität auf der ersten Stufe regelt, hat sie sich
gewünscht. Erst auf der dritten hat er sie durchgesetzt.
⑥
Wie ein Hook entscheidet
Ereignis, Anwendungsbereich, Prüfung, Ergebnis. Zwanzig Zeilen Skript,
die vor jedem einzelnen Werkzeugaufruf laufen.
Ereignis
PreToolUse
→
Anwendungsbereich
matcher
→
Prüfung
Skript, kein Modell beteiligt
↳
exit 0 — Aufruf läuft
/
exit 2 — Aufruf wird angehalten
// die zwei Hooks dieser Demonstration
Ausgangssperre — nichts geht live, in keinem Fall
Gegenleser — kein Freigabe-Paket ohne dokumentierte Prüfung
Der Hook fragt das Modell nicht um Erlaubnis.
Er läuft, bevor das Modell überhaupt etwas tun kann.
⑦
Trennung von Erstellung und Prüfung
Ein zweiter Agent mit eigenem Kontext, eigenem Auftrag und eigenen
Werkzeugen — der das Asset nicht gestaltet hat.
Gestalter
baut das Asset
→
Gegenleser
eigener Kontext, kennt den Weg dorthin nicht
→
Mensch
gibt frei
↩
Beanstandung — zurück in die Nacharbeit
Derselbe Kontext, der einen Fehler erzeugt hat,
findet ihn nicht zuverlässig wieder. Das gilt für Menschen genauso.
⑧
Wie Hauswissen in das System kommt
Der Regelfall ist nicht die Halluzination. Der Regelfall ist eine Regel,
die nirgends aufgeschrieben war — weil sie alle im Kopf hatten.
Vorgang
→
Skill greift
→
vertretbar, aber nicht euer Haus
Welche Regel fehlte?
→
drei Zeilen in die SKILL.md
→
derselbe Vorgang erneut
→
richtig
Das Gedächtnis des Agenten ist kein Blackbox-Zustand.
Es sind Zeilen in einer Datei, die du öffnen, prüfen und versionieren kannst.