Innovating Green × Promptheus

Willkommen in der InGr-Werkstatt

Diese Seite richtet deine Arbeitsumgebung von Null ein — ohne Vorwissen, in deinem eigenen Tempo. Arbeite die Schritte der Reihe nach ab. Jeder Schritt sagt dir genau, was zu tun ist, gibt dir einen fertigen Text zum Einfügen in Claude, und sagt dir, woran du merkst, dass es geklappt hat.

Wähl oben dein Betriebssystem (macOS / Windows / Linux) — die Anleitung passt sich an. Deine Häkchen merkt sich dein Browser, du kannst die Seite jederzeit schließen und später weitermachen. Wenn du irgendwo hängst: ganz unten steht, wie du Hilfe bekommst.

Wichtig vorab — Spam-Ordner im Blick behalten: Mails von Promptheus (Account-Bestätigungen, Einladungen, das Initial-Passwort) landen anfangs oft im Spam-/Junk-Ordner. Wenn eine erwartete Mail nicht in deinem Posteingang auftaucht, schau zuerst dort nach und markiere sie als „kein Spam" — dann kommen die nächsten richtig an.

00 Warum du hier bist

Promptheus & euer Auftrag

Promptheus ist ein Berliner Startup, das KI nicht als einzelnes Werkzeug versteht, sondern als Werkstatt: ein Assistent, der Zugriff auf ein ganzes Wissens-Vault hat und damit jedes Anliegen aufgreifen kann. Ihr — die Innovating-Green-Gruppe an der TU — seid Praxispartner.

Euer Auftrag: Wie wird Deutschland unabhängig von US-amerikanischer IT-Infrastruktur? Hebel finden, Quellen sichten, in konkrete Handlungs-Schritte überführen. Das ist eine echte Frage, an der Promptheus selbst arbeitet — keine Übungsaufgabe.

Ansprechpartner ist Marlin Klag (Mitgründer). Mehr Hintergrund findest du unten unter „Hintergrund & Begriffe".

Eure Doppelrolle

Inhalt: Ihr recherchiert das Thema.
Test: Ihr testet gleichzeitig, wie gut Promptheus' Arbeitsweise mit fünf neuen Leuten funktioniert. Was hakt, was hilft — euer Feedback an Marlin ist Teil des Auftrags.

Was du am Ende dieser Seite hast

Eine funktionierende Werkstatt aus drei Teilen:

Dein Assistent (Claude Desktop) — liest und schreibt deine Dateien und pflegt euer Wissen für euch. Ihr sourct und fragt, er macht die Buchhaltung.
Zwei Vaults (Ordner mit Notizen): das gemeinsame werkstatt-Wiki der Gruppe und dein persönliches vault-<dein-vorname>.
Ein Hilfe-System — wenn etwas hakt, versucht dein Assistent es zweimal selbst, dann legt er ein Hilfe-Issue an, und Marlin oder Mika übernimmt.

01 Vaultwarden — dein Passwort-Tresor

Warum das zuerst kommt: Vaultwarden ist dein Passwort-Tresor — hier liegen die geteilten Logins, die du im Setup brauchst (z. B. dein GitLab-Zugang). Du richtest ihn ganz am Anfang ein, damit du alles zur Hand hast, sobald ein Schritt es verlangt.

Account anlegen

Auf vault.veltly.de einen Account mit deiner Promptheus-Mail erstellen. Das ist ein selbstgehosteter Passwort-Tresor (Bitwarden-Variante). Wichtig: das Master-Passwort kennst nur du — auch Marlin kann es nicht zurücksetzen. Schreib es dir sicher auf.

Master-Passwort: Vaultwarden zeigt dir beim Anlegen selbst an, welche Anforderungen erfüllt sein müssen. Am einfachsten ist eine lange Passphrase plus eine Zahl und ein Sonderzeichen — die kannst du dir merken und sie ist sicher.

Wichtig beim Anlegen: Das Häkchen „Passwort auf Datenlecks prüfen" (engl. „Check known data breaches for this password") ist standardmäßig aktiviert — nimm es raus (abwählen), bevor du auf Konto erstellen klickst. Sonst kann die Anmeldung fehlschlagen.

