Mit KI arbeiten: dasselbe Wort, zwei Aktionen — und eine Stunde Fehlersuche

Redaktion · · 4 Min. Lesezeit

Heute lief stundenlang nichts mehr. Keine Tickets ließen sich anlegen, jeder Versuch wurde abgewiesen. Kein Bug im klassischen Sinn, keine kaputte KI, kein Denkfehler im Code. Ein Wort.

Das ist die unauffälligste Sorte Problem, die mir beim Arbeiten mit KI begegnet — und gleichzeitig die teuerste. Nicht der falsche Algorithmus, nicht die halluzinierte Bibliothek. Eine Vokabel, die für mich das eine bedeutet und für die KI das andere.

Die Szene: Ich sage Stopp, die KI hört Los

Ich arbeite mit einer KI an einem Feature, und sie will committen. Ich sage: noch nicht. Wir sind nicht fertig, ich will die Arbeit noch nicht in Git haben. In meinem Kopf reden wir über einen Git-Commit — etwas, das ich mache, wann ich will, sobald das Feature steht.

Die KI meinte etwas anderes. Für sie hieß committen, die neue Edge Function live zu deployen, damit ihr frisch geschriebener Code in Produktion läuft. Zwei verschiedene Aktionen, ein Wort. Und keiner von uns beiden merkt im Moment, dass wir über zwei verschiedene Dinge reden.

Das Ergebnis war ein kleiner Dominoeffekt. Ich blockiere den Git-Commit. Die Edge Function bleibt undeployed. Der alte Code im Produktivsystem passt nicht mehr zum Rest, der sich schon verändert hat — und plötzlich werden alle neuen Tickets abgewiesen.

Eine Stunde, bis der Groschen fällt

Ich suche im Code. Ich suche in den Logs. Ich suche überall, nur nicht an der Stelle, die ich selbst verriegelt hatte. Eine Stunde später fällt der Groschen: Die neue Function war nie live gegangen. Genau das, was ich verhindert zu haben glaubte, war das eigentliche Problem. Mein Stopp war kein Schutz, sondern die Ursache.

Der Fix war trivial — Function deployen, fertig. Die Lektion nicht.

Warum das beim Arbeiten mit KI fast zwangsläufig passiert

Wenn du mit einer KI arbeitest, teilt ihr euch keine gemeinsame Bedeutung der Wörter. Commit, Deploy, live, fertig — das sind für dich klare Begriffe, weil du den ganzen Kontext im Kopf hast: dein Setup, deine Pipeline, deine Gewohnheit, wann was wohin geht.

Die KI hat einen anderen Kontext. Sie kennt tausend Projekte, in denen committen und deployen praktisch dasselbe sind, weil ein Push automatisch ausliefert. Dieselbe Vokabel zeigt auf zwei Aktionen, und beide Seiten sind überzeugt, eindeutig gewesen zu sein. Das ist der Punkt, an dem es kippt: nicht weil jemand schlampig war, sondern weil ein Wort zwei Türen öffnet.

Der Fix: ein kleines Dictionary statt großer Hoffnung

Mein Tipp ist unspektakulär und genau deshalb wirksam: Leg dir ein Dictionary an. Definiere die wenigen Aktionen, die wirklich wehtun, wenn man sie verwechselt, und gib ihnen eindeutige Namen.

Ein Commit ist bei mir ab jetzt immer ein Git-Commit. Eine Änderung am Produktivsystem heißt Deploy oder Edge-Deploy, nie einfach Commit. Ein Wort, eine Aktion. Bei mir steht das direkt in der CLAUDE.md, damit es in jeder Session greift:

## Vokabular — ein Wort, eine Aktion

- Git-Commit / Git-Push = Code ins Repo. Ändert NICHT das Produktivsystem.
- DB-Migration = Schema oder Daten in der Datenbank ändern.
- Edge-Function-Deploy = Function hochladen, geht live.

## Regel: Verb nie ohne Objekt

- Nicht "committen" oder "deployen" allein.
- Sondern: "Code committen" / "Migration X ausführen" / "Edge Function Y deployen".

Die zweite Zeile ist die wichtigere. Ein nacktes Verb wie committen oder deployen ist die eigentliche Falle, weil es das Objekt offenlässt — und die KI füllt die Lücke mit ihrem Kontext, nicht mit deinem. Lass kein Verb ohne Objekt stehen.

Fazit

Die teuersten Probleme beim Arbeiten mit KI sind oft keine technischen, sondern sprachliche. Dasselbe Wort, zwei Aktionen, und niemand merkt es, bis das System steht. Du kannst dagegen nicht anhoffen — aber du kannst die Mehrdeutigkeit aus dem entscheidenden Vokabular herausnehmen.

Ein kleines Dictionary, die Regel kein Verb ohne Objekt, beides in der CLAUDE.md. Mehr braucht es nicht, damit dein Stopp auch ein Stopp ist und kein verstecktes Los.

So ein Vokabular ist letztlich nur eine Leitplanke — und Leitplanken, die funktionieren, halten die tägliche Arbeit mit KI berechenbar. Wer das lieber sauber aufsetzt, statt es eine Stunde zu spät zu debuggen, dem helfe ich genau dabei in der KI-Beratung.

Entdecke mehr