Bewährte Methoden — 10 Tipps

Stell dir Hermes Agent wie einen Koch in einer geschäftigen Küche vor. Du würdest ja auch nicht jedem Koch erlauben, auf demselben Schneidebrett Gemüse zu hacken und gleichzeitig Desserts anzurichten – jeder bekommt seine eigene Station. Die gleiche Logik gilt für deine Codebasis.

---

1. Ein Worktree pro Experiment

Stell dir vor, du streichst ein Haus. Du würdest nicht gleichzeitig das Wohnzimmer und das Badezimmer mit demselben Pinsel streichen – du würdest beides vermasseln. Mit Git-Worktrees gibst du jeder Hermes-Aufgabe ihren eigenen „Raum“ zum Arbeiten.

Lass Hermes nicht direkt in deinem Hauptprojektordner Dateien bearbeiten, sondern erstelle für jedes Experiment einen separaten Arbeitsbereich. So bleibt dein Hauptcode sicher und deine Änderungen aufgeräumt.

2. Branches nach dem Experiment benennen

Gib deinen Branches klare, aussagekräftige Namen, damit du (und dein zukünftiges Ich) weißt, wofür jeder einzelne gedacht ist:

git checkout -b feature/hermes-checkpoints-docs

Nicht branch-1 oder test-fix. Sei spezifisch – du wirst es dir später danken.

3. Häufig committen

Stell dir Commits wie das Speichern deines Spielstands in einem Videospiel vor. Du willst nicht drei Stunden spielen und dann alles verlieren, weil du nicht gespeichert hast.

Commite bei wichtigen Meilensteinen:

git add .
git commit -m "Add checkpoint documentation"

Für kleinere, toolgesteuerte Änderungen zwischendurch nutze Hermes’ Checkpoints und /rollback als Sicherheitsnetz.

4. Nicht vom Bare-Repo-Root aus arbeiten

Wenn du Worktrees verwendest, starte Hermes nicht aus dem ursprünglichen Repo-Ordner. Wechsle stattdessen mit cd in das Worktree-Verzeichnis. Das gibt jedem Agenten einen klaren Arbeitsbereich und verhindert versehentliche Querkontamination.

5. hermes -w für automatische Worktrees nutzen

Keine Lust, Worktrees manuell einzurichten? Hermes hat eine eingebaute Abkürzung:

cd /path/to/your/repo
hermes -w

Das erstellt automatisch einen Wegwerf-Worktree mit eigenem Branch. Du kannst es sogar mit einer einzelnen Anfrage kombinieren:

hermes -w -z "Fix issue #123"

6. Parallele Agenten sicher ausführen

Willst du mehrere Hermes-Agenten gleichzeitig arbeiten lassen? Öffne einfach mehrere Terminals und führe in jedem hermes -w aus. Jede Sitzung bekommt automatisch ihren eigenen isolierten Worktree und Branch. Schluss damit, dass sich Agenten gegenseitig auf die Füße treten.

7. Checkpoints + /rollback verwenden

Fehler passieren. Das ist okay. Hermes ermöglicht es dir, während einer Sitzung Checkpoints zu setzen und bei Problemen zu diesen zurückzukehren. Es ist wie ein „Rückgängig“-Knopf für die Aktionen deines Agenten.

8. Worktrees, Branches und Checkpoints kombinieren

Hier ist die Erfolgsformel:

• Worktrees = saubere Checkouts für jede Sitzung
• Branches = übergeordnete Historie der Experimente
• Checkpoints + /rollback = schnelle Wiederherstellung nach Fehlern

Zusammen bieten sie dir schnelle Iteration, einfache Wiederherstellung und saubere Pull Requests.

9. UI-Entwicklung clever angehen

Wenn du an der TUI oder der Desktop-App über mehrere Worktrees hinweg arbeitest, brauchst du für jeden node_modules. Das ist eine Menge doppelter Dateien. Schau dir die htui / hgui-Helfer an, die sich eine Installation per Symlink teilen – das spart Speicherplatz und Einrichtungszeit.

10. Deinen Haupt-Branch sauber halten

Der Sinn dieser Praktiken ist es, deinen Haupt-Branch stabil und produktionsbereit zu halten. Merge Worktree-Branches nur, wenn sie getestet und vollständig sind.

---

Zusammenfassung

Stell dir Worktrees wie separate Schreibtische in einem Büro vor. Jeder Hermes-Agent bekommt seinen eigenen Schreibtisch mit seinen eigenen Werkzeugen, sodass niemand die Arbeit eines anderen vermasselt. Branches sind dein Ablagesystem, und Checkpoints sind deine Haftnotizen für „Ich war hier“.

Praktischer Tipp: Starte bei deiner nächsten Aufgabe einfach mit hermes -w. Das ist der einfachste Weg, um ohne manuelle Einrichtung Isolation zu bekommen. Wenn du dich wohlfühlst, füge Checkpoints und Rollback zu deinem Workflow hinzu. Du wirst dich fragen, wie du je ohne sie arbeiten konntest.

---