Handoff and Handover in Cross Model KI Projekten

Übergabe von KI-Arbeit als Sphinx-Dokumentation

Der Beitrag von Armin Stroß-Radschinski drehte sich um ein praktisches Problem beim Arbeiten mit KI: Wie bekommt man das, was in einer langen Session entstanden ist, wieder heraus — für ein Team, für die nächste Session oder für den Wechsel zu einem anderen Modell?

• Der Handoff-Prompt: Zuerst soll das Modell wiedergeben, was es verstanden hat, statt sofort loszulaufen. Dann „answer always in handoff mode": Alles so aufbereiten, dass es in ein leeres System wieder eingespeist werden kann.
• Das Zielformat: Sphinx mit MyST-Markdown-Erweiterungen und Furo-Theme — also die Ausdrucksmöglichkeiten von reStructuredText in Markdown, mit Navigation, Seiten-Inhaltsverzeichnis und Volltextsuche. Verlangt wird ein vollständiges Repo mit README, pyproject.toml, conf.py, Build-Befehl und Auto-Build-Server für die Live-Vorschau, ausdrücklich ohne altmodische requirements.txt und komplett per uv als One-Liner installierbar. Wenn das Ergebnis nicht passt, bekommt das Modell einfach ein Repo als Vorlage, in dem es schon so gemacht ist.
• Der Rückweg: Das fertige Repo lässt sich als ZIP in die nächste Session werfen. Eine Sphinx-Doku im Kontext liest ein Modell deutlich besser als eine Webseite, und README samt Konfiguration liegen gleich mit dabei.
• Zwei Beispiele: einmal die Kommunikation für die Plone-Konferenz in Maastricht, bei der aus zwei Essays zehn LinkedIn-Posts entstehen sollten, einmal die Steuerung eines Astronautentrainers mit Mechanik, Sensorik und Servomotor-Controller, inklusive offener Punkte, Testaufbau, Simulation ohne angeschlossene Hardware und Changelog.
• Nebenbei zur Effizienz: Große Quellen vorher eindampfen — Eine Dokumentation lag als mehrere hundert MB großes HTML Archiv vor und wurde erst einmal auf den tatsächlich benötigten Umfang reduziert. Und in der Sphinx Repository-Philosophie steht der Satz, der die Richtung vorgibt: „Goal is long-term maintainability rather than cleverness."

Inspiration waren die Fragen aus der Runde zur Installation des ersten Beitrags. Daraufhin zeigte der Beitrag von Armin Stroß-Radschinski wie die Oneliner Installationsanweisung Teil der Dokumentation werden kann um die Dokumentation selbst zu bauen.

Diskussion: Lesbarkeit, Sprachen und KI

Aus dem One-Liner-Thema entwickelte sich die Grundsatzfrage des Abends: Wenn Code zunehmend von der KI geschrieben und immer seltener von Menschen gelesen wird — trägt dann das Hauptargument für Python, seine Lesbarkeit, überhaupt noch? Werden Hochsprachen wieder von maschinennäheren Sprachen abgelöst?

• Dagegen sprach aus Armins Sicht: Gut lesbarer Code ist die Dokumentation dessen, was er soll. Aus Maschinencode lässt sich zwar das Wie zurückgewinnen, nicht aber der Zweck. Und man liest weit mehr Code, als man schreibt.
• Er innerte an Alan Kays Gedanken zu domänenspezifischen Sprachen und Hardware, ebenso das Bild von Sprache als Werkzeug, das sich nach den Anwendungsfällen formt (aus Erkenntnissen von William Bennett aus der Forschung zu unterrepräsentierten/ Minderheitssprachen).
• Aus dieser Perspektive sind die eigentliche Bremse die Trainingsdaten: Eine neu erfundene Sprache wäre für ein Modell nicht (sofort) produktiv nutzbar. Umgekehrt profitieren Sprachen, für die genug Material existiert — mehrere sahen Rust dadurch noch einmal deutlich im Aufwind.
• Aus der Runde kam von Christian der Hinweis: Der Schritt zurück passiert schon: Shell-Pipelines mit awk, sed und grep, für die man von Hand einen Tag bräuchte, kommen aus dem Modell fertig heraus — und funktionieren auch auf einer Kiste ohne Netz.
• Und es gibt eben die Kehrseite: Wenn eine KI ein komplettes Release auf einmal ausschüttet, fehlt genau das schrittweise Verständnis, für das agiles Entwickeln einmal angetreten war. 

Link zum Protokoll des Abends auf der PyCologne.de Webseite die seit einigen Monaten wieder online ist.

Das ungewungene monatliche deutschsprachige PyCologne Discussions Format findet an jedem 2. Mittwoch im Monat in Köln statt. Aktuelle und Infos zur Location, ggf. Änderungen und den größeren englischsprachigen Events findet Ihr auf dem auf auf der Webseite verlinkten Meetup.com account.