KFZ-Bozo Handbuch

Betrieb & Dokumentation › Hausregeln-Abschnitt in CLAUDE.md

Hausregeln-Abschnitt in CLAUDE.md

DokumentLiveQuelle geändert seit Prüfung

Neun feste Arbeitsregeln für dieses Projekt, jede mit einem konkreten Vorfall dahinter, der sie ausgelöst hat — vom 'Kennzeichen ist kein Schlüssel' bis zum exakten Testkommando. Sie sind der wichtigste einzelne Einstiegspunkt für jeden neuen Bearbeiter.

Chef

Bild folgt

Neun nummerierte Arbeitsregeln bündeln, was frühere Vorfälle im Projekt teuer gelehrt haben — jede mit einem kurzen Grund, warum sie gilt. Sie reichen von der Regel, dass ein Kennzeichen nie allein ein Fahrzeug identifizieren darf, über den Umgang mit archivierten Aufträgen und Datenbank-Änderungen bis zum genauen Ablauf eines Server-Deploys und dem exakt vorgeschriebenen Testbefehl. Sie stehen an einer einzigen, gut sichtbaren Stelle im Projekt, damit jede neue Person — ob Mensch oder KI-Assistent — sie vor der ersten Änderung liest.

Schützt

EnthältRegeltGeregelt dur…Geregelt dur…SchütztHausregeln…Projekt-Briefe…Hetzner-Migrat…Vault-Sichtbar…TestlaufKunden & Fahrz…
  • CLAUDE.md
stand2026-08-02, seither nicht als veraendert belegt
wiederverwendbarja — soll 1:1 als eigene Wiki-Seite 'Hausregeln' erscheinen, das ist genau der Lesertyp (Chef + neuer Entwickler)
dublettenkeine — einzige Quelle
zielgruppeEntwickler, Chef
regel-1Kennzeichen ist kein Schluessel (945 KZ-Mitnahme-Paare in Prod)
regel-2Vault fuer KI unsichtbar (vaulted_at IS NULL ueberall filtern)
regel-3neue Tabellen nur ueber ALTERS-Sektion, nie ins MIGRATIONS-Array
regel-4Dateipfade ueber DATA_DIR, nie process.cwd()
regel-5Deploy-Pattern (siehe ops-deploy)
regel-6nach Server-Deploy origin/main mitpushen
regel-7beim Haerten eines Gates ALLE Leser der Ressource auflisten
regel-8eine Behauptung im Commit ist zu belegen, nicht zu erklaeren
regel-9Testlauf-Flag (siehe ops-tests)

Beleg: CLAUDE.md Abschnitt 'Hausregeln dieses Projekts (VOR dem ersten Edit lesen)', neun nummerierte Regeln mit Datum 2026-08-02

Betrieb & DokumentationSeite bearbeiten: wiki/seiten/betrieb-doku/ops-hausregeln.md