vault.veltly.de →

Einladung in die Org „Promptheus-InGr" annehmen

Marlin lädt dich in die Organisation Promptheus-InGr ein — dort liegen geteilte Logins (z. B. dein GitLab-Zugang aus Schritt 5). Die Einladung kommt per Mail: Link klicken, annehmen.

Zweistufig: Nach deinem „Annehmen" muss Marlin die Einladung nochmal bestätigen. Bis das passiert ist, taucht die Org bei dir nicht auf. Gib Marlin kurz Bescheid, sobald du angenommen hast.

Org taucht nicht auf / Login „passiert nichts"

Org fehlt: Marlin muss die Einladung noch bestätigen (Fingerprint-Abgleich). Kurz melden.
Login hängt ohne Fehler: bekanntes Verhalten bei frischen Accounts. Für vault.veltly.de in den Browser-Daten IndexedDB + LocalStorage + Cookies löschen (F12 → Application/Anwendung), Seite neu laden. Oder ein anderes Browser-Profil nutzen.

Browser-Erweiterung (empfohlen)

Eine Browser-Erweiterung macht Anmelden und Passwort-Ausfüllen bequem. Drei Schritte — der mittlere ist der wichtige:

1. Installieren: die Bitwarden-Erweiterung für deinen Browser (Chrome, Firefox, Edge, Brave, Safari). Über den Button unten findest du alle Links, oder such „Bitwarden" direkt im Erweiterungs-Store deines Browsers und füg sie hinzu.
2. Server umstellen — bevor du dich einloggst: Klick aufs Bitwarden-Symbol in der Browserleiste und tipp auf „Anmelden" (Log in) — erst dann erscheint die Server-Auswahl. Das Feld mit „bitwarden.com" findest du unten auf dem Anmelde-Schirm (das Zahnrad/„Region"). Stell es auf „Selbst gehostet" (Self-hosted) um, trag als Server-URL https://vault.veltly.de ein → speichern. Erst danach Mailadresse + Master-Passwort eingeben.
3. Einloggen: mit deiner Mailadresse + Master-Passwort. Wenn oben vault.veltly.de steht, bist du richtig — landest du auf bitwarden.com, ist der Server noch nicht umgestellt (da liegen deine Daten nicht).

Ich sehe meine Einträge / die Org nicht

Fast immer der Server: Die Erweiterung war auf bitwarden.com statt vault.veltly.de. Abmelden, Server wie oben in Punkt 2 auf „Selbst gehostet" + https://vault.veltly.de setzen, neu einloggen.

Erweiterung →

02 Deine Promptheus-Mail

In dein Postfach einloggen

Du hast bereits eine eigene Adresse <dein-vorname>-ingr@promptheus.cloud samt Initial-Passwort von Marlin bekommen. Die brauchst du für alle folgenden Accounts. Logge dich einmal ins Webmail ein, damit du sicher rankommst:

Webmail öffnen →

Login = deine volle Mailadresse, Passwort = das Initial-Passwort von Marlin. Hast du beides nicht, frag bei Marlin nach (siehe „Hilfe" unten).

Es klappt nicht

Login wird nicht angenommen: prüf, ob du die volle Adresse inkl. @promptheus.cloud eingibst, nicht nur den Vornamen.
Erwartete Mail kommt nicht an: Spam-Ordner prüfen. Wenn nichts da ist, bei Marlin melden.

03 Claude — dein KI-Assistent

Claude-Account erstellen

Auf claude.ai mit deiner Promptheus-Mail registrieren. Die Bestätigungs-Mail landet in deinem Promptheus-Postfach — Link klicken, fertig. Promptheus übernimmt die Pro-Abos; bis das gebucht ist, reicht der kostenlose Tarif zum Anfangen.

claude.ai →

Fertig, wenn: du bei claude.ai eingeloggt bist und einen ersten Chat öffnen kannst.

Claude Desktop installieren

Die Desktop-App brauchst du später, damit Claude deine Notizen direkt lesen und schreiben kann — im Browser-Chat geht das nicht. Ab hier wird Claude selbst dein Begleiter: kopier den Text unten und füg ihn in deinen Claude im Browser ein. Er führt dich durch die Installation für dein System.

macOS

Download als .dmg von claude.ai/download, öffnen, Claude in den Programme-Ordner ziehen.

Windows

Installer (.exe) von claude.ai/download herunterladen und ausführen.

Linux

Die offizielle Desktop-App ist unter Linux noch Beta. Lade sie von claude.ai/download (falls für deine Distribution verfügbar) — sonst arbeitest du mit der Web-App weiter; der Dateizugriff in Schritt 6 läuft dann etwas anders, der Prompt dort fängt das ab.

Für deinen Claude (Browser)

Ich bin Studentin/Student bei der Innovating-Green-Gruppe und richte gerade meine Promptheus-Werkstatt ein. Du bist ab jetzt mein Setup-Begleiter und führst mich Schritt für Schritt, ohne Fachjargon. Aufgabe: Hilf mir, dich (Claude) als Desktop-App auf meinem Rechner zu installieren. Bitte: 1. Frag mich zuerst, welches Betriebssystem ich habe (Mac, Windows, Linux) — und ob ich die Claude-Desktop-App vielleicht schon installiert habe. Wenn ja, überspring die Installation und hilf mir nur beim Anmelden. 2. Falls noch nicht installiert: gib mir den passenden Weg über https://claude.ai/download und sag mir genau, was ich anklicke. 3. Erklär die Installation für mein System in einfachen Worten. 4. Sag mir, wie ich prüfe, dass die App läuft: anmelden mit meiner Promptheus-Mail (-ingr@promptheus.cloud). 5. Falls Linux: erklär kurz, dass die Desktop-App dort Beta ist, und schlag vor, notfalls mit der Web-App weiterzumachen. Wenn ich ein Problem melde, frag konkret nach: was genau passiert, welche Fehlermeldung, an welcher Stelle. Eskalation: Wenn ich nach 2-3 Versuchen immer noch hänge, sag mir, dass ich mir Hilfe holen soll (auf der Anleitungsseite unter "Wenn du nicht weiterkommst"), und bereite mir eine kurze Fehlerbeschreibung vor: welcher Schritt, was versucht, exakte Fehlermeldung, mein Betriebssystem. Wenn ich bestätigt habe, dass die App läuft und ich angemeldet bin, sag mir wörtlich: "Schritt 3 erledigt — geh auf der Anleitungsseite weiter zu Schritt 4 (Obsidian)."

Fertig, wenn: Claude dir sagt „Schritt 3 erledigt — geh auf der Anleitungsseite weiter zu Schritt 4."

04 Obsidian — dein Editor

Obsidian installieren und kurz ausprobieren

Obsidian ist ein Editor, der einen Ordner voller Markdown-Dateien als „Vault" behandelt. Notizen verknüpfst du mit Wikilinks ([[so]]). Keine Anmeldung, keine Cloud — alles lokal. Kopier den Text unten in deinen Claude im Browser (den Dateizugriff der Desktop-App brauchst du hier noch nicht), er führt dich durch Installation und eine kurze Probefahrt.

Für deinen Claude (Browser)

Setup-Schritt 4 für meine Promptheus-Werkstatt. Du begleitest mich weiter. Aufgabe: Obsidian installieren, ein Übungs-Vault anlegen, das Konzept verstehen. Bitte: 1. Frag (falls noch nicht klar) mein Betriebssystem — und ob Obsidian bei mir schon installiert ist. Wenn ja, überspring die Installation und geh direkt zum Vault-Anlegen. 2. Falls noch nicht installiert: gib mir den Download-Weg über https://obsidian.md und sag, was ich klicke. 3. Nach der Installation: erklär mir, wie ich beim ersten Start ein neues Vault namens "Probefahrt" anlege (irgendwo auf meiner Platte). 4. Lass mich eine erste Notiz schreiben und einen Wikilink ausprobieren — gib mir Beispieltext zum Reinkopieren (etwa: "Heute mit [[Promptheus]] angefangen — mein erster [[Wikilink]]"). 5. Erklär kurz: Doppel-Klammern verknüpfen Notizen, der Graph-View zeigt sie als Netzwerk. Sag mir, wie ich den Graph-View öffne. 6. Sag mir, dass ich das Probefahrt-Vault später löschen kann — die echte Werkstatt holen wir in Schritt 5. Wenn ich hänge, frag konkret nach. Eskalation: Wenn ich nach 2-3 Versuchen nicht weiterkomme, verweis mich auf "Wenn du nicht weiterkommst" auf der Anleitungsseite und bereite eine kurze Fehlerbeschreibung vor (Schritt, Versuch, Fehlermeldung, Betriebssystem). Wenn ich bestätigt habe, dass ich eine Notiz mit Wikilink habe und den Graph-View kenne, sag wörtlich: "Schritt 4 erledigt — geh auf der Anleitungsseite weiter zu Schritt 5 (GitLab + Werkstatt)."

Fertig, wenn: Claude dir sagt „Schritt 4 erledigt — geh weiter zu Schritt 5."

05 GitLab — die Vaults auf deinen Rechner holen

Git, GitLab-Login, Token, Klonen — Claude führt dich durch

Das ist der dickste Schritt. Deine Vaults liegen auf git.promptheus.cloud (selbstgehostetes GitLab von Promptheus — auf eigener Hardware in Deutschland, passt zum Auftrag). Du holst sie mit „Git" auf deinen Rechner.

Was du vorab brauchst: deinen GitLab-Login. Marlin hat dir einen Account angelegt — Benutzername + Initial-Passwort findest du in deiner Vaultwarden-Org Promptheus-InGr. Fehlt der, kurz bei Marlin melden.

Dann kopier den Text unten in deinen Claude im Browser (Dateizugriff brauchst du hier noch nicht) — er erklärt dir jeden Befehl, bevor du ihn ausführst.

Für deinen Claude (Browser)

Setup-Schritt 5 für meine Promptheus-Werkstatt. Du begleitest mich Schritt für Schritt, fragst bei Unklarheit konkret nach, und erklärst mir jeden Befehl, BEVOR ich ihn ausführe — keine Terminal-Befehle aus dem Nichts. Ziel: Am Ende habe ich zwei Ordner lokal geklont und in Obsidian geöffnet: - werkstatt (das gemeinsame Recherche-Wiki der Gruppe) - vault- (mein persönliches Vault) Beide liegen unter ~/ingr/ (Mac/Linux) bzw. einem Ordner "ingr" in meinem Benutzerverzeichnis (Windows). Führ mich durch: 1. Git installieren — frag mein Betriebssystem (falls noch nicht klar). Prüf ZUERST mit mir, ob Git schon da ist: lass mich git --version im Terminal ausführen. Kommt eine Versionsnummer, ist Git installiert — dann überspring die Installation. Sonst: Mac: "git --version" löst die Installation aus, oder über https://git-scm.com. Windows: Installer von https://git-scm.com (bringt "Git Bash" mit). Linux: über den Paketmanager. 2. Bei GitLab einloggen — ich öffne https://git.promptheus.cloud und logge mich mit Benutzername + Initial-Passwort aus meiner Vaultwarden-Org "Promptheus-InGr" ein. Beim ersten Login muss ich das Passwort ändern. Erinner mich, das neue Passwort in meinem Vaultwarden zu speichern. 3. Zugriffs-Token (Personal Access Token) erstellen — führ mich: oben rechts aufs Profilbild → Preferences/Einstellungen → Access Tokens → "Add new token". Name: "lokales-git". Haken bei read_repository UND write_repository. Ablauf: in 6 Monaten. Token erstellen, sofort kopieren und in Vaultwarden ablegen — er wird gleich gebraucht und danach nie wieder angezeigt. 4. Repos klonen — sag mir, wie ich ein Terminal öffne (Mac/Linux: Terminal-App; Windows: "Git Bash"). Erklär mir jeden Befehl vorher, dann lass mich sie nacheinander ausführen: mkdir -p ~/ingr cd ~/ingr git clone https://git.promptheus.cloud/promptheus/ingr/werkstatt.git git clone https://git.promptheus.cloud/promptheus/ingr/vault-.git Beim Klonen fragt Git nach Benutzername und Passwort. Benutzername = mein GitLab-Benutzername. Passwort = der Token aus Schritt 3 (NICHT mein Login-Passwort). Falls mein persönliches Repo noch nicht existiert, sag mir, ich soll Marlin Bescheid geben, und mach mit der werkstatt allein weiter. 5. In Obsidian öffnen — ich starte Obsidian, wähle "Open folder as vault" / "Ordner als Vault öffnen" und öffne nacheinander ~/ingr/werkstatt und ~/ingr/vault-. Wenn ich Fehler melde (besonders "Authentication failed" oder "repository not found"), frag konkret nach und hilf beim Debuggen. Eskalation: Wenn ich nach 2-3 Versuchen immer noch hänge, verweis mich auf "Wenn du nicht weiterkommst" auf der Anleitungsseite und bereite eine Fehlerbeschreibung vor (welcher Unterpunkt, exakte Fehlermeldung, Ausgabe von "git --version", mein Betriebssystem). Wenn beide Vaults in Obsidian sichtbar sind, sag wörtlich: "Schritt 5 erledigt — geh auf der Anleitungsseite weiter zu Schritt 6 (Claude mit den Vaults verbinden)."

Fertig, wenn: beide Ordner als Vaults in Obsidian sichtbar sind und Claude sagt „Schritt 5 erledigt — geh weiter zu Schritt 6."

Häufige Stolpersteine

„Authentication failed": Beim Passwort den Token eingeben, nicht das Login-Passwort. Token notfalls neu erstellen, Haken bei read_repository + write_repository prüfen.
„repository not found": dein persönliches Repo existiert evtl. noch nicht — bei Marlin melden, solange mit der werkstatt weiterarbeiten.
Windows: nutz „Git Bash" (kommt mit Git mit), nicht die normale Eingabeaufforderung.

06 Claude mit deinen Vaults verbinden

Claude darf deine Notizen lesen und schreiben

Jetzt wird aus dem Sprachmodell ein Werkstatt-Assistent: Claude Desktop bekommt Zugriff auf deine beiden Vault-Ordner. Kopier den Text unten in deinen Claude im Browser — er lotst dich durch die Einstellungen der Desktop-App, und die Testfrage am Ende stellst du dann der Desktop-Claude. Welcher Claude wann gemeint ist, sagt dir der Prompt an jeder Stelle.

Für deinen Claude (Browser)

Setup-Schritt 6 für meine Promptheus-Werkstatt. Du begleitest mich. Ziel: Du (Claude Desktop) bekommst Lese- UND Schreibzugriff auf meine beiden Vault-Ordner: - ~/ingr/werkstatt - ~/ingr/vault- Bitte: 1. Sag mir, ich soll die Claude-Desktop-App öffnen (nicht den Browser-Chat — den Dateizugriff gibt es nur in der Desktop-App). 2. Führ mich präzise zum Filesystem-Connector — er ist erfahrungsgemäß schwer zu finden, also rate NICHT, sondern geh so vor: Beschreib mir den wahrscheinlichsten Weg (Claude-Desktop → Einstellungen/Settings → Reiter "Connectors"; in älteren Versionen heißt er "Extensions" oder steckt unter "Developer"). Dort "Filesystem" suchen und aktivieren. Frag mich danach, welche Menüpunkte ich tatsächlich sehe, und korrigier den Weg anhand meiner Antwort — wir suchen ihn notfalls gemeinsam Klick für Klick, statt dass du Pfade rätst, die es bei meiner Version nicht gibt. 3. Beide Vault-Ordner hinzufügen, jeweils mit Lese- UND Schreibrecht (Read & Write). 4. Claude Desktop einmal komplett beenden und neu starten — sonst greifen die Einstellungen nicht. 5. In der Desktop-App einen neuen Chat öffnen und als Test eingeben: "Lies ~/ingr/werkstatt/README.md und fass mir den Auftrag in drei Sätzen zusammen." 6. Wenn die Desktop-Claude mit dem Inhalt antwortet, ohne nachzufragen: Zugriff funktioniert. Wenn sie sagt "ich kann die Datei nicht lesen": Connector-Einstellungen prüfen, App neu starten, Pfade kontrollieren. Falls ich unter Linux mit der Web-App arbeite (kein Desktop): sag mir, dass der Filesystem-Connector dort fehlt, und schlag den einfachsten verfügbaren Weg vor (z.B. Dateien manuell in den Chat ziehen) — und vermerk, dass ich das Marlin als Feedback geben soll. Wichtig zur Klarheit: Diesen Dialog hier führe ich mit dir im Browser-Claude. Die Testfrage aus Punkt 5 weiter oben in DIESER Aufgabe (nicht „Schritt 5" der Anleitung!) stelle ich dagegen der Desktop-Claude — das ist technisch ein zweiter Claude, der als Einziger Dateizugriff hat. Erklär mir den Unterschied kurz, damit ich nicht durcheinanderkomme, welcher Claude gerade dran ist. Wenn ich hänge, frag konkret nach: welche Claude-Desktop-Version, welches OS, wo genau. Eskalation: nach 2-3 Versuchen verweis mich auf "Wenn du nicht weiterkommst" und bereite eine Fehlerbeschreibung vor (Schritt 6, was versucht, exakte Antwort der Desktop-Claude, Version, OS). Wenn die Desktop-Claude den README-Inhalt korrekt zusammengefasst hat, sag wörtlich: "Schritt 6 erledigt — geh auf der Anleitungsseite weiter zu Schritt 7 (erste Recherche-Notiz)."

Fertig, wenn: deine Desktop-Claude werkstatt/README.md liest und zusammenfasst und sagt „Schritt 6 erledigt — geh weiter zu Schritt 7."

07 Deine erste Recherche-Notiz

Eine Quelle einlesen — so arbeitet das Wiki

Jetzt das Eigentliche. Das gemeinsame werkstatt-Wiki folgt einem einfachen, robusten Prinzip (nach Andrej Karpathy): Rohquellen kommen unverändert in raw/, deine destillierten Erkenntnisse als eigene Notizen in wiki/, ein index.md hält den Überblick, ein log.md die Chronik. Du sourcst und denkst — dein Assistent macht die Buchhaltung (anlegen, verlinken, eintragen).

Wichtig: Die verbindlichen Spielregeln stehen im Repo selbst (werkstatt/CLAUDE.md und werkstatt/SETUP.md). Der Prompt unten lässt deinen Assistenten diese zuerst lesen und sich daran halten — so bleibst du immer auf dem aktuellen Stand, egal wie sich das Wiki weiterentwickelt. Kopier den Text in deine Desktop-Claude (die mit Dateizugriff):

Für deine Desktop-Claude

Setup-Schritt 7 — meine erste echte Recherche-Notiz. Du hast Dateizugriff auf ~/ingr/werkstatt und mein persönliches Vault. Bevor wir loslegen, mach dich mit den Spielregeln des Wikis vertraut: 1. Lies ~/ingr/werkstatt/CLAUDE.md und ~/ingr/werkstatt/SETUP.md komplett. Das ist die verbindliche Arbeitsweise — halt dich daran (Ordnerstruktur raw/wiki/index/log, Update-vor-Create, Quellen-Pflicht, Verlinkung, Log-Eintrag). Sag mir in 3-4 Sätzen, was du daraus über die Arbeitsweise verstanden hast. 2. Lies ~/ingr/werkstatt/index.md, damit du weißt, was es schon gibt, und keine doppelten Notizen anlegst. Dann machen wir gemeinsam eine erste Quelle: 3. Frag mich nach meinem Vornamen (falls du ihn nicht kennst) und nach einer Quelle zu unserem Auftrag (Deutschlands Unabhängigkeit von US-IT-Infrastruktur) — entweder gebe ich dir einen Link/Text, oder du schlägst mir eine gute Einstiegsquelle zum Thema vor. 4. Leg die Rohquelle unverändert in raw/ ab (Dateiname und Format genau wie in CLAUDE.md beschrieben — wenn unklar, frag mich kurz). 5. Schau in index.md und wiki/, ob es schon eine passende Notiz gibt. Wenn ja: ergänze sie (Update vor Create). Wenn nein: leg eine neue atomic note in wiki/ an — ein Gedanke pro Notiz, Titel als klare Aussage, jede Behauptung mit Quellenbezug zu raw/, dicht verlinkt. 6. Trag die neue/aktualisierte Notiz in index.md ein und schreib einen kurzen Eintrag in log.md, genau im Format aus CLAUDE.md. 7. Zeig mir, was du angelegt/geändert hast, und erklär mir kurz, warum du es so strukturiert hast (damit ich die Arbeitsweise lerne). Zum Schluss die Änderungen sichern (Git). WICHTIG: Das gemeinsame werkstatt-Wiki ist geschützt — es wird NICHT direkt auf main gepusht, sondern über einen eigenen Branch + Merge Request (so steht es in CLAUDE.md/SETUP.md). Erklär mir das kurz, dann führ die Befehle aus (du hast Schreibzugriff; falls deine Konfiguration keine Shell-Befehle erlaubt, gib sie mir fürs Terminal): cd ~/ingr/werkstatt git pull git checkout -b beitrag/-erste-quelle git add . git commit -m "Erste Quelle von : " git push -u origin beitrag/-erste-quelle GitLab gibt nach dem Push eine "create merge request"-URL aus. Gib sie mir und sag mir, ich soll sie öffnen und den Merge Request auf main stellen — eine andere Person aus der Gruppe reviewt ihn kurz. (Mein persönliches Vault dagegen darf direkt gepusht werden — nur das gemeinsame werkstatt braucht den MR.) Falls beim Push etwas klemmt, erklär mir die Fehlermeldung in einfachen Worten und hilf mir weiter. 9. Sag mir, ich soll meinen offenen Merge Request unter https://git.promptheus.cloud/promptheus/ingr/werkstatt/-/merge_requests aufrufen und prüfen, dass er da steht. Eskalation: Wenn ich nach 2-3 Versuchen hänge (besonders bei Branch/Push/Merge-Request oder Schreibrechten), verweis mich auf "Wenn du nicht weiterkommst" und bereite eine Fehlerbeschreibung vor. Wenn der Branch gepusht und der Merge Request offen ist, sag wörtlich: "Setup abgeschlossen — du bist startklar in der InGr-Werkstatt. Willkommen."

Fertig, wenn: dein Merge Request in der werkstatt offen steht und Claude sagt „Setup abgeschlossen — du bist startklar." (Der kurze Review durch eine andere Person aus der Gruppe kommt danach — du bist trotzdem startklar.)

Wenn du nicht weiterkommst

Erst lässt du deinen Assistenten zweimal helfen. Kommst du dann immer noch nicht weiter, holst du dir Hilfe — und Marlin oder Mika übernimmt.

Hast du schon einen GitLab-Account (ab Schritt 5)? Dann leg ein Hilfe-Issue im werkstatt-Repo an. Dein Assistent kann dir den Text dafür fertig vorbereiten (welcher Schritt, was versucht, exakte Fehlermeldung, dein Betriebssystem).

Öffne ein neues Hilfe-Issue — die Vorlage „Hilfe" ist dann schon ausgewählt.
Titel: [SEV2] <Vorname> Schritt <X> — <kurzes Stichwort> (Schweregrad im Zweifel höher wählen)
Lücken ausfüllen und speichern — Marlin bekommt eine Mail.

Noch kein GitLab-Account (Schritte 1–4)? Dann antworte einfach auf Marlins Setup-Mail mit deinem Problem, oder schreib an marlin@promptheus.cloud mit Betreff [InGr-Hilfe] <Vorname> Schritt <X>. Beschreib: was du machen wolltest, was passiert ist, die genaue Fehlermeldung, dein Betriebssystem.

08 Deine tägliche Routine

So arbeitest du ab jetzt mit deinem Assistenten

Du musst kein Terminal mehr selbst bedienen — deine Desktop-Claude hat Schreibzugriff auf beide Vaults und kann die Git-Schritte für dich machen. Starte jeden neuen Chat mit Lies CLAUDE.md in ~/ingr/werkstatt und leg los. — dann kennt Claude die Spielregeln. Drei Sätze bringen dich durch fast alles:

„Hol die neuesten Änderungen der Gruppe." — Claude macht git pull in beiden Vaults.
„Hier ist ein Link: <URL>. Leg dazu eine Quelle in raw/ und eine Notiz in wiki/ an, halt dich an CLAUDE.md, und stell dafür einen Merge Request." — Claude liest die Quelle, baut die Notiz, verlinkt, protokolliert und legt für die werkstatt einen Branch + Merge Request an.
„Aus diesen Notizen <Wikilinks> — bau mir einen Synthese-Entwurf." — Claude zieht eine These zusammen, du schärfst sie.

Zwei verschiedene Spielregeln — Claude kennt sie aus CLAUDE.md, du solltest sie auch wissen:

Dein persönliches Vault (vault-<vorname>): direkt pushen ist ok — git pull, arbeiten, git add . && git commit -m "..." && git push.
Das gemeinsame werkstatt: ist geschützt — Änderungen laufen immer über einen eigenen Branch + Merge Request (kurzer Review durch eine andere Person aus der Gruppe), nie direkt auf main.

09 Hintergrund & Begriffe

Promptheus — der Hintergrund zum Auftrag

Promptheus arbeitet mit Pilotkunden wie AquaVentus (Wasserstoff-Förderverein) und baut deren Wissens-Werkstätten. Der Scope wächst vom „Webseiten-Bot" zum „Eingangstor ins Unternehmenswissen".

Die politische Lage hinter dem Promptheus-Auftrag: ~80 % der deutschen Unternehmen sitzen auf US-Stacks (Microsoft, Google). Standards sind offen — trotzdem wirken Lock-ins (Spam-Filter, Browser-Defaults, US Cloud Act). Frankreich verbietet seinen Behörden teils Windows; drohende US-Importzölle würden Deutschland zusätzlich verteuern. Genau dort sucht Promptheus Hebel — und genau dort setzt deine Arbeit an.

Begriffe, die in dieser Anleitung vorkommen

Git: Versionskontrolle: jede Änderung an deinen Dateien wird festgehalten, nichts geht verloren, du siehst wer was geändert hat, und Konflikte lassen sich auflösen.
GitLab: Der Server, auf dem deine Vaults liegen (git.promptheus.cloud) — selbstgehostet von Promptheus, auf eigener Hardware in Deutschland.
Repo (Repository): Ein von Git verwalteter Ordner — z. B. werkstatt oder vault-<dein-vorname>.
Klonen: Eine Kopie eines Repos vom Server auf deinen Rechner holen (git clone).
Personal Access Token (PAT): Ein langes Zufalls-Passwort, mit dem sich dein Rechner bei GitLab ausweist — statt deines Login-Passworts.
Commit / Push / Pull: Commit = eine Änderung festschreiben. Push = sie zum Server schicken. Pull = die Änderungen der anderen holen.
Branch: Eine parallele Arbeitslinie. Für das gemeinsame werkstatt arbeitest du auf einem eigenen Branch, nicht direkt auf main.
Merge Request (MR): Der Antrag, deinen Branch ins main aufzunehmen. Eine andere Person reviewt ihn kurz — so bleibt das gemeinsame Wiki sauber. Claude legt ihn für dich an.
Obsidian: Der Editor, der einen Ordner mit Markdown-Notizen als „Vault" öffnet.
Vault: Ein Ordner voller Notizen. Du hast zwei: das gemeinsame werkstatt und dein persönliches.
Wikilink: Eine Verknüpfung zwischen Notizen, geschrieben in doppelten eckigen Klammern: [[Andere Notiz]].
Claude Desktop: Die App-Variante von Claude. Nur sie kann (über den Filesystem-Connector) deine Dateien direkt lesen und schreiben.
Filesystem-Connector: Die Einstellung in Claude Desktop, die ihm Zugriff auf bestimmte Ordner gibt.
Atomic Note: Eine Notiz, die genau einen Gedanken vollständig festhält, mit aussagekräftigem Titel und Quellenbezug — die Grundeinheit eures Wikis.
raw / wiki / index / log: Die vier Bausteine des werkstatt-Wikis: raw/ = unveränderte Quellen, wiki/ = die Notizen, index.md = Überblick, log.md = Chronik.
Issue: Ein Eintrag im GitLab-Repo, hier vor allem für Hilfe-Anfragen beim Setup.
Vaultwarden: Dein selbstgehosteter Passwort-Tresor auf vault.veltly.de.