Seminar Coding-Assistenten – Kontext und Repository-Regeln

Unpräzise Anforderungen und widersprüchlicher Projektkontext führen häufig zu Änderungen, die zunächst überzeugend aussehen, aber vorhandene Konventionen verletzen. Das Seminar vermittelt ein systematisches Verfahren zur Vorbereitung, Durchführung und Bewertung von KI-gestützten Entwicklungsaufgaben. Im Mittelpunkt stehen überprüfbare Anforderungen und kurze, wartbare Regeln.

An einem gewachsenen Repository werden Architekturgrenzen, Testbefehle und fachliche Begriffe erarbeitet. Anschließend wird dieselbe Aufgabe mit unterschiedlichen Kontextpaketen durchgeführt. Die Ergebnisse werden anhand von Änderungen und Tests verglichen. Projektregeln werden dabei als Orientierung für das Modell behandelt; Zugriffsverbote müssen zusätzlich mit geeigneten technischen Mitteln durchgesetzt werden.

Lernziele

• Aufgaben in kleine, unabhängig überprüfbare Änderungen zerlegen.
• Relevante Dateien, Schnittstellen, Beispiele und Tests gezielt bereitstellen.
• Repository-Regeln widerspruchsfrei strukturieren und im Team versionieren.
• Die Wirkung von Kontextänderungen mit einem festen Aufgabenbestand bewerten.

Seminarinhalte

• Anforderungen und Akzeptanzkriterien
• Kontext für bestehende Codebasen
• Regeln und Werkzeugunterschiede
• Wiederholbare Arbeitsabläufe
• Kontextqualität bewerten

Anforderungen und Akzeptanzkriterien

Aus Tickets entstehen Aufgaben mit fachlichem Ziel, Nichtzielen und überprüfbaren Erfolgskriterien. Erwartete Fehlerfälle, bestehende Schnittstellen und zulässige Abhängigkeiten werden festgehalten. Eine Implementierungsplanung wird erst freigegeben, wenn Annahmen und offene Fragen sichtbar sind.

Kontext für bestehende Codebasen

Architekturübersichten, betroffene Aufrufpfade, Testkonfiguration und relevante Änderungsverläufe werden verdichtet. Umfangreicher Kontext wird gegen gezielte Auswahl abgewogen. Veraltete Dokumentation und widersprüchliche Beispiele werden erkannt und bereinigt, bevor sie neue Fehler in die Bearbeitung tragen.

Regeln und Werkzeugunterschiede

Repositoryweite und auf Teilbereiche begrenzte Regeln werden formuliert. AGENTS.md, CLAUDE.md, Copilot-Anweisungen und editorbezogene Regeldateien werden anhand ihrer jeweiligen Geltungsbereiche eingeordnet. Prioritäten und Unterstützung unterscheiden sich nach Werkzeug und Oberfläche; Regeln werden deshalb praktisch überprüft.

Wiederholbare Arbeitsabläufe

Planung, Umsetzung, Testausführung und Review werden als getrennte Bearbeitungsschritte dokumentiert. Wiederverwendbare Aufgabenvorlagen enthalten Abbruchbedingungen und Prüfbefehle. Übergaben zwischen Sitzungen beschreiben den tatsächlichen Repository-Zustand und noch offene Punkte.

Kontextqualität bewerten

Mehrere repräsentative Aufgaben werden mit und ohne überarbeitete Regeln bearbeitet. Verglichen werden fachliche Korrektheit, Nebenänderungen und Nacharbeit. Daraus entsteht eine kleine Regelbibliothek mit Zuständigkeit, Versionsstand und Verfahren zur Pflege. Eine erneute Durchführung mit einem zusätzlichen Beispiel zeigt, ob die Verbesserung auch außerhalb der zuerst verwendeten Aufgabe trägt.

Praxisprojekt

1. Eine unklare Änderungsanforderung in Ziel, Grenzen und Akzeptanzkriterien zerlegen.
2. Die benötigten Dateien und Testbefehle eines Beispielrepositories ermitteln.
3. Knappe Projektregeln und eine wiederverwendbare Arbeitsvorlage anlegen.
4. Die Aufgabe mit zwei Kontextvarianten durchführen und die Änderungen sichern.
5. Ergebnisse bewerten, widersprüchliche Regeln korrigieren und eine Teamversion freigeben.

Arbeitsumgebung

Ein freigeschalteter Coding-Assistent, ein Git-Repository mit Tests und eine gemeinsame Python- oder TypeScript-Laufzeit sind erforderlich. Werkzeugübergreifende Unterschiede werden zusätzlich anhand vorbereiteter Konfigurationen verglichen.

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.