AGENT-TASK: [FEATURE-BEZEICHNUNG, z. B. „Benutzeranmeldung mit E-Mail und Magic Link"]
ZIEL
Baue das oben genannte Feature vollständig, vom Backend-Endpoint bis zur funktionierenden UI, in unserem bestehenden Projekt.
KONTEXT
- Framework / Tech-Stack: [z. B. „Next.js 14, TypeScript, Supabase als Backend, Tailwind CSS für Styling"]
- Datenbankschema: [z. B. „users-Tabelle existiert mit id, email, created_at, bitte kein Schema ändern, nur Lese-/Schreibzugriff über bestehende Supabase-Client-Instanz"]
- Bestehende Auth-Logik: [z. B. „Kein eigenes Auth-System vorhanden. Nutze Supabase Auth mit signInWithOtp()."]
- Stil-Vorgaben: [z. B. „Tailwind-Klassen, bestehende Komponenten in /components/ui/ bevorzugen, keine neuen UI-Libraries installieren"]
AUFGABE (schrittweise)
1. Erstelle zunächst einen Implementierungsplan als Artifact (Task-Liste mit allen Schritten, bevor du Code schreibst).
2. Lege die benötigten Dateien an: [z. B. „API-Route unter /app/api/auth/magic-link/route.ts, Login-Seite unter /app/login/page.tsx, Callback-Handler unter /app/auth/callback/route.ts"].
3. Implementiere die Logik Schritt für Schritt gemäß Plan. Kommentiere kritische Abschnitte kurz auf Deutsch.
4. Starte die App im Terminal und prüfe im integrierten Browser, dass [z. B. „das Login-Formular angezeigt wird, ein Test-Link per Supabase verschickt wird und der Callback-Handler die Session korrekt setzt"].
5. Erstelle einen Screenshot des funktionierenden Flows als Artifact.
6. Schreibe Unit-Tests für die kritischen Funktionen (Endpoint-Validierung, Fehlerbehandlung bei ungültigem Token).
EINSCHRÄNKUNGEN
- Ändere keine bestehenden Dateien außerhalb des Features ohne explizite Rückfrage.
- Installiere keine neuen npm-Packages, ohne vorher eine kurze Begründung im Artifact zu hinterlassen.
- Falls du auf undokumentierten Code stößt, den du nicht sicher interpretieren kannst, halte an und beschreibe das Problem kurz, arbeite nicht mit Annahmen weiter.
TRUST LEVEL
[Wähle einen der Modi in den Agent-Einstellungen: „Agent-Assisted" empfohlen für produktionsnahe Projekte, so hält der Agent bei kritischen Entscheidungen an und zeigt dir die Optionen.]
ERWARTETES ERGEBNIS
- Funktionierendes Feature im Browser verifiziert (Screenshot-Artifact vorhanden).
- Code ist getestet (Unit-Tests grün).
- Task-Liste vollständig abgehakt.
- Kein bestehender Test-Suite-Bruch.