swiss-culture-mcp: Instructions file for Claude Code

CLAUDE.md

Vor der Arbeit

Klon-Aktualität prüfen — Standard-Branch ermitteln, nicht main annehmen:

B=$(git ls-remote --symref origin HEAD | sed -n 's|^ref: refs/heads/\([^[:space:]]*\).*|\1|p')
git fetch origin "${B:?Standard-Branch nicht ermittelbar}" &&
  git rev-list --count HEAD..FETCH_HEAD

Drei Server im Portfolio heissen ihren Standard-Branch master (openlex-mcp, swiss-courts-mcp, swisstopo-mcp); dort scheitert ein fest verdrahtetes origin/main mit «couldn't find remote ref main». Wer das für ein Netzproblem hält, arbeitet weiter auf genau dem veralteten Klon, vor dem dieser Absatz warnt. Den :?-Schutz nicht weglassen: Bei leerem B fetcht git still den Remote-HEAD und endet mit 0.

Ein veralteter Klon erzeugt eine rote CI, deren Ursache nicht im Diff steht. Am 3.8.2026 zweimal passiert — beide Male fehlten genau die Commits, die das Gate einführten, an dem der Branch scheiterte.

Seit .claude/settings.json läuft diese Prüfung als SessionStart-Hook (.claude/hooks/session-start.sh) und meldet den Rückstand von selbst. Sie blockiert nie und schweigt bei 0 — bleibt oben also von Hand zu fahren, wenn der Hook nicht greift (fremder Klon, kein Netz beim Start). Begründung und Zusicherungen: .claude/hooks/README.md.

Gates lokal fahren, mit der GEPINNTEN ruff-Version aus der CI. Eine andere Version meldet Abweichungen, die niemand verursacht hat.

Tests

Gegenprobe ist Pflicht. Ein Test, der grün bleibt, wenn man die Implementierung entfernt, prüft nichts. Jede neue Zusicherung einzeln neutralisieren und zeigen, dass genau die zugehörigen Tests fallen. Zwei Fallen, die beide grün blieben:

• Eine Fake-Uhr, die nur beim Schlafen vorrückt, kann eine Zusicherung über echte Zeit nicht widerlegen.
• monkeypatch.setattr(modul.asyncio, "sleep", ...) greift ins Modul asyncio selbst und entschärft die Mechanik im ganzen Prozess. Patche einen Modul-Alias (_sleep = asyncio.sleep), nicht das fremde Modul.
• Den Bytecode-Cache leeren, sonst prüft die Gegenprobe den alten Stand. Am 19.9.2026 überlebte eine Mutation im Klassifizierer alle Tests. Der Test war in Ordnung; die Mutation war nie angekommen. Python hält eine .pyc für gültig, wenn Grösse und mtime der Quelldatei passen — und RUNNING durch PENDING zu ersetzen ändert die Grösse nicht (beide sieben Zeichen), während das cp zum Zurücksetzen unmittelbar davor die mtime in dieselbe Sekunde legte. Beide Prüfgrössen gleich, alter Bytecode, grüner Lauf.