# 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.