claude-code/vorlagen/CLAUDE.md.team.md

CLAUDE.md (Team)

This file provides guidance to Claude Code when working in this repository.

Architecture (big picture)

• src/ – Anwendungscode
• tests/ – Unit- und Integrationstests
• scripts/ – Build/CI-Helfer, keine Business-Logik

API-Handler liegen in src/api/; Business-Logik nicht in Routen-Dateien mischen.

Build, Test, Lint

npm ci
npm run lint
npm test
npm run test:unit -- path/to/file.test.ts   # einzelner Testfile
npm run build

CI muss grün sein, bevor ein PR gemerged wird. Lokal mindestens Lint + betroffene Tests.

Code conventions

• TypeScript strict; type statt interface, wenn das Repo das so macht
• 2 Spaces, trailing commas in multi-line Literals
• Fehler: typed Errors, keine stillen catch {}
• Logging über das bestehende logger-Modul, nicht console.log in Prod-Pfaden

Git & PR

• Branch: feature/…, fix/…, chore/… von main
• Conventional Commits
• PR: kurze Beschreibung + Testplan; Screenshots nur bei UI
• Kein Force-Push auf main

Security

• Secrets nur über Env / Secret Manager
• Nie .env, Schlüsseldateien oder Produktions-Credentials lesen oder committen
• Outbound-Netzwerk (curl zu unbekannten Hosts) nur nach Freigabe

Agent-Verhalten

• Bei unklaren Anforderungen: nachfragen statt raten
• Plan vor großen Änderungen (/plan), dann umsetzen
• Nach Code-Änderungen: Lint + betroffene Tests laufen lassen