Wie bringt man einen KI-Assistenten dazu, die Coding-Konventionen des Projekts einzuhalten?

Question

Accepted Answer

Eine KI orientiert sich standardmäßig an einem generischen Durchschnitt ihrer Trainingsdaten. Um **deinen** Stil zu erhalten, musst du ihn also **vorgeben und durchsetzen** — über Beispiele, eine explizite Regeldatei und eine Linter-Schleife, die alles abfängt, was durchrutscht. Verlasse dich nicht darauf, dass die KI deine Standards errät (WordPress Coding Standards, PSR-12 usw.).

## Techniken (nach Wirkungsgrad geordnet)

- **Stelle die Linter-Konfiguration und Beispiele bereit** — füge deine `.eslintrc`, `phpcs.xml` oder `.editorconfig` ein. Das sind die Regeln in maschinell prüfbarer Form, und die KI kann sie lesen.
- **Pflege eine Regel-/Anweisungsdatei** — eine `CLAUDE.md` oder ein System-Prompt, der den Standard explizit benennt: "Dieses Projekt folgt **PSR-12**. Verwende 4 Leerzeichen Einrückung, Klammern in der nächsten Zeile bei Funktionen, snake_case für Hooks." Dauerhafte Anweisungen sind besser, als sich bei jedem Prompt zu wiederholen.
- **Zeige repräsentativen, vorhandenen Code** — ein oder zwei saubere Dateien vermitteln Benennung, Struktur und Idiome schneller als jede Beschreibung. Die KI gleicht Muster anhand dessen ab, was sie sieht.
- **Führe den Linter über die KI-Ausgabe aus und spiele die Fehler zurück** — der zuverlässigste Schritt. Der Linter ist die maßgebliche Wahrheit; füge seine Fehler ein und bitte die KI, sie zu beheben.

## Die Linter-Schleife

```bash
# 1. AI generates the change, then you run the project linter on it:
phpcs --standard=phpcs.xml src/NewClass.php
# => src/NewClass.php  12 | ERROR | Expected 1 space after FUNCTION keyword; 0 found
#    src/NewClass.php  14 | ERROR | Line indented incorrectly; expected 4 spaces, found 2

# 2. Paste those exact errors back to the AI: "Fix these phpcs errors."
# 3. Re-run until clean. The linter — not the AI's claim — is the source of truth.
```

Diese Schleife konvergiert schnell, weil der Linter präzises Feedback auf Zeilenebene liefert, auf das die KI direkt reagieren kann, statt dass du den Stil in Prosa beschreibst.

## Warum es wichtig ist

Code, der Projektkonventionen ignoriert, erzeugt **Reibung im Review und Inkonsistenz**, selbst wenn er funktional korrekt ist — Reviewer verschwenden Zeit mit Formatierung, und die Codebasis driftet auseinander. Eine KI hat kein Bewusstsein für deinen Hausstil, sofern du ihn nicht bereitstellst. Die Aufgabe besteht also darin, die Regeln **explizit und prüfbar** zu machen: eine Regeldatei für die Absicht, repräsentativen Code für die Idiome und der Linter als Durchsetzungsinstanz in der Schleife. Dieselbe Disziplin (Konfiguration + Beispiele + automatisierte Prüfung) ist auch der Weg, einen menschlichen Teamkollegen an deine Konventionen heranzuführen.