Seminar Claude Code – Agentenworkflows für bestehende Codebasen

Claude Code verbindet die Analyse eines Repositorys mit Dateiänderungen und der Ausführung von Entwicklungswerkzeugen. Damit lassen sich zusammenhängende Aufgaben bearbeiten, die über einzelne Codevorschläge hinausgehen. Das Seminar vermittelt, wie solche Aufgaben eingegrenzt, vorbereitet und anhand überprüfbarer Zwischenschritte gesteuert werden.

Eine bestehende Anwendung bildet den roten Faden: Zunächst werden Architektur und Tests untersucht, anschließend eine Funktion ergänzt und schließlich eine fehlerhafte Bearbeitung korrigiert. Projektanweisungen, Freigaben und technische Isolation werden gemeinsam betrachtet. Die Verantwortung für eine fachlich richtige und wartbare Änderung bleibt beim überprüfenden Entwicklungsteam.

Lernziele

• Claude Code für bestehende Projekte konfigurieren und den Arbeitskontext prüfen.
• CLAUDE.md und wiederverwendbare Aufgabenhilfen strukturiert einsetzen.
• Planung, Implementierung und Verifikation mit klaren Freigabegrenzen organisieren.
• Fehler, unerwünschte Änderungen und unzureichende Testergebnisse nachvollziehbar bearbeiten.

Seminarinhalte

• Arbeitsumgebung und Zugriffe
• Codebasis und Projektanweisungen
• Planen und kontrolliert implementieren
• Tests und Fehlersuche
• Erweiterung und Wiederverwendung
• Git, Review und Wiederherstellung

Arbeitsumgebung und Zugriffe

Installation, Authentifizierung und Projektstart werden durchgeführt. Lesezugriff, Dateiänderungen und Terminalausführung erhalten passende Grenzen. Freigabeeinstellungen und Sandbox-Möglichkeiten werden geprüft; ein lokaler Prozess wird nicht mit einer vollständig lokalen Modellverarbeitung gleichgesetzt.

Codebasis und Projektanweisungen

Codepfade, Abhängigkeiten und Testbefehle werden untersucht und in knappen Projektanweisungen festgehalten. CLAUDE.md enthält überprüfbare Konventionen, Architekturgrenzen und Arbeitsbefehle. Widersprüche zwischen Anweisung, veralteter Dokumentation und tatsächlichem Code werden sichtbar gemacht.

Planen und kontrolliert implementieren

Eine Änderung wird zunächst in Teilaufgaben zerlegt. Der Plan beschreibt betroffene Dateien, Risiken und Prüfschritte. Bei der Implementierung werden Umfang und Zwischenstände regelmäßig geprüft. Eine unproduktive Bearbeitung wird beendet und mit klarerem Auftrag fortgesetzt.

Tests und Fehlersuche

Claude Code unterstützt bei der Interpretation fehlgeschlagener Tests und der Formulierung zusätzlicher Fälle. Die Übung unterscheidet einen Fehler im Produktcode von einem falschen Test und einer fehlerhaften Umgebung. Unbelegte Erfolgsmeldungen werden mit tatsächlichen Testausgaben abgeglichen.

Erweiterung und Wiederverwendung

Wiederkehrende Aufgaben werden als gepflegte Arbeitsanleitungen oder geeignete Skills organisiert. Ein vorbereiteter MCP-Dienst verdeutlicht die Anbindung zusätzlicher Werkzeuge. Für getrennte Analyseaufgaben werden unterstützte Agentenfunktionen eingeordnet, einschließlich gemeinsam genutzter Dateien und Integrationsaufwand.

Git, Review und Wiederherstellung

Ein zusammenhängender Patch wird auf Nebenänderungen, Fehlerbehandlung und wartbare Struktur geprüft. Git bildet den verlässlichen Ausgangspunkt für die Rücknahme. Sitzungsbezogene Wiederherstellungsfunktionen werden auf ihren tatsächlichen Umfang geprüft; externe Seiteneffekte werden separat betrachtet.

Praxisprojekt

1. Das Repository vorbereiten, Ausgangstests ausführen und zulässige Aktionen festlegen.
2. Architektur und Prüfbefehle untersuchen und in einer kurzen CLAUDE.md festhalten.
3. Eine Änderung mit Akzeptanzkriterien planen und den Plan fachlich kontrollieren.
4. Die Änderung schrittweise implementieren und echte Testergebnisse auswerten.
5. Einen bewusst eingebauten Fehler diagnostizieren und die Korrektur überprüfen.
6. Den vollständigen Diff abnehmen und einen nachvollziehbaren Commit samt Änderungsbeschreibung erstellen.

Arbeitsumgebung

Ein unterstütztes Betriebssystem mit Claude Code, Git, Testwerkzeugen und freigegebenem Claude-Zugang mit ausreichendem Kontingent ist erforderlich. Ein vorbereitetes Projekt sowie ein isolierter Übungsdienst werden verwendet.

Die Schulungsumgebung wird vom Kunden bereitgestellt. Installation, Zugänge, erforderliche Lizenzen beziehungsweise Nutzungskontingente und die Funktionsfähigkeit des Übungsprojekts werden vor dem Termin abgestimmt und geprüft.