Lineare Walkthroughs zum Verständnis von Code in der Agentic Engineering Praxis

Manchmal ist es hilfreich, einen Coding-Agenten eine strukturierte Schritt-für-Schritt-Analyse einer Codebasis erstellen zu lassen.

Vielleicht handelt es sich um bestehenden Code, in den Sie sich einarbeiten müssen. Vielleicht ist es Ihr eigener Code, bei dem Sie die Details vergessen haben. Oder vielleicht haben Sie das gesamte Projekt per Vibe Coding erstellt und müssen nun verstehen, wie es tatsächlich funktioniert.

Frontier-Modelle können mit dem richtigen Agent-Harness einen detaillierten Walkthrough erstellen, der erklärt, wie der Code funktioniert.

Ein Beispiel mit Showboat und Present

Ich habe kürzlich auf meinem Mac eine SwiftUI-Slide-Präsentations-App per Vibe Coding entwickelt, unter Verwendung von Claude Code und Opus 4.6.

Ich hielt einen Vortrag über die Fortschritte bei Frontier-Modellen zwischen November 2025 und Februar 2026, und ich baue gerne mindestens einen besonderen Effekt in meine Vorträge ein (einen STAR-Moment – Something They'll Always Remember). In diesem Fall entschied ich, dass der Gimmick darin bestehen sollte, am Ende der Präsentation zu enthüllen, dass der Präsentationsmechanismus selbst ein Beispiel dafür ist, was Vibe Coding leisten kann.

Ich veröffentlichte den Code auf GitHub und stellte anschließend fest, dass ich eigentlich gar nicht wusste, wie das Ganze funktionierte – ich hatte das gesamte Projekt lediglich durch Prompts erzeugt (teilweises Transkript hier), ohne dem geschriebenen Code Aufmerksamkeit zu schenken.

Also startete ich eine neue Instanz von Claude Code für Web, verwies sie auf mein Repository und verwendete folgenden Prompt:

Read the source and then plan a linear walkthrough of the code that explains how it all works in detail. Then run “uvx showboat –help” to learn showboat - use showboat to create a walkthrough.md file in the repo and build the walkthrough in there, using showboat note for commentary and showboat exec plus sed or grep or cat or whatever you need to include snippets of code you are talking about

Showboat ist ein von mir entwickeltes Tool, das Coding-Agenten dabei unterstützt, Dokumente zu erstellen, die ihre Arbeit nachvollziehbar demonstrieren. Sie können hier die Ausgabe von showboat --help sehen, die so gestaltet ist, dass das Modell alle notwendigen Informationen erhält, um das Tool korrekt zu verwenden.

Der Befehl showboat note fügt dem Dokument Markdown-Inhalte hinzu. Der Befehl showboat exec akzeptiert einen Shell-Befehl, führt ihn aus und fügt anschließend sowohl den Befehl selbst als auch dessen Ausgabe in das Dokument ein.

Indem ich angewiesen habe, „sed oder grep oder cat oder andere Tools zu verwenden, um Code-Snippets einzubinden“, stellte ich sicher, dass Claude Code keine Codefragmente manuell in das Dokument kopiert. Dadurch wird das Risiko von Halluzinationen oder Fehlern reduziert.

Diese Methode funktionierte äußerst gut. Hier ist das Dokument, das Claude Code mit Showboat erstellt hat. Es analysiert alle sechs .swift-Dateien im Detail und liefert eine klare und praxisorientierte Erklärung darüber, wie der Code funktioniert.

Durch das Lesen dieses Dokuments habe ich viel darüber gelernt, wie SwiftUI-Apps strukturiert sind, und gleichzeitig wertvolle Details über die Swift-Programmiersprache aufgenommen.

Wenn Sie befürchten, dass Large Language Models die Geschwindigkeit reduzieren könnten, mit der Sie neue Fähigkeiten erlernen, empfehle ich dringend, solche Muster zu übernehmen. Selbst ein etwa 40-minütiges, per Vibe Coding entwickeltes Toy-Projekt kann zu einer wertvollen Gelegenheit werden, neue Ökosysteme zu erkunden und interessante neue Techniken zu erlernen.