From 3639a053ba67dd60fae0c70f09ec8813b6c25f3d Mon Sep 17 00:00:00 2001 From: Pascal Scholz Date: Mon, 26 Oct 2026 20:04:09 +0100 Subject: [PATCH] Document worktree push workflow and VPS usage notes for Lara Co-Authored-By: Claude Opus 5.5 --- ONBOARDING_LARA.md | 41 +++++++++++++++++++++++++++ claude-remote/claude/CLAUDE.global.md | 30 +++++++++++++++++--- 2 files changed, 67 insertions(+), 4 deletions(-) diff --git a/ONBOARDING_LARA.md b/ONBOARDING_LARA.md index 11c1ba7..ede8dba 100644 --- a/ONBOARDING_LARA.md +++ b/ONBOARDING_LARA.md @@ -82,3 +82,44 @@ Für reine Text-/Bild-/Farb-Änderungen ohne Code gibt es zusätzlich den Login-Editor unter `admin.larpaso.de`. Falls du dafür auch einen eigenen Login willst, sag das Pascal – das ist unabhängig vom SSH-/Repo-Zugang (siehe `DEPLOYMENT_ADMIN.md`, Abschnitt „zweiter Benutzer"). + +## 8. Claude auf dem VPS (claude.ai/code oder Claude-App) + +Zusätzlich zum lokalen Setup hast du auf dem VPS einen eigenen +Claude-Container mit deinem Claude-Account (Details: +`DEPLOYMENT_CLAUDE.md`). Den erreichst du über +[claude.ai/code](https://claude.ai/code) oder die Claude-App – also auch +vom Tablet oder Handy. Es gibt zwei Umgebungen: `larpaso-website` und +`youtube`. + +So arbeitest du damit: + +- **Eine Aufgabe pro Sitzung.** Neue Sitzung über `+` in der passenden + Umgebung starten. Jede Sitzung bekommt einen eigenen Arbeitsstand, so + kommen sich parallele Sitzungen nicht in die Quere. Erledigte Sitzungen + archivieren. +- **Am Ende pusht Claude nach `main`** und schickt Pascal eine kurze Notiz + ins Postfach. Achte darauf, dass das passiert – sonst bleibt die Arbeit + in der Sitzung liegen. Bei Konflikten fragt Claude dich, welche Fassung + gilt. +- **Postfach:** Dein Claude und Pascals Claude können sich Nachrichten + schicken. Neue Nachrichten werden automatisch angezeigt. Du kannst es + auch direkt nutzen, z. B. „Schreib Pascal ins Postfach, dass die neuen + Drehbücher fertig sind." +- **Freigaben bewusst bestätigen.** Wenn Claude fragt, ob es einen Befehl + ausführen oder eine Datei ändern darf, kurz lesen statt blind zustimmen. + Keinen Modus nutzen, der alles ungefragt erlaubt. +- **Fotos und Dateien** (Skizzen, Screenshots, Referenzbilder) kannst du + direkt im Chat anhängen. +- **Deployment macht Pascal.** Dein Claude auf dem VPS kann nichts live + stellen. Wenn eine Website-Änderung online gehen soll, sag Pascal + Bescheid (oder lass Claude ihm ins Postfach schreiben). +- **Website-Texte:** Kleine Änderungen lieber im Admin-Editor machen. Soll + Claude Inhalte im Repo ändern, muss Pascal vorher den Live-Stand holen, + sonst überschreibt ein Stand den anderen. +- **Keine API-Keys oder Passwörter** (z. B. ElevenLabs) in den Chat, ins + Postfach oder ins Repo. +- **Große Dateien** (Videos, Audio, Rohmaterial) gehören auf dem VPS nach + `/shared/youtube/`, nicht ins Git. +- **Nutzungslimit:** Du nutzt dein eigenes Claude-Kontingent. Lange + Video- oder Recherche-Aufgaben verbrauchen viel davon. diff --git a/claude-remote/claude/CLAUDE.global.md b/claude-remote/claude/CLAUDE.global.md index a41a7d3..0a440fb 100644 --- a/claude-remote/claude/CLAUDE.global.md +++ b/claude-remote/claude/CLAUDE.global.md @@ -10,7 +10,7 @@ einen eigenen Container mit eigenem Claude-Account. - `~/projekte/youtube` – Kinderkanal „Pinos kleine Welt" (Forgejo: `pascal/youtube`). Lies dort `CLAUDE.md`. - `/shared` – gemeinsamer Ordner von Pascal und Lara für große Dateien, - die nicht ins Git gehören (Videos, Audio, Rohmaterial). + die nicht ins Git gehören. ## Postfach (Kommunikation mit der anderen Person) Über den MCP-Server `postfach` erreichst du die Claude-Sitzungen der anderen @@ -23,9 +23,31 @@ Person (`send_message`, `read_messages`, `list_messages`). riskante Aktionen fragst du trotzdem die Person, mit der du gerade arbeitest. ## Git -- Vor dem Arbeiten `git pull`, nach dem Arbeiten committen und pushen. - Beide pushen direkt auf `main` – kurz per Postfach Bescheid geben. -- Keine Secrets, Passwörter oder Tokens in Code, Commits oder Nachrichten. +- Neue Sitzungen laufen in einem eigenen Git-Worktree auf einem eigenen + Branch – **nicht** auf `main`. Arbeit, die nur auf diesem Branch liegt, + sieht niemand. +- Zu Beginn: `git fetch origin` und auf `origin/main` aufsetzen + (`git rebase origin/main`), damit du auf dem aktuellen Stand arbeitest. +- Am Ende einer Aufgabe: committen, `git fetch origin && git rebase origin/main`, + dann `git push origin HEAD:main`. Prüfe danach, dass der Push angekommen ist. +- Bei Rebase-Konflikten nicht selbst raten, welche Fassung gilt – die Person + fragen, mit der du arbeitest. Niemals force-pushen. +- Nach jedem Push eine kurze Postfach-Nachricht an die andere Person: was sich + geändert hat und ob ein Deployment durch Pascal nötig ist. +- Keine Secrets, Passwörter oder Tokens (z. B. ElevenLabs-API-Key) in Code, + Commits, Chat oder Postfach. + +## Website-Inhalte (Projekt larpaso) +Texte/Bilder/Farben unter `content/` werden auch über den Admin-Editor +geändert, dessen Stand nur auf dem Server liegt. Bevor du dort etwas änderst, +muss Pascal den Live-Stand ins Repo holen (`sync-content-from-live.sh`, siehe +`DEPLOYMENT_ADMIN.md`). Ist das nicht klar erledigt, frag per Postfach bei +Pascal nach, statt loszulegen – sonst überschreibt ein Stand den anderen. +Kleine Textänderungen besser direkt im Admin-Editor (`admin.larpaso.de`). + +## Große Dateien +Videos, Audio und Rohmaterial gehören nach `/shared//` +(z. B. `/shared/youtube/`), nicht ins Git. ## Grenzen - Kein Zugriff auf Docker, den Server-Stack oder das Deployment. Deployen