Mit KI arbeiten: dasselbe Wort, zwei Aktionen — und eine Stunde Fehlersuche
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.
Das eigentliche Risiko
Der Fehler steckte nicht im Code, sondern im Wort. Solche Missverständnisse werfen keine Fehlermeldung. Sie verstecken sich, bis das System steht — und dann suchst du an der falschen Stelle, weil du sicher bist, das Richtige getan zu haben.
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.
Fünf Minuten, die eine Stunde sparen
Das Dictionary kostet dich einmal fünf Minuten. Dafür nimmt es der KI die Chance, genau das Richtige zu tun, das du gerade verboten hast — und dir die Stunde Fehlersuche an der falschen Stelle.
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
Die KI macht, was sie will — und keine CLAUDE.md, kein Memory, keine Regel der Welt hält sie auf
Du schreibst Regeln, pflegst Memories, baust Guidelines — und nach einer Woche dreht sich alles wieder im Kreis. Warum das so ist und was wirklich hilft.
BlogWenn die KI „Ja“ sagt, ohne zu fragen — und plötzlich die Datenbank weg ist
Cascading Failures, Sycophantic Confirmation, Silent Failure: die unterschätzte Risikoklasse bei KI-Agenten — und wie wir sie bei boostN.ai lösen.
BlogEin Plan-Bereich pro Projekt — mit Datei-Anhängen, die auch die KI lesen kann
Pläne als Rich-Text, Dateien per Drag & Drop dran, und der KI-Agent liest beides mit. Wie der neue Plan-Bereich in boostN den Projektkontext bündelt.