Send us Fan Mail ❓ Man gibt einer KI zehn Jahre alten Legacy-Spaghetti-Code ohne jede Dokumentation und bittet sie, die Architektur zu rekonstruieren. Was dann oft passiert: Sie hält nicht inne und fragt nach, sondern fängt an, Lücken mit Plausiblem zu füllen. Ralf Müller ist seit rund 30 Jahren im Job, vom Entwickler über die Softwarearchitektur zur Dokumentation. Er hat docToolchain als Open-Source-Projekt gestartet, das seit zehn Jahren läuft, arbeitet mit arc42 und ist bei der DB Systel. Auf LinkedIn nennt er sich Problem Solver. Seit Ende 2023 lässt ihn GenAI nicht mehr los. Sein Anspruch dabei: Er sei nicht der Experte, der Modelle trainiert, sondern einer, der sie wie alle anderen anwendet, Erfahrung aufbaut und weitergibt. In der aktuellen Episode von Masters of Data, BI & AI erklärt er, wie er einer KI beibringt, bei Legacy-Code erst die richtigen Fragen zu stellen, und warum das mit Sokrates zu tun hat. Ein paar Dinge, die hängengeblieben sind: Zu semantischen Ankern: Ralf sah sich einen fremden Prompt an, der sehr gut testgetriebene Entwicklung konnte, und fand darin keine Anleitung dazu, nur den Begriff "TDD London School". Drei Wörter statt 200 Zeilen: Der Begriff ruft eine genau definierte Vorgehensweise aus den Trainingsdaten ab. Daraus wurde eine Website mit solchen Ankern, vom sokratischen Ansatz über arc42 und ADRs bis zu Wolf Schneider fürs Deutsche und Strunk & White fürs Englische. Ein Kollege nannte das Zaubersprüche. Für alle, die nicht entwickeln, rät er: präzise Fachbegriffe nutzen und die KI als Diskussionspartner behandeln, statt nur zwei, drei Wörter hineinzuwerfen. Zu Greenfield und Brownfield: Auf der grünen Wiese funktioniert es: Spezifikation, Architektur, dann testgetrieben entwickeln. Bei Legacy-Code scheitert die KI, weil sie weder Architektur noch Spezifikation kennt. Und sagt man ihr "stell Fragen, wenn du welche hast", tut sie es nicht. Seine Beobachtung: Das Modell gibt nicht zu, Fragen zu haben, und halluziniert bei offenen Punkten, etwa bei Qualitätskriterien. Zum Recovery-Prozess: Die Idee dahinter stammt von Peter Naur, der 1985 beschrieb, dass Entwickler eine Theorie der Software im Kopf haben. Gehen sie, bleibt nur der Code, und genau das ist Legacy. Ralfs Trick: Die KI bekommt nur den Auftrag, Fragen zu finden. Sie baut einen Fragenbaum, mit dicken Ästen wie Technologie-Stack, Zweck und Qualitätskriterien. Jede Frage wird entweder mit Verweis auf eine Codezeile beantwortet, verfeinert oder als offen markiert, mit dem Zusatz, welche Rolle im Team sie beantworten könnte. Das ist der sokratische Teil. Am Ende stehen eine Liste offener Fragen für Team oder Product Owner und eine Liste beantworteter Fragen mit Code-Referenz, daraus entstehen Spezifikation und Tests. Zum Test und zur Verlässlichkeit: Zum Testen hat er eigene Greenfield-Projekte genommen, die Dokumentation weggeworfen und rekonstruieren lassen. Eine zweite KI verglich danach Original und Rekonstruktion. Teilweise fand die Rekonstruktion sogar Sicherheitspunkte, die im Original fehlten. Bei einem Open-Source-Projekt von Mistral entstand eine arc42-Dokumentation, in der hinter jedem Satz ein Link auf die exakten Codezeilen steht. Fehlerfrei ist das nicht, betont er, aber jede Behauptung lässt sich per Klick prüfen. Zum Warum: Am häufigsten geht in Legacy-Projekten das Warum verloren: warum Datenbank A und nicht B, welches Qualitätskriterium dahintersteht. Wenn man das als offene Frage auf dem Tisch hat, kann man es wenigstens angehen, auch wenn niemand mehr die Antwort kennt. Bei der Jahr-2000-Zeit holte man pensionierte Entwickler zurück, die COBOL kannten. Ralf bleibt vorsichtig: Fragen bleiben, aber man sieht sie wenigstens. Zum Nachwuchs: Im Vorgespräch fiel der Satz: Wer nur Code erzeugt, sollte sich Sorgen machen, wer Probleme löst, nicht. Seine Antwort auf die Frage nach der einen Fähigkeit: Interesse an Problemen und Lösungen. Rollen wie Programmierer, Texter oder Designer werden enger fokussiert weniger gefragt sein, Expertise bleibt wichtig, aber Breite und lebenslanges Lernen zählen mehr. Und für junge Leute: die KI nicht die Hausaufgaben machen lassen, sondern sie sich erklären lassen, am besten mit dem sokratischen Ansatz, der erst fragt, was man schon weiß. Wie geht ihr mit Legacy-Code und KI um: erst Fragen sammeln lassen oder direkt dokumentieren lassen? LinkedIn Profile LinkedIn Profile von Ralf Müller: https://www.linkedin.com/in/rdmueller/ LinkedIn Profile von Rocky Khan: https://www.linkedin.com/in/khanrocky/ Business Buch How to Drive Your Competition Crazy von Guy Kawasaki: Das Buch hatte Ralf vor dem Recording in die Kamera gehalten. Kawasaki war der erste Evangelist bei Apple und beschreibt, wie er die Massen hinter sich holt. Für Ralf gehört dazu nicht nur, gute Ideen zu haben, sondern sie auch rüberzubringen, teils auf ungewöhnlichen Wegen. Dazu ein paar lustige Anekdoten. Es ist nicht mehr aufgelegt, gebraucht aber noch zu bekommen. Auch The Macintosh Way von Kawasaki empfiehlt er.