AI-Coding-Agenten im Zaum halten: Git Hooks, die wirklich funktionieren

AI-Tools schreiben Features in Rekordzeit. Toll, oder? Aber ohne Kontrolle entsteht Chaos. Riesige Dateien, verwickelte Logik – euer Codebase wird zur Katastrophe. Euer Team wird euch das nie verzeihen.

Die Lösung: Geteilte Git Hooks als Qualitätsfilter vor jedem Commit.

Das Chaos ohne Regeln

Freigelassene AI-Agenten wie Claude oder Copilot produzieren:

• Überladene Dateien, die gegen alle Prinzipien verstoßen
• Komplexe Konstrukte, die Debuggen zur Folter machen
• Wilde Commit-Nachrichten, die die Git-History unlesbar halten
• Bypass-Tricks mit --no-verify, die Checks ignorieren

Die Agenten wollen helfen. Doch sie priorisieren Tempo statt Qualität.

Git Hooks als Türsteher

Git Hooks sind Automatisierungen an Schlüsselpunkten im Workflow. Sie prüfen Code, bevor er ins Repo kommt.

Zwei Top-Frameworks:

1. pre-commit – Der Standard für Python- und gemischte Teams 2. husky – Perfekt für JavaScript, nahtlos mit npm

So sieht ein solider Setup aus:

Wichtige Hook-Regeln gegen AI-Chaos

# Beispiel pre-commit Konfig
repos:
  - repo: local
    hooks:
      - id: file-length-limit
        name: Dateigröße prüfen
        entry: python -c "sys.exit(0 if max(open(sys.argv[1]).readlines(), key=len) <= 600 else 1)"
        language: system
        types: [python]
      
      - id: cyclomatic-check
        name: Komplexität begrenzen
        entry: flake8 --max-complexity=10
        language: system
        types: [python]

Warum genau diese Grenzen?

• Max. 600 Zeilen – Stoppt AI-Dumps, lässt echte Komplexität zu
• Komplexität 10 – Funktionen bleiben testbar und klar

Hook schlägt fehl? Kein Commit. AI muss umbauen, bevor der Mist sich ausbreitet.

Tools, die Agenten brauchen

Agenten müssen Regeln einhalten. Dafür gibt's Refactoring-Power:

Python: rope zerlegt Dateien, extrahiert Methoden, organisiert Module. Agenten rufen es selbst auf.

TypeScript/JS: ts-morph mit AST-Manipulation. Baut Code um, ohne manuelle Arbeit.

Die Agenten-Charta: Klare Regeln

Legt eine AGENTS.md im Repo an – euer Regelbuch:

# Regeln für AI-Agenten

## Commit-Regeln
- Kurze, aussagekräftige Messages in Intervallen
- Mit Ticket-ID und Begründung: "feat(login): OAuth-Refresh implementieren [#123]"
- Kein Riesen-Commit pro Task

## Hooks einrichten
- `git config core.hooksPath .husky` immer ausführen
- Lokal testen, dann pushen

## Absolute No-Gos
- **Nie `--no-verify` ohne explizite User-Bestätigung**
- Erklärt, warum es nötig ist

## Code-Strategie
- TDD: Test rot → grün → refactor
- Failing Test zuerst, dann fixen, dann polieren

Keine Diktatur. Sondern klare Erwartungen, die Agenten boosten.

Vorteile fürs Team

Eure Entwickler kennen schlechten Code. Mit Hooks:

✅ Vertrauen – Main-Branch-Code ist immer solide
✅ Schnelle Reviews – Fokus auf Inhalt, nicht auf Basics
✅ Einfaches Onboarding – Standards sind sofort klar
✅ Lernende Agenten – Sie passen sich an und werden besser

Umsetzungs-Checkliste

1. Framework wählen – pre-commit für Python, husky für JS
2. Grenzen setzen – 600 Zeilen / Komplexität 10 als Start
3. Refactoring-Tools – rope oder ts-morph integrieren
4. Dokumentieren – AGENTS.md mit Begründungen
5. Schrittweise enforcen – Erst warnen, dann blocken
6. Überwachen – Fehlschläge tracken, Limits anpassen

Der Kern

Es geht nicht um Verbote. Sondern um einen Workflow, wo guter Code der einfache Weg ist. Mit Hooks, Docs und Tools lernen Agenten: Kleine Einheiten, fokussierte Funktionen, präzise Commits.

AI wird dann zum echten Turbo für euer Team.

Bei NameOcean bauen wir skalierbare Infra – von Domains über Hosting bis Dev-Workflows. Behandelt euren Codebase wie eure Infra. Fangt mit Git Hooks an. Euer zukünftiges Ich sagt Danke.