| # Hermes — Harness Tutorial |
|
|
| > Pipeline-Rolle: **Output bauen** (Wave 2, Implementierung) |
| > Hermes ist das guenstigste und anpassungsfahigste Arbeits-Harness. Hier entsteht der meiste Code. |
|
|
| --- |
|
|
| ## 1. Quick Start |
|
|
| ```bash |
| cd ~/Projekte/MeinProjekt # KRITISCH: IMMER im Projektordner starten |
| # NICHT in ~/.hermes/ oder irgendwo anders |
| |
| hermes chat # interaktive Session |
| # oder mit spezifischem Modell: |
| hermes chat --model minimax/minimax-text-01 |
| ``` |
|
|
| Erste 2 Minuten: |
|
|
| ``` |
| > [Tasksheet aus harness-tasksheets/ einfuegen] |
| > Bestatige: In welchem Verzeichnis arbeitest du gerade? |
| > Welche Dateien wirst du anlegen/aendern? |
| ``` |
|
|
| Den zweiten und dritten Schritt IMMER machen — Hermes driftet sonst |
| in `~/.hermes/` oder baut an der falschen Stelle. |
|
|
| --- |
|
|
| ## 2. Typischer Workflow |
|
|
| **Hermes ist fuer iteratives Arbeiten gemacht — nicht fuer Einmal-Outputs.** |
|
|
| 1. **Tasksheet einfuegen** — Scope, Output-Pfad, Constraints klar definieren. |
| 2. **Verzeichnis-Check** — Bestaetigen lassen wo Hermes gerade ist. |
| 3. **Ersten Output** — Hermes baut. Warten, bis Output erscheint (kann kurz still sein). |
| 4. **Feedback geben** — Konkret und priazise. Hermes nimmt Korrekturen gut an. |
| 5. **Iterieren** — 2-4 Iterationen bis Ergebnis passt. |
| 6. **Summary** — "Fasse zusammen was du geaendert hast" — fuer Handoff an Codex. |
|
|
| Beispiel-Flow: |
|
|
| ``` |
| > [Tasksheet einfuegen] |
| > Implementiere src/api.py mit dem /health Endpunkt. |
| [Output abwarten] |
| > Gut. Jetzt fuege /api/status hinzu, der {"agents": [], "status": "ok"} zurueckgibt. |
| [Output abwarten] |
| > Die agents-Liste soll aus config.yaml geladen werden. Hier ist der Pfad: config/agents.yaml |
| [Output abwarten] |
| > Fasse zusammen: Welche Dateien hast du veraendert und was hast du gemacht? |
| ``` |
|
|
| --- |
|
|
| ## 3. Starken nutzen |
|
|
| **Beste Feedback-Annahme:** Hermes akzeptiert Korrekturen ohne zu diskutieren. |
| Fehler direkt benennen — Hermes baut sofort weiter: |
|
|
| ``` |
| > Das ist falsch. src/api.py Zeile 23: status_code muss 200 sein, nicht 404. |
| Korrigiere nur diese Zeile. |
| ``` |
|
|
| **Iteratives Arbeiten:** Ideal fuer Aufgaben die mehrere Runden brauchen. |
| Feature by Feature vorgehen statt alles auf einmal beauftragen. |
|
|
| ``` |
| # Statt: |
| > Implementiere das komplette Dashboard mit allen Endpunkten |
| |
| # Besser: |
| > Implementiere nur /health |
| [fertig] |
| > Implementiere /api/agents |
| [fertig] |
| > Implementiere /api/status |
| ``` |
|
|
| **Guenstig fuer taeagliche Arbeit:** Mit MiniMax ~150x guenstiger als Opus. |
| Hermes fuer alle Routineaufgaben nutzen, Claude Code nur fuer Planung. |
|
|
| **Parallele unabhaengige Tasks mit --worktree:** |
|
|
| ```bash |
| # Zwei unabhaengige Features parallel: |
| hermes chat --worktree feature-health-endpoint |
| hermes chat --worktree feature-agent-list |
| ``` |
|
|
| --- |
|
|
| ## 4. Schwachen kompensieren |
|
|
| **Scope-Drift: Hermes groesstes Problem.** |
| Ohne expliziten Output-Pfad baut Hermes in `~/.hermes/` statt im Projektordner. |
|
|
| IMMER im Tasksheet angeben: |
|
|
| ``` |
| Output-Pfad: /home/smlflg/Projekte/MeinProjekt/src/ |
| Verzeichnis: /home/smlflg/Projekte/MeinProjekt/ |
| NICHT: ~/.hermes/ oder relative Pfade |
| ``` |
|
|
| **Langsamer Start:** Hermes ist kurz still bevor Output kommt. |
| Das ist normal — nicht abbrechen und neu starten. |
| Nach ~10-15 Sekunden Stille: einmal Enter druecken. |
|
|
| **Output-Qualitaet mittel:** Hermes schreibt funktionalen aber |
| nicht eleganten Code. Fuer finales Polishing → Codex. |
|
|
| ``` |
| # Hermes-Output ist funktional: |
| def get_agents(): |
| with open("config.yaml") as f: |
| return yaml.safe_load(f)["agents"] |
| |
| # Codex macht daraus sauberen Code mit Error-Handling, Types, Docstrings |
| ``` |
|
|
| **Was passiert dann plotzlich Output:** Hermes denkt intern — der Output |
| kommt manchmal in einem Block. Das ist kein Fehler. |
|
|
| --- |
|
|
| ## 5. Handoff-Muster |
|
|
| **Von OpenCode zu Hermes:** |
|
|
| ``` |
| > Lies src/ — OpenCode hat das Geruest angelegt. |
| Deine Aufgabe: Implementiere die Logik in src/api.py. |
| Scope: Nur src/api.py und src/services/agent_service.py. |
| Keine neuen Dateien anlegen. |
| ``` |
|
|
| **Von Hermes zu Codex (Polishing):** |
|
|
| ```bash |
| # Hermes gibt Summary: |
| > Fasse zusammen: Welche Dateien hast du geaendert? Was hast du implementiert? |
| Was fehlt noch? Was ist TODO? |
| |
| # Summary in Tasksheet schreiben: |
| cat > ~/Projekte/harness-tasksheets/task-codex-polish.md << 'EOF' |
| Hermes hat implementiert: |
| - src/api.py: /health, /api/agents, /api/status |
| - src/services/agent_service.py: AgentService mit load_agents() |
| |
| Aufgabe fuer Codex: |
| - Code-Review und Polishing |
| - Type Hints hinzufuegen |
| - Error Handling verbessern |
| - README.md aktualisieren |
| EOF |
| ``` |
|
|
| **--worktree fuer parallele Tasks:** |
|
|
| ```bash |
| # Unabhaengige Features parallel: |
| hermes chat --worktree frontend # baut src/templates/ |
| hermes chat --worktree backend # baut src/api.py |
| # Am Ende: git merge |
| ``` |
|
|
| --- |
|
|
| ## 6. Kosten-Tipps |
|
|
| **Guenstigstes Harness fuer iterative Arbeit.** MiniMax nutzen: |
|
|
| ```bash |
| hermes chat --model minimax/minimax-text-01 |
| ``` |
|
|
| **Tasksheet verhindert Scope-Drift = verhindert Token-Verschwendung:** |
| Drift bedeutet Hermes baut das Falsche → Session wegwerfen → neu starten. |
| Ein gutes Tasksheet kostet 2 Minuten aber spart eine komplette Re-Session. |
|
|
| **Feature by Feature ist guenstiger als Big-Bang:** |
|
|
| ``` |
| # Teuer (wenn ein Feature falsch → alles nochmal): |
| > Implementiere alle 8 Endpunkte |
| |
| # Guenstiger (jeder Schritt kann frueh korrigiert werden): |
| > Implementiere /health |
| > [Feedback] Gut. Jetzt /api/agents. |
| ``` |
|
|
| **Iteration ist guenstig:** Eine Korrektur-Runde kostet <10% einer |
| neuen Session. Hermes iterieren lassen statt neu starten. |
|
|
| **Verzeichnis-Check ist kostenlos:** 2 Sekunden fragen wo Hermes arbeitet |
| verhindert eine weggeworfene Session wegen falschem Pfad. |
|
|
| **Faustregeln:** |
| - Einfache Funktion implementieren: ~$0.01-0.03 |
| - Vollstaendiger Endpunkt mit Tests: ~$0.05-0.10 |
| - Feature-Iteration (3-4 Runden): ~$0.10-0.20 |
| - Re-Session wegen Scope-Drift: gleiche Kosten nochmal |
|
|
