CLAUDE.md aktualisiert

This commit is contained in:
Admin committed 2026-10-30 11:28:12 +01:00
1 parent 4bfd761de1
commit 629186b6fb
1 file changed
+8 -50
+8 -50
View File
@@ -17,56 +17,14 @@ Du arbeitest immer in drei Phasen und überspringst keine:
# Git
## Vor der Umsetzung
- `git switch main && git pull`
- Eigenen Branch anlegen: `git switch -c feat/<kurzname>` (Fehler: `fix/<kurzname>`,
Pflege: `chore/<kurzname>`).
- Hast du versehentlich schon auf `main` Dateien geändert: nicht committen, sondern
`git switch -c feat/<kurzname>`; die Änderungen wandern mit.
## Committen und Pushen
- Du committest und pushst NICHT von dir aus. Ist eine Änderung fertig, zeigst du
`git status`, nennst die geänderten Dateien und schlägst eine Commit-Nachricht vor.
Erst wenn der Nutzer ausdrücklich „committen“ oder „pushen“ sagt, führst du es aus.
- Commits immer mit Nachricht im Befehl: `git commit -m "feat: ..."`.
Nie `git commit` ohne `-m`, sonst wartet Git auf einen Editor und hängt.
- Push nur mit `git push -u origin <branch>`. Niemals auf `main`, niemals force-push.
- Schlägt ein Push fehl (z. B. „Permission denied“, „protected branch“), änderst du
nichts an Remote-Adresse, SSH-Einstellungen oder Branch-Schutz. Du erklärst die
Meldung und überlässt die Lösung dem Nutzer.
- Pull Requests öffnet und mergt der Nutzer selbst in Gitea.
## Was nie ins Repo gehört
- `node_modules/`, `.next/`, `.env`, `.env.local` und andere `.env.*` (außer
`.env.local.example`), Datenbankdateien unter `data/`.
- Prüfe vor jedem Commit mit `git status`, dass keine dieser Dateien dabei ist.
Taucht eine auf, ergänzt du `.gitignore` und entfernst sie mit
`git rm -r --cached <pfad>` aus Git, nicht von der Festplatte.
- Keine Passwörter, Tokens oder Secrets im Code. Werte gehören in `.env.local`,
neue Variablennamen zusätzlich als Platzhalter in `.env.local.example`.
# Entwicklung
- Die App läuft IMMER auf Port 3000 (`npm run dev`). Ist der Port belegt, wechselst
du nicht auf einen anderen Port, sondern beendest den alten Prozess
(`npx kill-port 3000`) und startest neu.
- UI ausschließlich mit shadcn/ui-Komponenten aus `components/ui`. Fehlt eine:
`npx shadcn@latest add <name>` im App-Ordner.
- Pakete nur mit `npm install <paket>` bzw. `npm uninstall <paket>` ändern, nie von
Hand in der package.json. `package.json` und `package-lock.json` immer gemeinsam
committen, sonst scheitert der Build beim Deployment.
- Für die Hilfsfunktion `cn` nutzt shadcn die Pakete `clsx` und `tailwind-merge`,
nicht ein Paket namens `cn`.
- Bevor du eine Änderung als fertig meldest, muss `npm run build` ohne Fehler
durchlaufen. Genau dieser Build läuft später beim Deployment.
# Nicht anfassen
Diese Dateien ändern das Deployment oder die Schutzregeln. Du änderst sie nur,
wenn der Nutzer es ausdrücklich verlangt, und weist dann auf die Folgen hin:
- `Dockerfile`, `.dockerignore`
- `output: "standalone"` in `next.config.mjs`, Port 3000 in `package.json`
- `.devcontainer/`, `.claude/`, `.gitea/`
- Du änderst nur Dateien. Git-Befehle, die etwas verändern (add, commit, push,
switch, checkout, branch, merge, rebase, reset, stash), führst du nie aus.
- Erlaubt sind nur Befehle zum Nachsehen: `git status`, `git diff`, `git log`.
- Ist eine Änderung fertig und `npm run build` läuft ohne Fehler, sagst du dem
Nutzer: „Fertig. Du kannst jetzt in VS Code links unter Quellcodeverwaltung eine
Nachricht eintragen und auf Commit drücken.“ Schlage dazu eine kurze
Commit-Nachricht vor.
- Gemergt wird ausschließlich in Gitea durch den Owner.
# Deployment