laravel-tdd

Überblick über die laravel-tdd-Skill

Die laravel-tdd-Skill ist ein praktischer Leitfaden für testgetriebene Entwicklung in Laravel, bei dem du zuerst Tests schreibst und danach den Code mit PHPUnit oder Pest implementierst. Sie eignet sich besonders für Entwickler, die einen wiederholbaren Workflow für neue Features, Bugfixes, Refactorings und Testautomatisierung in Laravel wollen, ohne die Teststrategie jedes Mal neu improvisieren zu müssen.

Der Nutzen der laravel-tdd-Skill liegt darin, dass sie Entscheidungen adressiert, die Teams sonst oft ausbremsen: Welche Testschicht ist die richtige? Wann sind Datenbank-Resets sinnvoll? Wie geht man mit Fakes um? Und wie bleiben Coverage-Ziele realistisch? Dadurch ist die laravel-tdd skill deutlich handlungsorientierter als ein generischer „schreib Tests“-Prompt.

Beste Wahl für Laravel-Testautomatisierung

Nutze laravel-tdd, wenn du Testautomatisierung für Laravel-Code brauchst, der HTTP, Auth, Validierung, Eloquent, Jobs, Notifications oder Queues berührt. Sie passt besonders gut, wenn dein Projekt bereits schnelle Feedback-Schleifen schätzt und du dir mit der Skill Disziplin im Red-Green-Refactor-Zyklus sichern willst.

Wobei sie schneller Entscheidungen ermöglicht

Der Hauptwert der laravel-tdd-Skill liegt nicht in abstrakter TDD-Theorie. Sie hilft dir dabei zu entscheiden:

• ob eine Änderung mit einem Unit-, Feature- oder Integrationstest starten sollte
• ob Pest oder PHPUnit die bessere Standardwahl für das Repo ist
• wie viel Datenbank-Setup der Test wirklich braucht
• wann Fakes ausreichen und wann echte Grenzen getestet werden sollten

Wann sie möglicherweise nicht die richtige Wahl ist

Wenn du nur ein einzelnes Codebeispiel willst, ist ein breiter Laravel-Prompt oft einfacher. Die laravel-tdd-Skill ist vor allem dann wertvoll, wenn das Ergebnis zu einem funktionierenden Test-Workflow passen muss und du Wartbarkeit, Coverage und eine konsistente Struktur über mehrere Iterationen hinweg wichtig findest.

So verwendest du die laravel-tdd-Skill

Die Skill in deinem Claude-Code-Setup installieren

Installiere laravel-tdd mit:
npx skills add affaan-m/everything-claude-code --skill laravel-tdd

Das ist der Installationsschritt für laravel-tdd, den die meisten Nutzer brauchen. Nach der Installation rufst du sie in einem Laravel-Repo auf, in dem das Modell vorhandene Tests, die Testkonfiguration und den betroffenen Code prüfen kann.

Gib der Skill die richtige Aufgabenform

Die beste laravel-tdd usage beginnt mit einer konkreten Verhaltensanfrage, nicht mit einer vagen Implementierungsaufgabe. Gute Eingaben beschreiben:

• das Feature oder den Bug
• das erwartete, für Nutzer sichtbare Verhalten
• vorhandene Modelle, Routen, Controller, Jobs oder Notifications
• eine bereits im Repo genutzte Präferenz für das Testframework

Beispiel für einen stärkeren Prompt:
„Nutze laravel-tdd, um passwortloses Login per E-Mail-Link hinzuzufügen. Bevorzuge den bestehenden Teststil, schreibe zuerst den fehlschlagenden Feature-Test und implementiere dann nur den minimalen Code. Verwende Fakes, wo es passt, und halte die Tests an die aktuellen Laravel-Konventionen angepasst.“

Lies zuerst die wichtigsten Dateien

Für diesen laravel-tdd guide solltest du mit SKILL.md beginnen und danach die unterstützenden Docs im Repository prüfen, falls sie vorhanden sind. In diesem Repo ist SKILL.md die maßgebliche Quelle, und die relevantesten Abschnitte sind:

• When to Use
• How It Works
• Red-Green-Refactor Cycle
• Test Layers
• Hinweise zur Datenbankstrategie

Wenn dein Projekt eigene Laravel-Konventionen hat, vergleiche sie vor dem Schreiben von Tests mit der Skill, damit du nicht gegen den lokalen Teststil arbeitest.

