Files

T

martinandClaude Opus 4.6 2e4ce422ab docs: Gitea-Konfiguration in globaler CLAUDE.md zentralisieren

Duplizierten Gitea-Integration-Abschnitt aus der Projekt-CLAUDE.md entfernt
und die globale CLAUDE.md als einzige Quelle der Wahrheit etabliert.
Korrigiert die falsche secret-tool-Referenz (Token wird per Datei gelesen).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-05-11 19:09:07 +02:00

3.9 KiB

Raw Blame History

Globale CLAUDE.md

Sprache

Alle Texte, Kommentare und Kommunikation auf Deutsch. Technische Begriffe und Code-Bezeichner bleiben im Original.

Entwicklungsprinzipien

Single Responsibility: Jede Datei, jede Funktion hat genau eine Aufgabe
Keine toten Code-Pfade: Unbenutzte Imports, Variablen, Funktionen sofort entfernen
Aussagekraeftige Namen: Sprechende Bezeichner statt handleClick, process
Keine Magic Numbers: Konstanten mit Namen versehen
DRY mit Augenmass: Shared Utilities nur bei echtem Mehrfachgebrauch
Fail Fast: Fehlende/ungueltige Konfiguration muss beim Start eine Exception werfen
Keine generischen try/except: Spezifische Exceptions fangen
Logging statt print: logger verwenden
Testpflicht: Kein Code ohne zugehoerigen Test
Security by Default: Input-Validierung, Auth-Checks, sichere Defaults. Sicherheitskritische Pfade durch Tests absichern
String-Eingaben trimmen: Alle String-Felder beim Anlegen/Update in Services/Schemas trimmen (leading/trailing Whitespace entfernen). Leerstrings werden zu None, wenn das Feld optional ist. Verhindert Sortier-/Vergleichs-/Suchfehler durch unsichtbare Zeichen
Kleine Funktionen, keine Kommentare fuer Offensichtliches

Code-Konventionen

Backend: Ruff, Type Hints, async, Pydantic-Schemas, Lifespan statt on_event
Frontend: <script setup>, ESLint+Prettier, Mobile First, defineEmits camelCase / Template kebab-case
DB: Jede Schema-Aenderung braucht eine Alembic-Migration
Architektur: api/ → services/ + models/, nie umgekehrt. HTTPException nur in api/. Eager-Loading in der API-Schicht. Frontend: Props down, Events up
Docker Compose: Jeder Service: TZ=Europe/Berlin, Logging 5 MB (json-file, max-size: 5m, max-file: 3), Watchtower-Label default deaktiviert

Agenten-Workflow

Nach jeder Story automatisch ausfuehren: test-runner → security-audit. Erst wenn beide ohne kritische Befunde durchlaufen, gilt die Story als abgeschlossen.

Pull Requests

PRs muessen jedes Akzeptanzkriterium einzeln als Checkbox auflisten und bestaetigen, wie es verifiziert wurde. Review-Feedback als separater Commit (nicht amenden).

Git-Workflow

Niemals direkt auf main committen. Alle Aenderungen ueber Feature-Branches und PRs.

Fehlende Tools

Wenn ein benötigtes CLI-Tool fehlt: nicht mit Workarounds (curl, rohe API-Calls) umgehen. Stattdessen:

User informieren welches Tool fehlt und den Installations-Befehl nennen
User führt den Befehl in einer separaten Konsole aus (sudo funktioniert dort)
Tool danach in bootstrap.sh aufnehmen, damit es auf allen Maschinen automatisch installiert wird

Gitea-Integration

Instanz: https://gitea.troeger-net.org
Bot-User claude-code, nur Collaborator-Rechte
Token: ~/.config/gitea/token (Datei mit chmod 600)
MCP-Server gitea muss aktiv sein (Binary: ~/go/bin/gitea-mcp, Wrapper: ~/.claude/gitea-mcp-wrapper.sh)

Wissen persistieren

Bei User-Korrekturen oder neuen Erkenntnissen zuerst klassifizieren, dann am richtigen Ort ablegen:

Art der Information	Ziel	Beispiel
Arbeitsregel für ein Repo	`CLAUDE.md` im Repo	"Keine Default-Werte in Configs"
Arbeitsregel für alle Repos	Globale `CLAUDE.md`	"Logging statt print"
Workaround für einen Bug	`WORKAROUNDS.md` im Repo, Verweis aus `CLAUDE.md`	"Log auf OFF wegen Bug X"
User-Profil, Rolle, Präferenzen	Memory (`user`-Typ)	"Bevorzugt knappe Antworten"
Projektstatus, Deadlines, Entscheidungen	Memory (`project`-Typ)	"Merge-Freeze ab 05.03."
Externe Referenzen	Memory (`reference`-Typ)	"Bugs in Linear INGEST"

Niemals Arbeitsregeln im Memory-System ablegen. Memory ist für Kontext, nicht für Regeln. Wenn eine User-Korrektur eine wiederkehrende Arbeitsregel beschreibt → CLAUDE.md. Immer.

MCP

Bei Frameworks/Bibliotheken immer Context-7-Dokumentation abrufen (resolve-library-id / query-docs).

3.9 KiB Raw Blame History