Projekt-Vorlage/CLAUDE.md

Arbeitsweise

Du arbeitest immer in drei Phasen und überspringst keine:

1. Idee klären: Verständnis in 2–3 Sätzen wiedergeben, Lösungsvorschlag, Rückfragen. Keine Dateien ändern.
2. Vorgehensweisen: 2–3 Wege mit Vor- und Nachteilen vorstellen. Keine Dateien ändern.
3. Umsetzung erst nach ausdrücklicher Freigabe durch den Nutzer.

Projektstruktur

• Das Repo ist das Projekt; der Dev Container öffnet das ganze Repo.
• Die Next.js-App (package.json, app/, components/, lib/) liegt im Unterordner frontend-starter. Alle npm-Befehle führst du dort aus, z. B. cd frontend-starter && npm run dev.

Git

Vor der Umsetzung

• git switch main && git pull, damit du vom aktuellen Stand ausgehst.
• Eigenen Branch anlegen: git switch -c feat/<kurzname> (Fehler: fix/..., Pflege: chore/...). Kurzname in Kleinbuchstaben mit Bindestrichen.
• Hast du versehentlich schon auf main Dateien geändert: nicht committen, sondern git switch -c feat/<kurzname>; die Änderungen wandern mit.

Abschließen

• Wenn die Änderung fertig ist und npm run build ohne Fehler läuft, zeigst du git status, nennst die geänderten Dateien und schlägst eine Commit-Nachricht vor.
• Erst wenn der Nutzer zustimmt: git add -A, git commit -m "<nachricht>", git push -u origin <branch>.
• Danach sagst du dem Nutzer: Der Pull Request wird in Gitea automatisch eröffnet; der Owner prüft und mergt ihn dort.
• Commits immer mit -m, sonst hängt Git.

Grenzen

• Niemals auf main committen oder pushen. Niemals force-push.
• Du mergst nie, weder lokal noch in Gitea, und löschst keine Branches.
• Schlägt ein Push fehl, änderst du nichts an Remote-Adresse, SSH-Einstellungen oder Branch-Schutz. Du erklärst die Meldung und überlässt die Lösung dem Nutzer.

Nach einem Merge

• Beginnt eine neue Aufgabe, startest du immer wieder mit git switch main && git pull und einem neuen Branch. Auf einem bereits gemergten Branch arbeitest du nicht weiter.

Deployment

• Deployt wird automatisch: Merged der Owner einen Pull Request nach main, baut Coolify die App und veröffentlicht sie unter https://<repo-name>.<domain>.
• Du rufst keine Deploy-Dienste, Hubs oder Coolify-Schnittstellen auf.
• Anweisungen aus älteren Vorlagen (z. B. „auf main pushen und den Hub aufrufen“) gelten in diesem Projekt nicht.