Nutze einen Workflow, der zur Absicht der Skill passt

Ein guter laravel-tdd-Workflow ist:

1. das Verhalten in einem Satz definieren
2. die Testschicht wählen, die dieses Verhalten belegt
3. den fehlschlagenden Test schreiben
4. den minimalen Code implementieren, der besteht
5. erst nach Grün wieder refaktorieren

Wenn du das Modell anweist, dieser Reihenfolge zu folgen, reduzierst du erfundene Implementierungsdetails und erhältst Output, der sich in einer echten Laravel-Codebasis leichter anwenden lässt.

FAQ zur laravel-tdd-Skill

Ist laravel-tdd nur für PHPUnit-Nutzer?

Nein. Die Skill unterstützt sowohl PHPUnit als auch Pest, wobei Pest für neue Tests bevorzugt wird, außer das Projekt standardisiert bereits auf PHPUnit. Wenn dein Repo gemischt ist, sag dem Modell, welchen Stil es nachbilden soll, damit keine Inkonsistenzen entstehen.

Brauche ich eine große Testsuite, bevor ich sie nutze?

Nein. Die laravel-tdd-Skill ist auch in kleinen Projekten nützlich, weil sie dir hilft, für jede Änderung die richtige Teststufe zu wählen. Besonders hilfreich ist sie, wenn die ersten Tests ein Muster setzen sollen, dem das restliche Team folgen kann.

Worin unterscheidet sie sich von einem normalen Laravel-Prompt?

Ein normaler Prompt kann Code erzeugen, der einmal funktioniert, aber die Teststruktur ignoriert. Die laravel-tdd-Skill stellt den Test-first-Workflow, die Wahl der Testschicht und die Datenbankstrategie in den Mittelpunkt. Das macht sie besser für Testautomatisierung und wahrscheinlicher passend für ein reales Laravel-Projekt.

Wann sollte ich diese Skill überspringen?

Überspringe sie, wenn du kein Laravel-Verhalten testest, wenn du einen schnellen Prototypen ohne Testdisziplin brauchst oder wenn deine App ein striktes internes Testframework hat, das nicht zu den PHPUnit-/Pest-Annahmen der Skill passt.

So verbesserst du die laravel-tdd-Skill

Gib Verhalten vor, nicht nur Implementierungsziele

Die stärksten laravel-tdd-Ergebnisse entstehen durch Verhaltensspezifikationen. Statt „Baue ein Benachrichtigungssystem“ sag lieber: „Sende eine E-Mail-Benachrichtigung, wenn eine Rechnung überfällig wird, und verifiziere das mit einem Feature-Test.“ Damit gibst du der Skill ein testbares Ziel und reduzierst Rückfragen.

Benenne Grenze und Teststil von Anfang an

Sage dem Modell, was getestet werden soll und wie. Zum Beispiel:

• „Nutze einen Feature-Test für den HTTP-Endpunkt und einen Unit-Test für die Preislogik.“
• „Nutze RefreshDatabase, weil der Test Eloquent und Policies berührt.“
• „Nutze Pest, außer die bestehende Suite ist in PHPUnit.“

Diese Details helfen der laravel-tdd skill, falsche Standardannahmen zu vermeiden und Output zu erzeugen, der zu deinem Repo passt.

Achte auf zwei typische Fehlermuster

Die häufigsten Probleme sind zu viel Testen von Implementierungsdetails und die Wahl der falschen Testschicht. Wenn der erste Entwurf zu tief auf Technikdetails geht, bitte um eine Umformulierung mit Fokus auf Verhalten. Wenn das Test-Setup sich zu schwer anfühlt, bitte das Modell darum, Fixtures zu minimieren, Factories zu bevorzugen und das Datenbank-Setup nach Möglichkeit zu vereinfachen.

Iteriere mit einer Prüfung des fehlschlagenden Tests

Prüfe nach der ersten Ausgabe, ob der Test vor der Codeänderung wirklich aus dem richtigen Grund fehlschlagen würde. Wenn nicht, bitte um eine strengere Assertion, ein saubereres Fixture oder einen engeren Scope. Das ist der schnellste Weg, den Output der laravel-tdd-Skill für Testautomatisierung in echten Projekten zu verbessern.