Communitygithub.com

TDD – Rot-Grün-Refactoring

Erzwingt den Red-Green-Refactor-Zyklus: Kein Produktivcode ohne vorherigen fehlschlagenden Test. Verhindert KI-Schummeleien (Tests nach der Implementierung schreiben). Bei jeder neuen Funktion oder Fehlerbehebung zu verwenden.

Was ist TDD – Rot-Grün-Refactoring?

Diese Fertigkeit implementiert den klassischen Red-Green-Refactor-TDD-Zyklus für KI-Agenten. Sie stellt sicher, dass vor der Produktion immer ein Test fehlschlägt – kein Code wird ohne fehlschlagenden Test geschrieben. Die Fertigkeit blockiert bewusst Anti-Patterns wie implementationsgekoppelte Tests, tautologische Behauptungen oder horizontale Slicing-Ansätze. Der Agent muss zuerst die zu testende öffentliche Schnittstelle (Seam) mit dem Benutzer abstimmen, bevor er Tests schreibt. Der Zyklus folgt einer strengen Reihenfolge: Rot (ein fehlschlagender Test), Grün (minimaler Code zum Bestehen), Refactor (Struktur verbessern ohne Verhaltensänderung). Empfohlen für Claude Code, Cursor, Codex und alle KI-gestützten Entwicklungstools, die TDD rigoros durchsetzen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add chirag127/skill-tdd

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht TDD – Rot-Grün-Refactoring?

Das eiserne Gesetz

KEIN PRODUKTIVCODE OHNE EINEN VORHERIGEN FEHLSCHLAGENDEN TEST.

Code vor dem Test geschrieben? Lösche ihn. Fange neu an. Keine Ausnahmen – behalte ihn nicht als „Referenz“, „passe ihn nicht an“ beim Schreiben der Tests, schau ihn nicht an. Frisch aus den Tests implementieren.

Den Buchstaben der Regeln zu verletzen bedeutet, den Geist zu verletzen.

Auslöser

Auslösen bei: „TDD das“ · „rot-grün-refactor“ · „test-first“ · neue Funktion · Fehlerbehebung · Refactoring · Verhaltensänderung. Im AFK-Modus Aufgabe pro [[afk-vs-hitl-tasks]] mit vorhandener Testinfrastruktur, löse leise aus.

Ausnahmen (vorher fragen): Wegwerfprototypen, generierter Code, Konfigurationsdateien.

Denkst du „TDD nur dieses eine Mal überspringen“? Hör auf. Das ist Rationalisierung – siehe references/rationalizations.md falls du schwankst.

Vorbedingung

Testzyklus <60s pro [[feedback-loops-are-the-ceiling]]. Langsamer Zyklus → zuerst den Zyklus fixen, nie TDD überspringen, um langsamen Tests auszuweichen.

Lies CONTEXT.md + Bereich-ADRs zuerst – Testnamen und Schnittstellen-Vokabular passen zur Projekt-Domänensprache. (Domänenvokabular-Schritt von Matt Pocock 2026-07-08.)

Seams – vorher zustimmen

Seam = öffentliche Grenze, an der du das Verhalten beobachtest, ohne ins Innere zu greifen. Tests leben an Seams, niemals gegen Interna. Code ändert sich; an Seams verankerte Tests überleben.

Bestätige Seams mit dem Benutzer, bevor du Tests schreibst. Kein Test an nicht bestätigtem Seam. Aufwand landet auf kritischen Pfaden + komplexer Logik, nicht auf jedem Randfall. Frage: „Welche Seams sollen wir testen?“ (Seam-Framing von Matt Pocock 2026-07-08.)

Der Zyklus – strikte Reihenfolge

SchrittAktionMuss überprüfen
ROTEIN fehlschlagender Test an einem vereinbarten Seam. Kleinstes beobachtbares Verhalten. Echter Code, keine Mocks, es sei denn unvermeidbar. Klarer Name, kein „und“.Test SCHLÄGT FEHL mit dem erwarteten Fehler. Sofort bestanden? Du testest vorhandenes Verhalten – korrigiere den Test. Fehler? Behebe Fehler, führe erneut aus, bis er korrekt fehlschlägt.
GRÜNMinimaler Code zum Bestehen. Keine YAGNI-Optionen. Keine ungetestete Fehlerbehandlung.Test BESTEHT. Andere Tests bestehen noch. Ausgabe makellos. Fehlschlagend? Korrigiere Code, niemals den Test.
REFACTORExtrahiere tiefe Module pro [[deep-modules-over-shallow]]. Benenne zur Klarheit um. Füge im Refactor niemals Verhalten hinzu.Bleibt grün.
SCHLEIFENächster fehlschlagender Test. Vertikaler Schnitt – ein Test → eine Implementierung → wiederholen, jeder ein Tracer-Bullet, der auf das antwortet, was der letzte Zyklus gelehrt hat. Zurück zu ROT.—

Anti-Patterns – gesperrt

  • Implementationsgekoppelt – mocks interne Kollaborateure, testet private Methoden, behauptet durch Nebenkanäle (DB-Abfrage statt Schnittstelle). Zeichen: bricht bei Refactor, wenn Verhalten unverändert.
  • Tautologisch – Behauptung berechnet erwarteten Wert genauso wie der Code (erwarte(add(a,b)).toBe(a+b), handabgeleiteter Snapshot, Konstante-gleich-sich-selbst). Besteht durch Konstruktion. Erwartete Werte aus unabhängiger Quelle: bekannte Literale, durchgerechnetes Beispiel, Spezifikation. (Tautologisches Framing von Matt Pocock 2026-07-08.)
  • Horizontales Slicing – alle Tests zuerst, dann gesamte Implementierung. Verifiziert imaginiertes Verhalten; Tests werden unempfindlich gegenüber echten Änderungen. Arbeite nur in vertikalen Schnitten. (Horizontal-vs-vertikal-Framing von Matt Pocock 2026-07-08.)

Anti-Cheat – gesperrt

  • MUSS fehlschlagende Testausgabe sehen, bevor Produktivcode geschrieben wird.
  • DARF NICHT mehrere Tests schreiben, bevor der erste bestanden ist.
  • DARF NICHT den Refactor überspringen.
  • DARF NICHT den Test nachträglich umschreiben, um zur Implementierung zu passen.

Test NACH Code geschrieben = codeförmig, nicht spezifikationsförmig. Widerspricht dem Zweck.

Ausgabeform pro Zyklus

SEAM:     <öffentliche Schnittstelle unter Test>
RED:      <Testname> → <erwartete Fehlermeldung>
GREEN:    <geänderte Dateien, LOC-Delta>
REFACTOR: <was extrahiert/umbenannt wurde>

Querverweise

Verwandte Skills